Veröffentlicht: 10. Mai 2024
Die CSS Anchor Positioning API ist ein echter Gamechanger in der Webentwicklung, da Sie damit Elemente nativ relativ zu anderen Elementen positionieren können, die als Anker bezeichnet werden. Diese API vereinfacht komplexe Layoutanforderungen für viele Benutzeroberflächenfunktionen wie Menüs und Untermenüs, Kurzinfos, Auswahlmöglichkeiten, Labels, Karten, Einstellungsdialoge und vieles mehr. Da die Positionierung von Ankern im Browser integriert ist, können Sie mehrschichtige Benutzeroberflächen erstellen, ohne auf Bibliotheken von Drittanbietern angewiesen zu sein. Das eröffnet Ihnen eine Vielzahl kreativer Möglichkeiten.
Die Ankerpositionierung ist seit Chrome 125 verfügbar.
Grundlegende Konzepte: Anker und positionierte Elemente
Im Mittelpunkt dieser API steht die Beziehung zwischen Anchors (Anker) und positioned Elements (Positionierte Elemente). Ein Anker ist ein Element, das mithilfe der Property anchor-name
als Referenzpunkt festgelegt wird. Ein positioniertes Element ist ein Element, das mithilfe der Property position-anchor
oder explizit mit anchor-name
in der Positionierungslogik relativ zu einem Anker platziert wird.
Anker einrichten
Das Erstellen eines Ankers ist ganz einfach. Wenden Sie die Eigenschaft „anchor-name“ auf das ausgewählte Element an und weisen Sie ihm eine eindeutige Kennung zu. Diese eindeutige Kennung muss wie eine CSS-Variable mit einem doppelten Bindestrich vorangestellt werden.
.anchor-button {
anchor-name: --anchor-el;
}
Nachdem .anchor-button
einen Ankernamen zugewiesen wurde, dient es als Anker, an dem andere Elemente ausgerichtet werden können. Sie können diesen Anker auf zwei Arten mit anderen Elementen verbinden:
Implizite Anker
Die erste Möglichkeit, einen Anker mit einem anderen Element zu verbinden, ist ein impliziter Anker, wie im folgenden Codebeispiel. Die Eigenschaft position-anchor
wird dem Element hinzugefügt, das Sie mit dem Anker verbinden möchten. Sie hat den Namen des Ankers (in diesem Fall --anchor-el
) als Wert.
.positioned-notice {
position-anchor: --anchor-el;
}
Bei einer impliziten Ankerbeziehung können Sie Elemente mithilfe der Funktion anchor()
positionieren, ohne den Ankernamen explizit beim ersten Argument anzugeben.
.positioned-notice {
position-anchor: --anchor-el;
top: anchor(bottom);
}
Explizite Anchors
Alternativ können Sie den Ankernamen direkt in der Ankerfunktion verwenden (z. B. top: anchor(--anchor-el bottom
). Dies wird als expliziter Anker bezeichnet und ist praktisch, wenn Sie bei mehreren Elementen verankern möchten (siehe Beispiel).
.positioned-notice {
top: anchor(--anchor-el bottom);
}
Elemente relativ zu Ankern positionieren
Die Positionierung der Anker baut auf der absoluten CSS-Positionierung auf. Wenn Sie Positionswerte verwenden möchten, müssen Sie dem positionierten Element position: absolute
hinzufügen. Verwenden Sie dann die Funktion anchor()
, um die Positionierungswerte anzuwenden. Wenn Sie beispielsweise ein verankertes Element links oben positionieren möchten, verwenden Sie die folgende Positionierung:
.positioned-notice {
position-anchor: --anchor-el;
/* absolutely position the positioned element */
position: absolute;
/* position the right of the positioned element at the right edge of the anchor */
right: anchor(right);
/* position the bottom of the positioned element at the top edge of the anchor */
bottom: anchor(top);
}
Jetzt ist ein Element an ein anderes angedockt, wie in der folgenden Abbildung dargestellt.
Wenn Sie für diese Werte die logische Positionierung verwenden möchten, entsprechen sie den folgenden Werten:
top
=inset-block-start
left
=inset-inline-start
bottom
=inset-block-end
right
=inset-inline-end
Ein positioniertes Element mit anchor-center
zentrieren
Damit Sie das an einem Anker positionierte Element leichter relativ zum Anker zentrieren können, gibt es den neuen Wert anchor-center
, der mit den Eigenschaften justify-self
, align-self
, justify-items
und align-items
verwendet werden kann.
In diesem Beispiel wird das vorherige Beispiel geändert, indem das positionierte Element mit justify-self: anchor-center
über dem Anker zentriert wird.
.positioned-notice {
position: absolute;
/* Anchor reference */
position-anchor: --anchor-el;
/* Position bottom of positioned elem at top of anchor */
bottom: anchor(top);
/* Center justification to the anchor */
justify-self: anchor-center;
}
Mehrere Anker
Elemente können mit mehr als einem Anker per Tethering verbunden werden. Das bedeutet, dass Sie möglicherweise Positionswerte festlegen müssen, die relativ zu mehr als einem Anker positioniert sind. Verwenden Sie dazu die Funktion anchor()
und geben Sie im ersten Argument explizit an, auf welchen Anker Sie verweisen. Im folgenden Beispiel ist die linke obere Ecke eines positionierten Ankers an der unteren rechten Ecke eines Ankers und die untere rechte des positionierten Elements oben links des zweiten Ankers verankert:
.anchored {
position: absolute;
top: anchor(--one bottom);
left: anchor(--one right);
right: anchor(--two left);
bottom: anchor(--two top);
}
Position mit inset-area
Zusätzlich zur standardmäßigen Richtungspositionierung von der absoluten Positionierung aus gibt es einen neuen Layout-Mechanismus in der Anchoring API: Einfügungsbereich.
Mit dem Einzugsbereich können Sie Elemente, die an einem Anker positioniert sind, ganz einfach relativ zu ihren jeweiligen Ankern platzieren. Er basiert auf einem 9-Zellen-Raster mit dem Ankerelement in der Mitte.
Verschiedene Positionierungsoptionen für den eingefügten Bereich, dargestellt auf dem 9-Zellen-Raster
Wenn Sie anstelle der absoluten Positionierung den eingefügten Bereich verwenden möchten, verwenden Sie das Attribut inset-area
mit physischen oder logischen Werten. Beispiel:
- Oben mittig:
inset-area: top
oderinset-area: block-start
- Links-Mitte:
inset-area: left
oderinset-area: inline-start
- Unten in der Mitte:
inset-area: bottom
oderinset-area: block-end
- Rechtszentriert:
inset-area: right
oderinset-area: inline-end
Größe von Elementen mit anchor-size()
anpassen
Die anchor-size()
-Funktion, die ebenfalls Teil der Anchor Positioning API ist, kann verwendet werden, um die Größe oder Position eines Ankerelements anhand der Größe seines Ankers (Breite, Höhe oder Inline- und Blockgrößen) festzulegen oder zu positionieren.
Im folgenden CSS wird ein Beispiel für die Verwendung dieses Werts für die Höhe gezeigt. Dabei wird anchor-size(height)
in einer calc()
-Funktion verwendet,um die maximale Höhe der Kurzinfo auf die doppelte Höhe des Ankers festzulegen.
.positioned-notice {
position-anchor: --question-mark;
/* set max height of the tooltip to 2x height of the anchor */
max-height: calc(anchor-size(height) * 2);
}
Anker mit Elementen der obersten Ebene wie Pop-ups und Dialogfeldern verwenden
Die Anlegeposition funktioniert hervorragend mit Elementen der obersten Ebene wie popover
. und <dialog>
. Während diese Elemente in einer separaten Ebene vom Rest der DOM-Unterstruktur platziert werden, können Sie sie mithilfe der Positionierung von Anker an eine Tethering-Verbindung zurückverfolgen und mit Elementen, die sich nicht im obersten Layer befinden, mit ihnen scrollen. Dies ist ein großer Gewinn für mehrschichtige Benutzeroberflächen.
Im folgenden Beispiel werden mehrere Pop-ups mit Kurzinfos über eine Schaltfläche geöffnet. Die Schaltfläche ist der Anker und die Kurzinfo ist das positionierte Element. Sie können das positionierte Element wie jedes andere verankerte Element gestalten. In diesem konkreten Beispiel sind anchor-name
und position-anchor
Inline-Stile für die Schaltfläche und die Kurzinfo. Da jeder Anker einen eindeutigen Ankernamen benötigt, ist das Einfügen beim Generieren dynamischer Inhalte die einfachste Methode.
Ankerpositionen mit @position-try
anpassen
Nachdem Sie die anfängliche Position des Ankers ermittelt haben, können Sie die Position anpassen, wenn der Anker die Kanten des enthaltenden Blocks erreicht. Wenn Sie alternative Ankerpositionen erstellen möchten, können Sie die Direktive @position-try
zusammen mit der Property position-try-options
verwenden.
Im folgenden Beispiel wird rechts neben einem Menü ein Untermenü angezeigt. Menüs und Untermenüs eignen sich hervorragend zur Verwendung der Anchor Positioning API zusammen mit dem Popover-Attribut, da diese Menüs tendenziell an einer Triggerschaltfläche verankert sind.
Wenn für dieses Untermenü nicht genügend horizontaler Platz vorhanden ist, können Sie es stattdessen unter das Menü verschieben. Richten Sie dazu zunächst die Ausgangsposition ein:
#submenu {
position: absolute;
position-anchor: --submenu;
/* initial position */
margin-left: var(--padding);
inset-area: right span-bottom;
}
Richten Sie dann mit @position-try
die verankerten Fallback-Positionen ein:
/* alternate position */
@position-try --bottom {
margin: var(--padding) 0 0 var(--padding);
inset-area: bottom;
}
Verbinden Sie die beiden schließlich mit position-try-options
. Insgesamt sieht das so aus:
#submenu {
position: absolute;
position-anchor: --submenu;
/* initial position */
margin-left: var(--padding);
inset-area: right span-bottom;
*/ connect with position-try options */
position-try-options: --bottom;
}
/* alternate position */
@position-try --bottom {
margin: var(--padding) 0 0 var(--padding);
inset-area: bottom;
}
Keywords für automatisches Umblättern von Ankerpositionen
Wenn Sie eine grundlegende Anpassung haben, z. B. von oben nach unten oder von links nach rechts (oder beides), können Sie sogar die Erstellung benutzerdefinierter @position-try
-Deklarationen überspringen und die integrierten, browsergestützten Keywords wie flip-block
und flip-inline
verwenden. Sie können als Platzhalter für benutzerdefinierte @position-try
-Deklarationen verwendet werden und miteinander kombiniert werden:
position-try-options: flip-block, flip-inline, flip-block flip-inline;
Mit Flip-Keywords lässt sich Ihr Ankercode erheblich vereinfachen. Mit nur wenigen Zeilen können Sie einen voll funktionsfähigen Anker mit alternativen Positionen erstellen:
#my-tooltip {
position-anchor: --question-mark;
inset-area: top;
position-try-options: flip-block;
}
position-visibility
für Anker in Subscrollers
In einigen Fällen kann es sinnvoll sein, ein Element in einem untergeordneten Scroller der Seite zu verankern. In diesen Fällen können Sie die Sichtbarkeit des Ankers mit position-visibility
steuern. Wann bleibt der Anker im Bild? Wann verschwindet sie? Mit dieser Funktion haben Sie die Kontrolle über diese Optionen. Sie verwenden position-visibility: anchors-visible
, wenn das positionierte Element so lange sichtbar bleiben soll, bis der Anker nicht mehr im Sichtbereich ist:
#tooltip {
position: fixed;
position-anchor: --anchor-top-anchor;
position-visibility: anchors-visible;
bottom: anchor(top);
}
Alternativ können Sie position-visibility: no-overflow
verwenden, um zu verhindern, dass der Anker den Container überläuft.
#tooltip {
position: absolute;
position-anchor: --anchor-top-anchor;
position-visibility: no-overflow;
bottom: anchor(top);
}
Feature-Erkennung und Polyfill
Da die Browserunterstützung derzeit eingeschränkt ist, sollten Sie diese API mit Vorsicht verwenden. Zuerst können Sie mit der Feature-Abfrage @supports
direkt in CSS nach Unterstützung suchen. Dazu müssen Sie Ihre Ankerstile in Folgendes einschließen:
@supports (anchor-name: --myanchor) {
/* Anchor styles here */
}
Außerdem können Sie die Funktion für die Ankerpositionierung mit dem CSS-Ankerpositionierungs-Polyfill von Oddbird verwenden, das in Firefox 54, Chrome 51, Edge 79 und Safari 10 verfügbar ist. Dieser Polyfill unterstützt die meisten grundlegenden Ankerpositionsmerkmale. Die aktuelle Implementierung ist jedoch noch nicht vollständig und enthält eine veraltete Syntax. Sie können den unpkg-Link verwenden oder das Paket direkt in einen Paketmanager importieren.
Hinweis zur Barrierefreiheit
Mit der Anchor Positioning API kann zwar ein Element relativ zu anderen positioniert werden, es entsteht jedoch keine sinnvolle semantische Beziehung zwischen ihnen. Wenn zwischen dem Ankerelement und dem positionierten Element eine semantische Beziehung besteht (z. B. ist das positionierte Element ein Kommentar in der Seitenleiste zum Ankertext), können Sie aria-details
verwenden, um vom Ankerelement auf die positionierten Elemente zu verweisen. Screenreader-Software lernt noch, wie mit Aria-Details umgegangen wird, aber der Support verbessert sich.
<div class="anchor" aria-details="sidebar-comment">Main content</div>
<div class="positioned" id="sidebar-comment">Sidebar content</div>
.anchor {
anchor-name: --anchor;
}
.positioned {
position: fixed;
position-anchor: --anchor;
}
Wenn Sie die Ankerpositionierung mit dem popover
-Attribut oder mit einem <dialog>
-Element verwenden, übernimmt der Browser die Korrekturen der Fokusnavigation für eine ordnungsgemäße Barrierefreiheit. Ihre Pop-ups oder Dialogfelder müssen also nicht in der DOM-Reihenfolge angeordnet sein. Weitere Informationen finden Sie in der Spezifikation zur Barrierefreiheit.
Fazit
Dies ist eine brandneue Funktion und wir sind gespannt, was Sie damit entwickeln. Bisher haben wir einige wirklich tolle Anwendungsfälle von der Community gesehen, z. B. dynamische Labels in Diagrammen, Verbindungslinien, Fußnoten und visuelle Verweise. Während Sie mit der Positionierung von Ankergeräten experimentieren, würden wir uns über Ihr Feedback freuen. Wenn Sie Fehler finden, kontaktieren Sie uns.