Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / CSS

sibling-index(): posizione nel DOM contata da uno

Ricava un valore numerico dalla posizione di un elemento fra tutti i suoi elementi fratelli.

Versione: CSS Modules

Sintassi

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

sibling-index() non accetta argomenti e restituisce un intero che parte da 1 per il primo elemento figlio di un genitore. Nomi di tag diversi condividono la stessa numerazione; testo e commenti non occupano posizioni. Somiglia alla numerazione di :nth-child(), ma produce un numero per il calcolo di una proprietà anziché selezionare elementi. Sottrai 1 quando serve uno scostamento che parta da zero, per esempio per ritardi scaglionati.

L’indice segue l’ordine del DOM. L’ordine flex, il posizionamento grid o una trasformazione possono cambiare la posizione visiva senza rinumerare l’elemento. Un elemento nascosto continua a occupare la propria posizione. Non è quindi un numero di riga visibile né un indice nth-of-type. Riordinare i nodi effettivi del DOM o inserire un elemento prima del bersaglio cambia il valore; la sintassi attuale non ha un filtro selettore.

L’esempio assegna a tre figli con tag diversi larghezze di 10px, 20px e 30px. Portare visivamente il terzo all’inizio con order: -1 lascia invariate tutte le larghezze. Inserire poi un b nascosto all’inizio rende lo stesso elemento il quarto e porta la sua larghezza a 40px. Il controllo geometrico conferma separatamente lo spostamento visivo, mostrando perché aspetto e posizione DOM non vanno confusi.

Esempi

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

Risultato

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

Eseguito in Chromium 157.0.8103.51. Usa questa funzione della bozza CSS Values Level 5 come miglioramento progressivo con un’alternativa e @supports. L’esempio riguarda elementi DOM ordinari, non la risoluzione in alberi shadow o pseudo-elementi.

Fonti