Example
Set a background image for a document:
document.body.style.backgroundImage = "url('img_tree.png')";Try it Yourself »
More "Try it Yourself" examples below.
Definition and Usage
The backgroundImage property sets or returns the background image of an element.
Tip: In addition to the background-image you should also specify a background-color. The background-color will be used if the image is unavailable.
Browser Support
The numbers in the table specify the first browser version that fully supports the property.
| Property | |||||
|---|---|---|---|---|---|
| backgroundImage | 1.0 | 4.0 | 1.0 | 1.0 | 3.5 |
Syntax
Return the backgroundImage property:
object.style.backgroundImage
Set the backgroundImage property:
object.style.backgroundImage="url('URL')|none|initial|inherit"
Property Values
| Value | Description |
|---|---|
| url('URL') | The location of the image file |
| none | No background image. This is default |
| 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: | none |
|---|---|
| Return Value: | A String, representing the background image |
| CSS Version | CSS1 |
More Examples
Example
Set a background image of a specific <div> element:
document.getElementById("myDiv").style.backgroundImage = "url('img_tree.png')";
Try it Yourself »
Example
Return the background image of a specific <div> element:
alert(document.getElementById("myDiv").style.backgroundImage);
Try it Yourself »
Example
Return the background image of a document:
alert(document.body.style.backgroundImage);
Try it Yourself »
Related Pages
CSS tutorial: CSS Background
CSS3 tutorial: CSS3 Backgrounds
CSS reference: background-image property
HTML DOM reference: background property
< Style Object