THE WORLD'S LARGEST WEB DEVELOPER SITE

Style backgroundRepeat Property

Style Object Reference Style Object

Example

Set a background-image to no-repeat:

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

Try it yourself »

More "Try it Yourself" examples below.


Definition and Usage

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


Browser Support

The numbers in the table specify the first browser version that fully supports the property.

Property
backgroundRepeat 1.0 4.0 1.0 1.0 3.5

Syntax

Return the backgroundRepeat property:

object.style.backgroundRepeat

Set the backgroundRepeat property:

object.style.backgroundRepeat="repeat|repeat-x|repeat-y|no-repeat|initial|inherit"

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

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 »

Example

Return the background-repeat value of a document:

alert(document.body.style.backgroundRepeat);

Try it yourself »

Related Pages

CSS tutorial: CSS Background

CSS reference: background-position property

CSS reference: background-repeat property

HTML DOM reference: background property


Style Object Reference Style Object

COLOR PICKER

colorpicker

SHARE THIS PAGE






Search w3schools.com:

Translate w3schools.com: