CKTIS / CSS
sibling-index(): posição no DOM contada a partir de um
Obtém um valor numérico a partir da posição de um elemento entre todos os seus elementos irmãos.
Versão: CSS Modules
Sintaxe
width: calc(sibling-index() * 10px);sibling-index() não recebe argumentos e devolve um inteiro que começa em 1 para o primeiro elemento filho de um pai. Nomes de etiquetas diferentes partilham a mesma sequência; texto e comentários não ocupam posições. Assemelha-se à numeração de :nth-child(), mas produz um número para calcular uma propriedade em vez de selecionar elementos. Subtrai 1 quando precisas de um desfasamento contado a partir de zero, por exemplo para atrasos escalonados.
O índice segue a ordem do DOM. A ordem flex, a colocação grid ou uma transformação podem alterar a posição visual sem renumerar o elemento. Um elemento oculto continua a ocupar a sua posição. Por isso, não é um número de linha visível nem um índice nth-of-type. Reordenar os nós reais do DOM ou inserir um elemento antes do alvo altera o valor; a sintaxe atual não tem filtro de seletor.
O exemplo atribui larguras de 10px, 20px e 30px a três filhos com etiquetas diferentes. Deslocar visualmente o terceiro para o início com order: -1 mantém todas as larguras. Acrescentar depois um b oculto no início torna esse mesmo alvo o quarto elemento e aumenta a largura para 40px. A verificação geométrica confirma separadamente a deslocação visual, mostrando por que não se deve confundir aparência com posição no DOM.
Exemplos
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
Executado no Chromium 157.0.8103.51. Usa esta função do rascunho CSS Values Level 5 como melhoria progressiva, com alternativa e @supports. O exemplo usa elementos DOM normais, não a resolução em árvores de sombra ou pseudoelementos.