Style backgroundRepeat Property

❮ Previous ❮ Style Object Reference Next ❯

Example

Set a background-image to no-repeat:

document.body.style.backgroundRepeat = "repeat-y";

Try it Yourself »

More "Try it Yourself" examples below.

Description

The backgroundRepeat property sets or returns how to repeat (tile) a background-image.

Syntax

Return the backgroundRepeat property:

object.style.backgroundRepeat

Set the backgroundRepeat property:

Property Values

Value	Description
repeat	The background image is repeated both vertically and horizontally. This is default
repeat-x	The background image is only repeated horizontally
repeat-y	The background image is only repeated vertically
no-repeat	The background-image is not repeated
initial	Sets this property to its default value. Read about initial
inherit	Inherits this property from its parent element. Read about inherit

Technical Details

Default Value:	repeat
Return Value:	A String, representing how a background-image is repeated
CSS Version	CSS1

Browser Support

backgroundRepeat is a CSS1 (1996) feature.

It is fully supported in all browsers:


Chrome	Edge	Firefox	Safari	Opera	IE
Yes	Yes	Yes	Yes	Yes	Yes

More Examples

Example

Change the backgroundRepeat property of a specified DIV element:

document.getElementById("myDIV").style.backgroundRepeat = "repeat-x";

Try it Yourself »

Example

Set a background-image to repeat horizontally or vertically:

function repeatVer() {
document.body.style.backgroundRepeat = "repeat-y";
}

function repeatHor() {
document.body.style.backgroundRepeat = "repeat-x";
}

Try it Yourself »