<position>

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

Der <position> CSS Datentyp bezeichnet ein zweidimensionales Koordinatensystem, das verwendet wird, um eine Position relativ zu einem Elementrahmen festzulegen. Es wird in den Eigenschaften background-position, object-position, mask-position, offset-position, offset-anchor und transform-origin verwendet.

Hinweis: Die durch den <position> Wert beschriebene Endposition muss sich nicht innerhalb des Elementrahmens befinden.

Syntax

Raster zeigt die Platzierung verschiedener Werte. 0 0 ist die obere linke Ecke. Die vier Werte, right, right center, center left 100%, und top 50% left 100%, sind alle gleichwertig, da sie sich an der rechten Kante in der Mitte vertikal befinden. Die beiden Werte, top 75px left 100px und left 100px top 75px, sind identisch. Bottom left 25% ist gleich wie top 100% left 25%.

Der <position> Datentyp wird mit einem oder zwei Schlüsselwörtern und optionalen Versätzen angegeben.

Die Schlüsselwortwerte sind center, top, right, bottom und left. Jedes Schlüsselwort repräsentiert entweder eine Kante des Elementrahmens oder die Mittellinie zwischen zwei Kanten. Je nach Kontext repräsentiert center entweder die Mitte zwischen den linken und rechten Kanten oder die Mitte zwischen den oberen und unteren Kanten.

Falls angegeben, kann ein Versatz entweder ein relativer <percentage> Wert oder ein absoluter <length> Wert sein. Positive Werte werden in Richtung rechts oder unten versetzt, je nachdem, was angemessen ist. Negative Werte werden in die entgegengesetzten Richtungen versetzt.

Wenn nur ein einziger Versatzwert angegeben ist, definiert er die x-Koordinate, wobei der Wert für die andere Achse standardmäßig auf center gesetzt wird.

css

/* 1-value syntax */
keyword                  /* Either the horizontal or vertical position; the other axis defaults to center */
value                    /* The position on the x-axis; the y-axis defaults to 50% */

/* 2-value syntax */
keyword keyword          /* A keyword for each direction (the order is irrelevant) */
keyword value            /* A keyword for horizontal position, value for vertical position */
value keyword            /* A value for horizontal position, keyword for vertical position */
value value              /* A value for each direction (horizontal then vertical) */

/* 4-value syntax */
keyword value keyword value /* Each value is an offset from the keyword that precedes it */

Hinweis: Die background-position Eigenschaft akzeptiert auch eine dreiwertige Syntax. Dies ist bei anderen Eigenschaften, die <position> verwenden, nicht erlaubt.

Interpolation

Bei der Animation werden die Abszisse und Ordinate eines Punktes unabhängig voneinander interpoliert. Da jedoch die Geschwindigkeit der Interpolation durch eine einzelne Easing-Funktion für beide Koordinaten bestimmt wird, wird sich der Punkt in einer geraden Linie bewegen.

Formale Syntax

<position> = 
  [ left | center | right | top | bottom | <length-percentage> ]  |
  [ left | center | right ] && [ top | center | bottom ]  |
  [ left | center | right | <length-percentage> ] [ top | center | bottom | <length-percentage> ]  |
  [ [ left | right ] <length-percentage> ] && [ [ top | bottom ] <length-percentage> ]  

<length-percentage> = 
  <length>      |
  <percentage>

Beispiele

Gültige Positionen

center
left
center top

right 8.5%
bottom 12vmin right -6px

10% 20%
8rem 14px

Ungültige Positionen

left right
bottom top
10px 15px 20px 15px

Spezifikationen

Specification
CSS Values and Units Module Level 4 # position