WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / CSS

anchor-name: eine Box benennen, der ein anderes Element folgt

Verbinde ein positioniertes Element mit einem geeigneten Anker, ohne Koordinaten in JavaScript nachzubauen.

Version: CSS Modules

Syntax

anchor-name: --target;

anchor-name weist der Hauptbox eines Elements einen oder mehrere Bezeichner mit zwei führenden Bindestrichen zu, etwa --target oder eine kommagetrennte Liste. none vergibt keine Namen. Die Eigenschaft allein bewegt den Anker nicht, erstellt kein Popup und legt keine Tastaturbedienung fest. Ein positioniertes Element kann den Namen mit position-anchor auswählen und mit anchor() eine Kante der Zielbox beziehen.

Namen müssen nicht eindeutig sein. Das gewählte Ziel hängt vom Gültigkeitsbereich, den DOM-Beziehungen und davon ab, ob ein Kandidat als Anker rechtzeitig im Layout berechnet werden kann. Wiederverwendbare Komponenten sollten diesen Bereich bewusst festlegen, statt Namen wie global eindeutige HTML-IDs zu behandeln. Ein Element ohne geeignete Box liefert keine gewöhnliche Ankergeometrie. Hinterlege Ersatzwerte und prüfe die vollständige Positionierungssyntax, nicht nur die Erkennung von anchor-name.

Im Beispiel erhält ein 80×30px großer Anker bei left: 40px und top: 20px den Namen --target. Eine zweite Box folgt seiner linken und unteren Kante und erscheint bei 40,50. Wird der Anker auf 100,50 verschoben, folgt die abhängige Box auf 100,80, ohne dass JavaScript ihre Position berechnet. Die Umbenennung des Ankers in --other löst die Zuordnung; ausdrückliche 0px-Ersatzwerte setzen die Box auf 0,0. JavaScript ändert nur Stile und liest die resultierende Geometrie.

Beispiele

const host = document.createElement('div');
host.style.cssText = 'position:relative;width:500px;height:200px';
const anchor = document.createElement('div'), popup = document.createElement('div');
anchor.style.cssText = 'position:absolute;left:40px;top:20px;width:80px;height:30px;anchor-name:--target';
popup.style.cssText = 'position:absolute;position-anchor:--target;left:anchor(left,0px);top:anchor(bottom,0px);width:50px;height:20px';
host.append(anchor,popup); document.body.append(host);
const position = () => {const a=host.getBoundingClientRect(),b=popup.getBoundingClientRect();return [Math.round(b.left-a.left),Math.round(b.top-a.top)].join(' ');};
console.log('anchored:', position());
anchor.style.left='100px'; anchor.style.top='50px';
console.log('moved:', position());
anchor.style.anchorName='--other';
console.log('missing name:', position());
host.remove();

Ergebnis

anchored: 40 50
moved: 100 80
missing name: 0 0

Ausgeführt in Chromium 157.0.8103.51 in einem isolierten umschließenden Block. Ankerpositionierung ist neueres CSS: Prüfe Zielbrowser und biete einen brauchbaren Fallback. Namensauflösung über Schattenbäume, automatische Überlaufalternativen und barrierefreie Popup-Bedienung sind hier nicht getestet.

Quellen