Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / CSS

sibling-index(): una posición en el DOM contada desde uno

Obtén un valor numérico a partir de la posición de un elemento entre todos sus elementos hermanos.

Versión: CSS Modules

Sintaxis

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

sibling-index() no recibe argumentos y devuelve un entero que empieza en 1 para el primer elemento hijo de un padre. Las distintas etiquetas comparten la misma numeración; el texto y los comentarios no ocupan posiciones. Se parece a la numeración de :nth-child(), pero produce un número para calcular una propiedad en vez de seleccionar elementos. Resta 1 si necesitas un desplazamiento contado desde cero, por ejemplo para retrasos escalonados.

El índice sigue el orden del DOM. El orden flex, la colocación grid o una transformación pueden cambiar la posición visual sin renumerar el elemento. Un elemento oculto sigue ocupando su posición. Por tanto, no es un número de fila visible ni un índice nth-of-type. Reordenar los nodos reales del DOM o insertar un elemento antes del objetivo cambia el valor; la sintaxis actual no admite un filtro selector.

El ejemplo asigna anchuras de 10px, 20px y 30px a tres hijos con etiquetas diferentes. Llevar visualmente el tercero al principio con order: -1 mantiene todas las anchuras. Añadir después un b oculto al principio convierte ese mismo objetivo en el cuarto elemento y su anchura en 40px. La comprobación geométrica confirma el movimiento visual por separado, mostrando por qué no deben confundirse apariencia y posición DOM.

Ejemplos

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

Resultado

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

Ejecutado en Chromium 157.0.8103.51. Trata esta función del borrador CSS Values Level 5 como una mejora progresiva con alternativa y @supports. El ejemplo usa elementos DOM normales, no la resolución en árboles de sombra ni pseudoelementos.

Fuentes