CSS - background-repeat Property

September 26, 2024

Categories: CSS Properties, CSS Reference, Reference

Quick Reference

The background-repeat property sets how a background image will be repeated if at all. By default, the background image is repeated both vertically and horizontally to fill the element.

div {
    background-image: url("my-background.jpg");
    background-positon: right center;
    background-repeat: no-repeat;
    background-color: red;
}

Default

Default value	repeat
Inherited values	no
Can it be animated?	no

These are the allowed values.

Value	Description
repeat	The background image is repeated both vertically and horizontally, clipping last image if it does not fit (default)
repeat-x	The background image is repeated only horizontally
repeat-y	The background image is repeated only vertically
no-repeat	The background-image is not repeated; it will only be shown once
space	The background-image is repeated as many times as possible without clipping; the first and last image is pinned to either side of the element, and whitespace is distributed evenly between the images
round	The background-image is repeated and squished or stretched to fill the space with no gaps
initial	Sets this property to its default value
inherit	Inherits this property from its parent element

Using JavaScript

The HTML element can also be styled using JavaScript and the element’s id.

document.getElementById('my_div').style.backgroundRepeat = 'no-repeat';

<button onclick='my_function()'>Click Here</button>

<script>
function my_function() {
    document.getElementById('my_div').style.backgroundRepeat = 'no-repeat';
}
</script>

CSS Notes:

The “inherit”, “initial” and “unset” keywords can be used with any CSS property to set its value
In CSS there are many ways to express a color value in a property

If you like our content, and find it helpful, please consider making a small donation. Thank you!

We’d like to acknowledge that we learned a great deal of our coding from W3Schools and TutorialsPoint, borrowing heavily from their teaching process and excellent code examples. We highly recommend both sites to deepen your experience, and further your coding journey. We’re just hitting the basics here at 1SMARTchicken.