Style backgroundPosition Property
Example
Change the position of a background-image:
document.body.style.backgroundPosition = "top right";
Try it Yourself »
More "Try it Yourself" examples below.
Description
The backgroundPosition property sets or returns the position of a background-image within an element.
See Also:
HTML Styles: The background Property
CSS Tutorial: CSS Backgrounds
CSS3 Tutorial: CSS3 Backgrounds
CSS Reference: The background-image Property
CSS Reference: Thr background-position Property
Syntax
Return the backgroundPosition property:
object.style.backgroundPosition
Set the backgroundPosition property:
object.style.backgroundPosition = value
Property Values
Value | Description |
---|---|
top left top center top right center left center center center right bottom left bottom center bottom right |
If you only specify one keyword, the other value will be "center". |
x% y% | The x value indicates the horizontal position and the y value indicates the vertical position. The top left corner is 0% 0%. The right bottom corner is 100% 100%. If you only specify one value, the other value will be 50%. |
xpos ypos | The x value indicates the horizontal position and the y value indicates the vertical position. The top left corner is 0 0. Units can be pixels (0px 0px) or any other CSS units. If you only specify one value, the other value will be 50%. You can mix % and units |
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: | 0% 0% |
---|---|
Return Value: | A String, representing the position of a background-image |
CSS Version | CSS1 |
Browser Support
backgroundPosition
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
Change the position of the background-image in a <div> element to center bottom:
document.getElementById("myDiv").style.backgroundPosition = "center bottom";
Try it Yourself »
Example
Change the position of the background-image in a <div> element to 200px horizontal and 40px vertical:
document.getElementById("myDiv").style.backgroundPosition = "200px 40px";
Try it Yourself »
Example
Return the position of the background-image in a <div> element:
document.getElementById("myDiv").style.backgroundPosition;
Try it Yourself »