Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten.Erfahre mehr über dieses Experiment.
<position-area>
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
Der<position-area>CSSDatentyp definiert die Zelle oder überspannten Zellen einesPosition-Area-Rasters, eines 3x3-Rasters, dessen mittlere Zelle ein Ankerelement ist.
Die<position-area>-Schlüsselwortwerte können als Wert derposition-area-Eigenschaft festgelegt werden, um ein Anker-positioniertes Element an einem bestimmten Ort relativ zu seinem verbundenen Ankerelement zu platzieren.
In diesem Artikel
Syntax
<position-area> = [ [ left | center | right | span-left | span-right | x-start | x-end | span-x-start | span-x-end | self-x-start | self-x-end | span-self-x-start | span-self-x-end | span-all ]|| [ top | center | bottom | span-top | span-bottom | y-start | y-end | span-y-start | span-y-end | self-y-start | self-y-end | span-self-y-start | span-self-y-end | span-all ]| [ block-start | center | block-end | span-block-start | span-block-end | span-all ]|| [ inline-start | center | inline-end | span-inline-start | span-inline-end | span-all ]| [ self-block-start | self-block-end | span-self-block-start | span-self-block-end | span-all ]|| [ self-inline-start | self-inline-end | span-self-inline-start | span-self-inline-end | span-all ]| [ start | center | end | span-start | span-end | span-all ]{1,2}| [ self-start | center | self-end | span-self-start | span-self-end | span-all ]{1,2}]Beschreibung
Positionsbereiche basieren auf dem Konzept einesPosition-Area-Rasters, eines 3x3-Rasters von Feldern, das aus vier Rasterlinien besteht, zwei auf jeder Achse, wobei das Ankerelement das mittlere Feld ist:

Wenn es als Wert derposition-area-Eigenschaft eines positionierten Elements verwendet wird, werden die Abmessungen des mittleren Feldes durch denenthaltenden Block des Standard-Ankerelements des Elements definiert. Die Abmessungen des äußeren Randes des Rasters werden durch den enthaltenen Block des positionierten Elements definiert. Logische Schlüsselbegriffe basieren im Allgemeinen auf dem Schreibmodus und der Richtung des enthaltenen Blocks, außer bei denself-*-Schlüsselbegriffen, die vom Schreibmodus des anker-positionierten Elements berechnet werden.
Die Gitterfelder sind in Reihen und Spalten unterteilt:
- Die drei Reihen werden durch die physischen Werte
top,centerundbottomdargestellt. Sie haben auch logische Äquivalente wieblock-start,centerundblock-end, sowie Koordinatenäquivalente —y-start,centerundy-end. - Die drei Spalten werden durch die physischen Werte
left,centerundrightdargestellt. Sie haben auch logische Äquivalente wieinline-start,centerundinline-end, sowie Koordinatenäquivalente —x-start,centerundx-end.
<position-area>-Werte enthalten ein oder zwei Schlüsselwörter, die einen bestimmten Bereich des Position-Area-Rasters definieren. Durch das Setzen einesposition-area-Werts auf ein positioniertes Element wird dessen enthaltender Block im angegebenen Rasterbereich platziert:
/* Examples: Two keywords to place the element in a single specific tile */position-area: top left;position-area: bottom right;position-area: start end;position-area: center end;position-area: block-start center;position-area: inline-start block-end;position-area: x-start y-end;position-area: center self-y-end;/* Examples: Two keywords to span the element across two tiles */position-area: top span-left;position-area: span-bottom right;position-area: center span-start;position-area: inline-start span-block-end;position-area: y-start span-x-end;/* Examples: Two keywords to span the element across three tiles */position-area: top span-all;position-area: block-end span-all;position-area: self-x-start span-all;/* Examples: One keyword with an implicit second keyword */position-area: top; /* equiv: top span-all */position-area: inline-start; /* equiv: inline-start span-all */position-area: center; /* equiv: center center */position-area: span-all; /* equiv: center center */position-area: start; /* equiv: start start */position-area: end; /* equiv: end end */Die verschiedenen Arten von Schlüsselwörtern, die verwendet werden können, umfassen:
- Physische Raster-Schlüsselwörter
- Allgemeine logische Reihen- und Spaltenschlüsselwörter
- Explizite inline und block logische Schlüsselwörter
- Koordinaten-Raster-Schlüsselwörter
Hinweis:Im Allgemeinen können Sie in einem Wert keine verschiedenen Typen mischen, z. B. physisch und logisch. Dies führt zu ungültigen Werten. Zum Beispiel istposition-area: bottom inline-end kein gültiger Wert, weil es physische und logische Schlüsselwörter mischt.
Physische Raster-Schlüsselwörter
Die physischen Raster-Schlüsselwörter spezifizieren eine Zelle oder einen Abschnitt desposition-area-Rasters mit physischen Werten. Diese Werte werden nicht von den Einstellungenwriting-mode oderdirection beeinflusst.
Mit den physischen Reihen- und Spaltenschlüsselwörtern können Sie jeweils ein Schlüsselwort aus jeder der beiden Listen unten auswählen, um ein einzelnes spezifisches Rasterfeld auszuwählen:
top,centeroderbottom: Die obere, mittlere oder untere Reihe des Rasters.left,centeroderright: Die linke, mittlere oder rechte Spalte des Rasters.
Zum Beispiel wählttop left das obere linke Feld aus, währendcenter right das mittlere Feld der rechten Spalte auswählt.
Physische überbrückende Raster-Schlüsselwörter
Die physischen überbrückenden Schlüsselwörter — in Kombination mit einem physischen Reihen- oder Spaltenschlüsselwort — spezifizieren ein zweites Rasterfeld, in das sich der Positionierungsbereich ausdehnen soll. Wenn eine solche Kombination alsposition-area-Eigenschaftswert festgelegt ist, wird ein ausgewähltes Element zunächst in der Mitte der angegebenen Reihe oder Spalte platziert; es erstreckt sich dann in die durch das überbrückende Schlüsselwort spezifizierte Richtung und erstreckt sich über zwei Rasterfelder:
span-leftErstreckt sich über die Mittelsäule und die linke Säule des Rasters.
span-rightErstreckt sich über die Mittelsäule und die rechte Säule des Rasters.
span-topErstreckt sich über die Mittelreihe und die obere Reihe des Rasters.
span-bottomErstreckt sich über die Mittelreihe und die untere Reihe des Rasters.
span-allGültig für alle Schlüsselworttypen, erstreckt sich über die angegebene Zelle sowie die angrenzenden Zellen in derselben Reihe oder Spalte. Siehe
span-allunten.
Zum Beispiel erstreckt sichtop span-left über die oberen mittleren und oberen linken Rasterzellen.
Hinweis:Der Versuch, ein Reihen- oder Spaltenschlüsselwort mit einem unangemessenen überbrückenden Schlüsselwort zu kombinieren, führt zu einem ungültigen Wert. Zum Beispiel istright span-right ungültig — Sie können nicht das mittlere rechte Rasterfeld auswählen und dann versuchen, weiter nach rechts zu spannen.
Standardwerte physische Raster-Schlüsselwörter
Wenn nur ein einzelnes physisches Schlüsselwort imposition-area-Wert spezifiziert ist, wird der andere Wert wie folgt impliziert:
left,right,topoderbottomDer andere Wert geht implizit von
span-allaus, wodurch das Element alle drei Kacheln der Spalte oder Reihe überspannt, in der es ursprünglich platziert wurde. Zum Beispiel istleftgleichbedeutend mitleft span-all.center,span-left,span-right,span-topoderspan-bottomDer andere Wert geht von
centeraus. Zum Beispiel istspan-leftgleichbedeutend mitcenter span-leftundcenterist gleichbedeutend mitcenter center.
Logische Raster-Schlüsselwörter
Die logischen Raster-Schlüsselwörter spezifizieren einen Bereich des Positionierungsbereichsrasters mit logischen Werten. Mit diesen Werten werden die Position und Richtung von den Einstellungenwriting-mode unddirection beeinflusst, entweder auf dementhältenden Block eines Elements oder, im Fall derself-Schlüsselwörter, auf dem positionierten Element selbst. Es gibt zwei Arten von logischen Schlüsselwörtern: generisch und explizit.
Allgemeine logische Reihen- und Spaltenschlüsselwörter
Die allgemeinen logischen Schlüsselwörter verwenden dieselben Begriffe für die Inline- und Blockrichtungen, wobei die Richtung durch die Position des Schlüsselbegriffs innerhalb eines Paares von<position-area>-Werten bestimmt wird. Der erste Wert definiert die Blockrichtungsposition und der zweite Wert definiert den Inline-Wert. Sie können ein oder zwei Schlüsselbegriffe aus der folgenden Liste angeben. Zwei aus dieser Liste spezifizieren ein einzelnes spezifisches Rasterfeld. Die Schlüsselwortposition oder -richtung ist:
startDer Anfang der Block- oder Inlinerichtung des Rasters, berechnet aus dem Schreibmodus des enthältenden Blocks.
endDas Ende der Block- oder Inlinerichtung des Rasters, berechnet aus dem Schreibmodus des enthältenden Blocks.
self-startDer Anfang der Block- oder Inlinerichtung des Rasters, berechnet aus dem eigenen Schreibmodus des Elements.
self-endDas Ende der Block- oder Inlinerichtung des Rasters, berechnet aus dem eigenen Schreibmodus des Elements.
centerDie Mitte der Blockrichtung des Rasters (wenn dieses Schlüsselwort zuerst angegeben wird) oder Inline-Richtung (wenn dieses Schlüsselwort als zweites angegeben wird).
Zum Beispiel beschreibenstart end undself-start self-end beide die Position am Anfang der Blockrichtung und am Ende der Inlinerichtung. Mitwriting-mode: horizontal-tb gesetzt, ist dies oben rechts vom Anker, während es mitwriting-mode: vertical-rl unten rechts vom Anker ist.
Allgemeine logische überbrückende Reihen- und Spaltenschlüsselwörter
Die allgemeinen logischen überbrückenden Schlüsselwörter — in Kombination mit einem logischen Reihen- oder Spaltenschlüsselwort — spezifizieren ein zweites Rasterfeld, in das sich der Positionierungsbereich ausdehnen soll. Wenn eine solche Kombination alsposition-area-Eigenschaftswert festgelegt ist, wird ein ausgewähltes Element zunächst in der Mitte der angegebenen Reihe oder Spalte platziert, und es spannt sich dann in die durch das überbrückende Schlüsselwort spezifizierte Richtung und erstreckt sich über zwei Rasterfelder:
span-startErstreckt sich über das mittlere Feld und das Startfeld der Gitterreihe/-spalte, wobei sich die Richtung auf den Schreibmodus des enthältenden Blocks des Elements bezieht.
span-endErstreckt sich über das mittlere Feld und das Endfeld der Gitterreihe/-spalte, wobei sich die Richtung auf den Schreibmodus des enthältenden Blocks des Elements bezieht.
span-self-startErstreckt sich über das mittlere Feld und das Startfeld der Gitterreihe/-spalte für den eigenen Schreibmodus des positionierten Elements.
span-self-endErstreckt sich über das mittlere Feld und das Endfeld der Gitterreihe/-spalte, berechnet aus dem eigenen Schreibmodus des Elements.
Zum Beispiel spezifizierenstart span-end undself-start span-self-end beide einen Rasterpositionierungsbereich, der im Zentrum der Startblockreihe beginnt und sich über die Kacheln erstreckt, die in dieser Reihe in den Inline-Mitteil- und Endspalten liegen. Mitwriting-mode: horizontal-tb gesetzt, würde dies über die oberen mittleren und oberen rechten Anker spannen, während es im Moduswriting-mode: vertical-rl das Element über das rechte mittlere und untere rechte erstrecken würde.
Explizite inline und block logische Schlüsselwörter
Die expliziten inline- und block-logischen Reihen- und Spaltenschlüsselwörter beziehen sich explizit auf eine Block- (Reihe) oder Inline- (Spalte) Position. Sie können ein Schlüsselwort für die Blockrichtung und eines für die Inlinerichtung angeben, um ein einzelnes spezifisches Rasterfeld auszuwählen. Im Gegensatz zu den generischen logischen Schlüsselwortwerten spielt die Reihenfolge der Schlüsselwörter keine Rolle. Das Deklarieren von zwei Schlüsselwörtern in derselben Achse macht jedoch den Wert ungültig.
block-startDer Anfang der Blockrichtung des Rasters, berechnet aus dem Schreibmodus des enthältenden Blocks.
block-endDas Ende der Blockrichtung des Rasters, berechnet aus dem Schreibmodus des enthältenden Blocks.
inline-startDer Anfang der Inlinerichtung des Rasters, berechnet aus dem Schreibmodus des enthältenden Blocks.
inline-endDas Ende der Inlinerichtung des Rasters, berechnet aus dem Schreibmodus des enthältenden Blocks.
Zum Beispiel spezifiziertblock-start inline-end das Feld am Anfang der Blockrichtung und am Ende der Inlinerichtung. Mitwriting-mode: horizontal-tb gesetzt, wäre dies das Feld oben rechts des Ankers, während es mitwriting-mode: vertical-rl das Feld unten rechts wäre.
Hinweis:Die Spezifikation definiertself-Äquivalente dieser Schlüsselwörter —block-self-start,block-self-end,inline-self-start undinline-self-end. Allerdings werden diese derzeit von keinem Browser unterstützt.
Explizite inline und block logische überbrückende Schlüsselwörter
Die expliziten logischen überbrückenden Schlüsselwörter — wenn sie mit einem logischen Reihen- oder Spaltenschlüsselwort kombiniert werden — spezifizieren ein zweites Rasterfeld für den Positionierungsbereich, in das sich das Element ausdehnt. Wenn eine solche Kombination alsposition-area-Eigenschaftswert festgelegt ist, wird ein ausgewähltes Element zunächst in der Mitte der angegebenen Reihe oder Spalte, basierend auf dem Schreibmodus des enthältenden Blocks, platziert, und es spannt sich dann in die durch das überbrückende Schlüsselwort spezifizierte Richtung, über zwei Rasterfelder:
span-block-startErstreckt sich über das mittlere Feld und das Block-Start-Feld der angegebenen Inline-Spalte.
span-block-endErstreckt sich über das mittlere Feld und das Block-End-Feld der angegebenen Inline-Spalte.
span-inline-startErstreckt sich über das mittlere Feld und das Inline-Start-Feld der angegebenen Blockreihe.
span-inline-endErstreckt sich über das mittlere Feld und das Inline-End-Feld der angegebenen Blockreihe.
Zum Beispiel,block-end span-inline-start wählt das mittlere Feld der Endblockreihe und spannt sich über die Felder in dieser Reihe, die in den Inline-Mittel- und Startspalten liegen. Mitwriting-mode: horizontal-tb gesetzt, würde dies die unteren mittleren und unteren linken Rasterfelder überspannen, während es mitwriting-mode: vertical-rl die linken mittleren und oberen linken Rasterfelder überspannen würde.
Hinweis:Die Spezifikation definiertself-Äquivalente dieser Schlüsselwörter, z. B. —span-self-block-start,span-self-block-end,span-self-inline-start undspan-self-inline-end. Diese werden jedoch derzeit von keinem Browser unterstützt.
Hinweis:Der Versuch, eine Reihen- oder Spaltenschlüsselwort mit einem unangemessenen überbrückenden Schlüsselwort zu kombinieren, führt zu einem ungültigen Eigenschaftswert. Zum Beispiel istblock-end span-block-end ungültig — Sie können nicht die mittlere Block-End-Reihe auswählen und dann versuchen, ein Feld weiter über die Block-End-Richtung zu spannen.
Standardwerte logische Raster-Schlüsselwörter
Wenn nur ein einzelnes logisches<position-area>-Schlüsselwort angegeben ist, wird der andere Wert wie folgt impliziert:
start,end,self-startoderself-endDer andere Wert wird mit demselben Wert wie der erste angegeben, der die Rasterzelle in der Startreihe und -spalte oder der Endreihe und -spalte auswählt.
span-start,span-self-start,span-end,span-self-endDer andere Wert ist
center. Zum Beispiel istspan-startgleichbedeutend mitspan-start center.block-start,block-end,inline-start,inline-endDer andere Wert ist
span-all, der alle drei Kacheln der Spalte oder Reihe überspannt, in der es ursprünglich platziert wurde. Zum Beispiel istblock-startgleichbedeutend mitblock-start span-all.span-block-start,span-block-end,span-inline-start,span-inline-endDer andere Wert ist
center. Zum Beispiel istspan-inline-startgleichbedeutend mitspan-inline-start center.
Koordinaten-Raster-Schlüsselwörter
Diese Schlüsselwörter spezifizieren die Zellen desposition-area-Rasters mit x- und y-Koordinatenwerten. Ihre Position/Richtung wird durch die Einstellungenwriting-mode und/oderdirection beeinflusst, entweder auf einementhältenden Block eines Elements oder, im Fall derself-Schlüsselwörter, auf dem Element selbst.
Allerdings sind die Rasterzellen gemäß den physischen Achsen und nicht den Block-/Inline-Richtungen definiert:
- Für
writing-mode: horizontal-tbundvertical-lrverläuft die x-Achse von links nach rechts und die y-Achse von oben nach unten. - Bei
writing-mode: horizontal-tb; direction: rtlundwriting-mode: vertical-rlverläuft die x-Achse von rechts nach links und die y-Achse von oben nach unten.
Mit den Koordinatenreihen- und -spaltenschlüsselwörtern können Sie ein Schlüsselwort von der x-Achse und eines von der y-Achse auswählen, um ein einzelnes spezifisches Rasterfeld zu definieren.
Die x-Achsen-Schlüsselwörter umfassen:
x-startDie Startkachel entlang der x-Achse des Rasters, berechnet aus dem Schreibmodus des enthältenden Blocks.
x-endDie Endkachel entlang der x-Achse des Rasters, berechnet aus dem Schreibmodus des enthältenden Blocks.
self-x-startDie Startkachel entlang der x-Achse des Rasters, berechnet aus dem eigenen Schreibmodus des Elements.
self-x-endDie Endkachel entlang der x-Achse des Rasters, berechnet aus dem eigenen Schreibmodus des Elements.
centerDie Mitte der x-Achse des Rasters, berechnet aus dem eigenen Schreibmodus des Elements.
Die y-Achsen-Schlüsselwörter umfassen:
y-startDie Startkachel entlang der y-Achse des Rasters, berechnet aus dem Schreibmodus des enthältenden Blocks.
y-endDie Endkachel entlang der y-Achse des Rasters, berechnet aus dem Schreibmodus des enthältenden Blocks.
self-y-startDie Startkachel entlang der y-Achse des Rasters, berechnet aus dem eigenen Schreibmodus des Elements.
self-y-endDie Endkachel entlang der y-Achse des Rasters, berechnet aus dem eigenen Schreibmodus des Elements.
centerDie Mitte der y-Achse des Rasters, berechnet aus dem eigenen Schreibmodus des Elements.
Zum Beispiel wählenx-end y-start undself-x-end self-y-start beide die Rasterzelle am Ende der x-Achse und am Anfang der y-Achse aus. Mitwriting-mode: horizontal-tb gesetzt, wäre dies die Zelle oben rechts vom Anker, während es beiwriting-mode: vertical-rl oben links ist.
Koordinaten-überbrückende Schlüsselwörter
In Kombination mit einem Koordinatenreihen- oder -spaltenschlüsselwort spezifizieren die koordinatenüberbrückenden Schlüsselwörter ein zweites Rasterfeld für den Positionierungsbereich, in das sich das Element ausdehnen soll. Wenn eine solche Kombination alsposition-area-Eigenschaftswert festgelegt ist, wird ein ausgewähltes Element zunächst in der Mitte der angegebenen Reihe oder Spalte platziert, und es spannt sich dann in die durch das überbrückende Schlüsselwort spezifizierte Richtung und erstreckt sich über zwei Rasterfelder:
span-x-startErstreckt sich über das mittlere Feld und das x-Start-Feld der angegebenen y-Achsenreihe.
span-x-endErstreckt sich über das mittlere Feld und das x-End-Feld der angegebenen y-Achsenreihe.
span-y-startErstreckt sich über das mittlere Feld und das y-Start-Feld der angegebenen x-Achsenspalte.
span-y-endErstreckt sich über das mittlere Feld und das y-Ende-Feld der angegebenen x-Achsenspalte.
Zum Beispiel selektierty-end span-x-end das Feld in der Mitte der End-y-Reihe und spannt sich über die Felder in dieser Reihe, die in den x-Mittel- und x-Endspalten liegen. Mitwriting-mode: horizontal-tb gesetzt, würde der Positionierungsbereich des Rasters die unteren mittleren und unteren rechten Rasterfelder überspannen, während er mitwriting-mode: vertical-rl die unteren mittleren und unteren linken Felder überspannen würde.
Hinweis:Die Spezifikation definiert keine separatenself-koordinatenüberbrückenden Schlüsselwörter, aber diese werden nicht benötigt — die überbrückenden Schlüsselwörter können mit sowohl Koordinatenreihen- als auch -spaltenschlüsselwörtern verwendet werden.
Standardwerte Koordinaten-Raster-Schlüsselwörter
Wenn nur ein einzelnes Koordinatenraster-<position-area>-Schlüsselwort angegeben ist, wird der andere Wert wie folgt impliziert:
x-start,self-x-start,x-end,self-x-end,y-start,self-y-start,y-endoderself-y-endDer andere Wert ist
span-all, wobei die Rasterzellen alle drei Kacheln der Spalte oder Reihe überspannen, in der es ursprünglich platziert wurde. Zum Beispiel istx-startgleichbedeutend mitx-start span-all.span-x-start,span-x-end,span-y-start,span-y-end,span-self-x-start,span-self-x-end,span-self-y-endoderspan-self-y-startDer andere Wert geht von
centeraus. Zum Beispiel istspan-startgleichbedeutend mitspan-start center.
span-all
span-all ist ein spezielles Schlüsselwort, das mit allen in den obigen Abschnitten aufgeführten Reihen- und Spaltenschlüsselwörtern verwendet werden kann. Wenn Sie zwei Werte angeben — ein Reihen-/Spaltenschlüsselwort undspan-all, wird das Element in der angegebenen Reihe oder Spalte platziert und spannt sich dann über alle Kacheln in dieser Reihe oder Spalte.
Beispiele
Siehe die Eigenschaftsseiteposition-area.
Für detaillierte Informationen zu Ankerfunktionen und deren Verwendung siehe die Modul-StartseiteCSS-Ankerpositionierung und denVerwendung von CSS-Ankerpositionierung Leitfaden.
Spezifikationen
| Specification |
|---|
| CSS Anchor Positioning> # position-area> |