CSS background-position-y Property
- Previous page background-position-x
- Next Page background-repeat
Definition and Usage
background-position-y
The property is used to set the position of the background image on the y-axis.
Tip:By default, the background image is placed at the top left corner of the element and repeated in both vertical and horizontal directions.
Instance
Example 1
How to position the background image on the y-axis:
div { background-image: url('w3css.gif'); background-repeat: no-repeat; background-position-y: center; }
Example 2
How to position the background image at the top:
body { background-image: url('w3css.gif'); background-repeat: no-repeat; background-attachment: fixed; background-position-y: bottom; }
Example 3
How to position the background image vertically using percentages:
body { background-image: url('w3css.gif'); background-repeat: no-repeat; background-attachment: fixed; background-position-y: 50%; }
Example 4
How to position the background image vertically using pixels:
body { background-image: url('w3css.gif'); background-repeat: no-repeat; background-attachment: fixed; background-position-y: 80px; }
CSS Syntax
background-position-y: value;
Attribute Value
Value | Description |
---|---|
top | Aligns the background position at the top of the y-axis. |
bottom | Aligns the background position at the bottom of the y-axis. |
center | Aligns the background position at the center of the y-axis. |
y% |
The top of the y-axis is 0%, and the bottom is 100%. Percentage values refer to the height of the background positioning area minus the height of the background image. |
ypos |
The vertical distance from the top. The unit can be pixels (such as 0px) or other CSS Units. |
ypos offset |
Dual-value syntax, supported only in Firefox and Safari.
The unit can be pixels or other CSS Units. |
initial | Sets this property to its default value. See initial. |
inherit | Inherits this property from its parent element. See inherit. |
Technical Details
Default Value: | 0% |
---|---|
Inheritance: | No |
Animation Creation: | Supported. See:Animation-related attributes. |
Version: | CSS3 |
JavaScript Syntax: | object.style.backgroundPositionY="center" |
Browser Support
The numbers in the table represent the browser version that first fully supports this attribute.
Chrome | Edge | Firefox | Safari | Opera | |
---|---|---|---|---|---|
Single-value syntax | 1.0 | 12.0 | 49.0 | 1.0 | 15.0 |
Dual-value syntax | Not supported | Not supported | 49.0 | 15.4 | Not supported |
Related Pages
Tutorial:CSS Background
CSS Reference:background-image Attribute
CSS Reference:background-position Attribute
CSS Reference:background-position-x Attribute
HTML DOM Reference:backgroundPosition Attribute
- Previous page background-position-x
- Next Page background-repeat