Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / CSS

sibling-count() : compter les éléments ayant le même parent

Utilisez le nombre d’éléments enfants directs, élément courant compris, dans un calcul CSS.

Version : CSS Modules

Syntaxe

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

sibling-count() ne prend aucun argument et produit un entier. Pour un élément ordinaire, la fonction compte tous les éléments enfants du même parent, y compris l’élément lui-même. Les nœuds texte, les commentaires et les descendants plus profonds ne comptent pas. Le résultat est un nombre utilisable dans calc(), contrairement à counter(), qui produit du texte. Le multiplier par une longueur fournit l’unité nécessaire à une largeur.

Le comptage suit l’arbre DOM, pas la disposition visuelle. Un élément masqué par display: none reste compté ; modifier l’ordre flex ne change pas les membres du groupe. Aucun argument sélecteur ne permet de limiter le comptage aux enfants correspondants. Insérer ou supprimer un élément frère change la valeur. Réservez donc cet usage aux mises en page dépendant du groupe entier, et pas seulement de ses membres visibles.

L’exemple commence avec trois éléments enfants directs, dont un masqué, ainsi que du texte et un commentaire. Le b imbriqué n’est pas un quatrième frère. La largeur cible vaut 30px, passe à 40px après l’ajout d’un em, puis revient à 30px après la suppression du span masqué. Ces lectures de largeur calculée vérifient le recalcul après modification du DOM, et pas seulement la reconnaissance de la syntaxe.

Exemples

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)'));

Résultat

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

Exécuté dans Chromium 157.0.8103.51. Cette fonction du brouillon CSS Values Level 5 ne garantit pas une prise en charge universelle : prévoyez une solution de repli et @supports. Les arbres fantômes et les pseudo-éléments ont des contraintes de portée supplémentaires, hors de cet exemple.

Sources