CSSbackground-position-x Property
Example
How to position a background-image on x-axis:
background-image: url('w3css.gif');
background-repeat: no-repeat;
background-position-x: center;
}
More "Try it Yourself" examples below.
Definition and Usage
Thebackground-position-x property sets the position of a background image on the x-axis.
Tip:By default, abackground-image is placed at the top-left corner of an element, and repeated both vertically and horizontally.
| Default value: | 0% |
|---|---|
| Inherited: | no |
| Animatable: | yes.Read aboutanimatableTry it |
| Version: | CSS3 |
| JavaScript syntax: | object.style.backgroundPositionX="center"Try it |
Browser Support
The numbers in the table specify the first browser version that fully supports the property.
| Property | |||||
|---|---|---|---|---|---|
| background-position-x | 1.0 | 12.0 | 49.0 | 1.0 | 15.0 |
| background-position-x (with two value syntax) | Not supported | Not supported | 49.0 | 15.4 | Not supported |
CSS Syntax
Property Values
| Value | Description | Demo |
|---|---|---|
| left | Positions background left side on x-axis. | Demo ❯ |
| right | Positions background right side on x-axis. | Demo ❯ |
| center | Positions background center on x-axis. | Demo ❯ |
| x% | Left side is 0% on x-axis, and right side is 100%. Percentage value refers to width of background positioning area minus width of background image. | Demo ❯ |
| xpos | Horizontal distance from left side. Units can be pixels (0px) or any otherCSS units. | Demo ❯ |
| xpos offset | Two value syntax, only supported in Firefox and Safari. -xpos is set either to "left" or "right". -offset is horizontal distance from background image and "left" or "right" side set withxpos. Units can be pixels or any otherCSS units. | |
| initial | Sets this property to its default value.Read aboutinitial | |
| inherit | Inherits this property from its parent element.Read aboutinherit |
More Examples
Example
How to position a background-image to the right:
background-image: url('w3css.gif');
background-repeat: no-repeat;
background-position-x: right;
}
Example
How to position a background-image using percent:
background-image: url('w3css.gif');
background-repeat: no-repeat;
background-position-x: 50%;
}
Example
How to position a background-image using pixels:
background-image: url('w3css.gif');
background-repeat: no-repeat;
background-position-x: 150px;
}
Example
Use different background properties to create a bacground image that covers its container:
background-image: url("photographer.jpg"); /* The image used */
background-color: #cccccc; /* Used if the image is unavailable */
height: 300px; /* You must set a specified height */
background-position-x: center; /* Center the image */
background-repeat: no-repeat; /* Do not repeat the image */
background-size: cover; /* Resize the background image to cover the entire container */
}
Related Pages
CSS tutorial:CSS Background
CSS reference:background-image property
CSS reference:background-position property
CSS reference:background-position-y property
HTML DOM reference:backgroundPosition property
