Sets or retrieves how the backgroundImage property of the object is tiled.
Syntax
| HTML |
{ background-repeat : sRepeat }
|
|---|
| Scripting | [ sRepeat = ] object.style.backgroundRepeat |
|---|
Possible Values
| sRepeat | String that
specifies or receives one of the following values.| repeat | Default. Image is repeated horizontally and vertically. | no-repeat | Image is not repeated. | repeat-x | Image is repeated horizontally. | repeat-y | Image is repeated vertically. |
|
The property is read/write
for all objects except the following, for which it is read-only:
currentStyle.
The property has a default value of
repeat. The Cascading Style Sheets (CSS) attribute is
not inherited.
Expressions can be used in place of the preceding value(s), as of Microsoft® Internet Explorer 5. For more information, see About Dynamic Properties.
Remarks
The repeat-x and repeat-y values make the image repeat horizontally and vertically, respectively, creating a single band of images from one side to the other.
This property can be set with other background properties by using the background composite property.
Examples
The following examples use the background-repeat attribute and the backgroundRepeat property to specify whether the background image is tiled.
This example uses a call to an embedded (global) style sheet to tile the image.
<STYLE>
.style1 { background-image:url(sphere.jpg);
background-repeat:repeat }
.style2 { background-image:url(sphere.jpeg);
background-repeat:no-repeat }
</STYLE>
</HEAD>
<BODY>
<SPAN
>
. . . </SPAN>
This feature requires Microsoft® Internet Explorer 4.0 or later. Click the following icon to install the latest version. Then reload this page to view the sample.
This example shows how to use inline scripting to tile the image.
This feature requires Microsoft® Internet Explorer 4.0 or later. Click the following icon to install the latest version. Then reload this page to view the sample.
Standards Information
This property is defined in
Cascading Style Sheets (CSS), Level 1 (CSS1) 
.
Applies To
|
A,
ADDRESS,
B,
BIG,
BLOCKQUOTE,
BODY,
BUTTON,
CAPTION,
CENTER,
CITE,
CODE,
COL,
COLGROUP,
currentStyle,
CUSTOM,
DD,
defaults,
DFN,
DIR,
DIV,
DL,
DT,
EM,
FIELDSET,
FORM,
hn,
HTML,
I,
IMG,
INPUT type=button,
INPUT type=checkbox,
INPUT type=file,
INPUT type=image,
INPUT type=password,
INPUT type=radio,
INPUT type=reset,
INPUT type=submit,
INPUT type=text,
ISINDEX,
KBD,
LABEL,
LEGEND,
LI,
LISTING,
MARQUEE,
MENU,
NOBR,
OL,
P,
PLAINTEXT,
PRE,
runtimeStyle,
S,
SAMP,
SMALL,
SPAN,
STRIKE,
STRONG,
style,
SUB,
SUP,
TABLE,
TBODY,
TD,
TEXTAREA,
TFOOT,
TH,
THEAD,
TR,
TT,
U,
UL,
VAR,
XMP |