Latest web development tutorials
 

Style backgroundRepeat Property

< 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