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 »