WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / CSS

sibling-index(): DOM-Position mit Zählbeginn bei eins

Leite einen Zahlenwert aus der Position eines Elements unter allen seinen Geschwisterelementen ab.

Version: CSS Modules

Syntax

width: calc(sibling-index() * 10px);

sibling-index() nimmt keine Argumente an und liefert eine ganze Zahl, beginnend bei 1 für das erste Kindelement eines Elternteils. Unterschiedliche Tag-Namen teilen dieselbe Zählung; Text und Kommentare belegen keine Positionen. Das ähnelt der Nummerierung von :nth-child(), liefert aber eine Zahl für eine Eigenschaftsberechnung, statt Elemente auszuwählen. Ziehe 1 ab, wenn ein bei null beginnender Versatz nötig ist, etwa für gestaffelte Verzögerungen.

Der Index folgt der DOM-Reihenfolge. Flex order, Grid-Platzierung oder eine Transformation können die sichtbare Position ändern, ohne neu zu nummerieren. Ein verborgenes Element behält seinen Platz in der Zählung. Dies ist also weder eine sichtbare Zeilennummer noch ein nth-of-type-Index. Das Umordnen tatsächlicher DOM-Knoten oder das Einfügen eines Elements vor dem Ziel ändert den Wert; die aktuelle Syntax hat keinen Selektorfilter.

Das Beispiel gibt drei Kindern mit unterschiedlichen Tag-Namen Breiten von 10px, 20px und 30px. Wird das dritte mit order: -1 visuell nach vorn verschoben, bleiben alle Breiten gleich. Ein vorn eingefügtes verborgenes b macht dasselbe Zielelement anschließend zum vierten; seine Breite wird 40px. Die Geometrieprüfung bestätigt die visuelle Verschiebung getrennt und zeigt den Unterschied zwischen Erscheinungsbild und DOM-Position.

Beispiele

const style=document.createElement('style');style.textContent='#index-stage>*{flex:none;width:calc(sibling-index() * 10px);height:10px}';document.head.append(style);
const parent=document.createElement('div');parent.id='index-stage';parent.style.display='flex';
parent.innerHTML='text<!-- comment --><div></div><span></span><i></i>';document.body.append(parent);
const children=[...parent.children],target=children[2];
const widths=()=>children.map(child=>getComputedStyle(child).width).join(',');
const initial=widths();target.style.order='-1';const reordered=widths();
const first=target.getBoundingClientRect().left<children[0].getBoundingClientRect().left;
const hidden=document.createElement('b');hidden.hidden=true;parent.prepend(hidden);
console.log('initial='+initial+'; reordered='+reordered+'; visually-first='+first+'; after-hidden-prefix='+getComputedStyle(target).width+'; supported='+CSS.supports('width','calc(sibling-index() * 10px)'));

Ergebnis

initial=10px,20px,30px; reordered=10px,20px,30px; visually-first=true; after-hidden-prefix=40px; supported=true

Ausgeführt in Chromium 157.0.8103.51. Setze diese Funktion aus dem Entwurf CSS Values Level 5 als progressive Verbesserung mit Fallback und @supports ein. Das Beispiel nutzt gewöhnliche DOM-Elemente, nicht die Auflösung in Schattenbäumen oder Pseudoelementen.

Quellen