WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / CSS

sibling-count(): Elemente mit demselben Elternteil zählen

Verwende die Anzahl der direkten Kindelemente einschließlich des aktuellen Elements in einer CSS-Berechnung.

Version: CSS Modules

Syntax

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

sibling-count() nimmt keine Argumente an und ergibt eine ganze Zahl. Bei einem gewöhnlichen Element zählt die Funktion alle Kindelemente desselben Elternteils einschließlich des Elements selbst. Textknoten, Kommentare und tiefere Nachfahren zählen nicht mit. Das Ergebnis ist eine für calc() verwendbare Zahl, anders als counter(), das Text liefert. Die Multiplikation mit einer Länge ergänzt die für eine Breite benötigte Einheit.

Gezählt wird anhand des DOM-Baums, nicht der visuellen Anordnung. Ein mit display: none verborgenes Element zählt weiterhin; eine Änderung der Flex-Reihenfolge verändert die Gruppenzugehörigkeit nicht. Ein Selektorargument zum Zählen nur passender Kinder gibt es nicht. Das Einfügen oder Entfernen eines Geschwisterelements ändert den Wert. Verwende die Funktion deshalb bewusst für Layouts, die von der gesamten Gruppe statt nur von sichtbaren Mitgliedern abhängen.

Das Beispiel beginnt mit drei direkten Kindelementen, darunter einem verborgenen, sowie Text und einem Kommentar. Ein verschachteltes b ist kein viertes Geschwisterelement. Die Zielbreite beträgt 30px, steigt nach dem Anhängen eines em auf 40px und fällt nach dem Entfernen des verborgenen span auf 30px zurück. Diese Abfragen der berechneten Breite prüfen die Neuberechnung nach DOM-Änderungen und nicht nur die Erkennung der Syntax.

Beispiele

const parent=document.createElement('div');
parent.innerHTML='text<!-- comment --><div id="target"><b>nested</b></div><span hidden></span><i></i>';
document.body.append(parent);
const target=parent.querySelector('#target');target.style.width='calc(sibling-count() * 10px)';
const width=()=>getComputedStyle(target).width;
const initial=width();parent.append(document.createElement('em'));const added=width();
parent.querySelector('[hidden]').remove();
console.log('initial='+initial+'; added='+added+'; removed-hidden='+width()+'; children='+parent.children.length+'; supported='+CSS.supports('width','calc(sibling-count() * 10px)'));

Ergebnis

initial=30px; added=40px; removed-hidden=30px; children=3; supported=true

Ausgeführt in Chromium 157.0.8103.51. Diese Funktion aus dem Entwurf CSS Values Level 5 garantiert keine Unterstützung in jedem Browser: Fallback vorsehen und mit @supports prüfen. Schattenbäume und Pseudoelemente unterliegen zusätzlichen Geltungsbereichsregeln und werden hier nicht getestet.

Quellen