- Tags: Background, Image
- 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;
}
Values
| 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>
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.
Why 1SMARTchicken?
See More →
Thanks for your support!
CSS Books
All are affiliate links. Thank you for your support!
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
Feedback
If you see an error on the page or the code itself is incorrect or incomplete, or just plain wrong, please let us know. We’re always learning. NOTE: we do not sell your information and will not send you spam emails.
