background-position-x
Baseline
Widely available
*
This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2016.
* Some parts of this feature may have varying levels of support.
Die background-position-x CSS Eigenschaft setzt die anfängliche horizontale Position für jedes Hintergrundbild. Die Position ist relativ zur Positionsebene festgelegt durch background-origin.
Probieren Sie es aus
background-position-x: left;
background-position-x: center;
background-position-x: 25%;
background-position-x: 2rem;
background-position-x: right 32px;
<section class="display-block" id="default-example">
<div class="transition-all" id="example-element"></div>
</section>
#example-element {
background-color: navajowhite;
background-image: url("/shared-assets/images/examples/star.png");
background-repeat: no-repeat;
height: 100%;
}
Der Wert dieser Eigenschaft wird durch jede Deklaration der Kurzschreibweiseigenschaften background oder background-position überschrieben, die nachträglich auf das Element angewendet werden.
Syntax
/* Keyword values */
background-position-x: left;
background-position-x: center;
background-position-x: right;
/* <percentage> values */
background-position-x: 25%;
/* <length> values */
background-position-x: 0px;
background-position-x: 1cm;
background-position-x: 8em;
/* Side-relative values */
background-position-x: right 3px;
background-position-x: left 25%;
/* Multiple values */
background-position-x: 0px, center;
/* Global values */
background-position-x: inherit;
background-position-x: initial;
background-position-x: revert;
background-position-x: revert-layer;
background-position-x: unset;
Die background-position-x Eigenschaft wird als ein oder mehrere Werte angegeben, die durch Kommata getrennt sind.
Werte
left-
Richtet die linke Kante des Hintergrundbildes an der linken Kante der Hintergrundpositionsebene aus.
center-
Richtet die Mitte des Hintergrundbildes in der Mitte der Hintergrundpositionsebene aus.
right-
Richtet die rechte Kante des Hintergrundbildes an der rechten Kante der Hintergrundpositionsebene aus.
<length>-
Der Versatz der linken vertikalen Kante des gegebenen Hintergrundbildes von der linken vertikalen Kante der Hintergrundpositionsebene. (Einige Browser erlauben die Zuweisung des rechten Randes für den Versatz).
<percentage>-
Der Versatz der horizontalen Position des gegebenen Hintergrundbildes relativ zum Container. Ein Wert von 0% bedeutet, dass die linke Kante des Hintergrundbildes mit der linken Kante des Containers ausgerichtet ist, und ein Wert von 100% bedeutet, dass die rechte Kante des Hintergrundbildes mit der rechten Kante des Containers ausgerichtet ist, sodass ein Wert von 50% das Hintergrundbild horizontal zentriert.
Formale Definition
| Anfangswert | 0% |
|---|---|
| Anwendbar auf | alle Elemente. Auch anwendbar auf ::first-letter und ::first-line. |
| Vererbt | Nein |
| Prozentwerte | bezieht sich auf die Breite des Hintergrundpositionsbereichs abzüglich der Höhe des Hintergrundbilds |
| Berechneter Wert | Eine Liste, bei der jeder Eintrag aus einem Versatz besteht, der durch eine Kombination aus absoluter Länge und einem Prozentsatz plus einem Ursprungsschlüsselwort definiert wird |
| Animationstyp | a repeatable list |
Formale Syntax
background-position-x =
[ center | [ [ left | right | x-start | x-end ]? <length-percentage>? ]! ]#
<length-percentage> =
<length> |
<percentage>
Beispiele
Einfaches Beispiel
Das folgende Beispiel zeigt eine Implementierung eines Hintergrundbildes, wobei background-position-x und background-position-y verwendet werden, um die horizontale und vertikale Position des Bildes getrennt zu definieren.
HTML
<div></div>
CSS
div {
width: 300px;
height: 300px;
background-color: skyblue;
background-image: url("https://mdn.dev/archives/media/attachments/2020/07/29/17350/3b4892b7e820122ac6dd7678891d4507/firefox.png");
background-repeat: no-repeat;
background-position-x: center;
background-position-y: bottom;
}
Ergebnis
Seitenbezogene Werte
Das folgende Beispiel zeigt die Unterstützung der seitenbezogenen Offset-Syntax, die es dem Entwickler ermöglicht, den Hintergrund von jedem Rand zu versetzen.
HTML
<div></div>
CSS
div {
width: 300px;
height: 300px;
background-color: seagreen;
background-image: url("https://mdn.dev/archives/media/attachments/2020/07/29/17350/3b4892b7e820122ac6dd7678891d4507/firefox.png");
background-repeat: no-repeat;
background-position-x: right 20px;
background-position-y: bottom 10px;
}
Ergebnis
Spezifikationen
| Specification |
|---|
| CSS Backgrounds Module Level 4 # background-position-longhands |