CSS background-position-y Property
Example
How to position a background-image on y-axis:
div
{
background-image: url('w3css.gif');
background-repeat: no-repeat;
background-position-y: center;
}
Try it Yourself »
More "Try it Yourself" examples below.
Definition and Usage
The background-position-y
property sets the position of a background image on the y-axis.
Tip: By default, a background-image is placed at the top-left corner of an element, and repeated both vertically and horizontally.
Show demo ❯Default value: | 0% |
---|---|
Inherited: | no |
Animatable: | yes. Read about animatable Try it |
Version: | CSS3 |
JavaScript syntax: | object.style.backgroundPositionY="center" Try it |
Browser Support
The numbers in the table specify the first browser version that fully supports the property.
Property | |||||
---|---|---|---|---|---|
background-position-y | 1.0 | 12.0 | 49.0 | 1.0 | 15.0 |
background-position-y (with two value syntax) |
Not supported | Not supported | 49.0 | 15.4 | Not supported |
CSS Syntax
background-position-y: value;
Property Values
Value | Description | Demo |
---|---|---|
top | Positions background top on y-axis. | Demo ❯ |
bottom | Positions background bottom on y-axis. | Demo ❯ |
center | Positions background center on y-axis. | Demo ❯ |
y% | Top side is 0% on y-axis, and bottom side is 100%. Percentage value refers to height of background positioning area minus height of background image. | Demo ❯ |
ypos | Vertical distance from top side. Units can be pixels (0px) or any other CSS units. | Demo ❯ |
ypos offset | Two value syntax, only supported in Firefox and Safari. - ypos is set either to "top" or "bottom". - offset is vertical distance from background image and "top" or "bottom" side set with ypos. Units can be pixels or any other CSS units. |
|
initial | Sets this property to its default value. Read about initial | |
inherit | Inherits this property from its parent element. Read about inherit |
More Examples
Example
How to position a background-image to the top:
body
{
background-image: url('w3css.gif');
background-repeat: no-repeat;
background-attachment: fixed;
background-position-y: bottom;
}
Try it Yourself »
Example
How to position a background-image on y-axis using percent:
body
{
background-image: url('w3css.gif');
background-repeat: no-repeat;
background-attachment: fixed;
background-position-y: 50%;
}
Try it Yourself »
Example
How to position a background-image on y-axis using pixels:
body
{
background-image: url('w3css.gif');
background-repeat: no-repeat;
background-attachment: fixed;
background-position-y: 80px;
}
Try it Yourself »
Related Pages
CSS tutorial: CSS Background
CSS reference: background-image property
CSS reference: background-position property
CSS reference: background-position-x property
HTML DOM reference: backgroundPosition property