Style backgroundImage Property
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.
Description
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.
See Also:
HTML Styles: The background Property
CSS Tutorial: CSS Backgrounds
CSS3 Tutorial: CSS3 Backgrounds
CSS Reference: The background-image Property
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 |
Browser Support
backgroundImage 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
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:
let img = document.getElementById("myDiv").style.backgroundImage;
Try it Yourself »
Example
Return the background image of a document:
let img = document.body.style.backgroundImage;
Try it Yourself »
