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

CKTIS / CSS

sibling-index() : une position DOM numérotée à partir de un

Déduisez une valeur numérique de la position d’un élément parmi tous ses éléments frères.

Version : CSS Modules

Syntaxe

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

sibling-index() ne prend aucun argument et renvoie un entier commençant à 1 pour le premier élément enfant d’un parent. Les différents noms de balises partagent la même numérotation ; le texte et les commentaires n’occupent aucune position. Cela ressemble à :nth-child(), mais produit un nombre pour le calcul d’une propriété au lieu de sélectionner des éléments. Soustrayez 1 pour un décalage commençant à zéro, par exemple pour des délais échelonnés.

L’indice suit l’ordre du DOM. L’ordre flex, le placement grid ou une transformation peuvent déplacer visuellement un élément sans changer son numéro. Un élément masqué conserve sa position. Ce n’est donc ni un numéro de ligne visible ni un indice nth-of-type. Réordonner les véritables nœuds DOM ou insérer un élément avant la cible change la valeur ; la syntaxe actuelle ne propose aucun filtre sélecteur.

L’exemple donne à trois enfants de noms différents des largeurs de 10px, 20px et 30px. Placer visuellement le troisième en tête avec order: -1 ne change aucune largeur. Ajouter ensuite un b masqué au début fait de cette même cible le quatrième élément et porte sa largeur à 40px. La vérification géométrique confirme séparément le déplacement visuel, montrant pourquoi il faut distinguer apparence et position DOM.

Exemples

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

Résultat

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

Exécuté dans Chromium 157.0.8103.51. Utilisez cette fonction du brouillon CSS Values Level 5 comme amélioration progressive avec une solution de repli et @supports. L’exemple traite des éléments DOM ordinaires, pas de la résolution dans les arbres fantômes ou les pseudo-éléments.

Sources