Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / CSS

sibling-count(): contar elementos com o mesmo pai

Usa o número de elementos filhos diretos, incluindo o atual, num cálculo CSS.

Versão: CSS Modules

Sintaxe

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

sibling-count() não recebe argumentos e produz um inteiro. Para um elemento normal, conta todos os elementos filhos do mesmo pai, incluindo o próprio elemento. Não conta nós de texto, comentários nem descendentes mais profundos. O resultado é um número utilizável em calc(), ao contrário de counter(), que produz texto. A multiplicação por um comprimento fornece a unidade necessária para uma largura.

A contagem segue a árvore DOM, não a disposição visual. Um elemento oculto com display: none continua a ser contado; alterar a ordem flex não muda os membros do grupo. Não existe um argumento seletor para contar apenas os filhos correspondentes. Inserir ou remover um irmão altera o valor. Usa a função deliberadamente em disposições que dependam de todo o grupo, não apenas dos membros visíveis.

O exemplo começa com três elementos filhos diretos, um deles oculto, além de texto e de um comentário. Um b aninhado não é um quarto irmão. A largura do elemento observado é 30px, passa a 40px depois de acrescentar um em e regressa a 30px após remover o span oculto. Estas leituras da largura calculada verificam o recálculo depois de alterações ao DOM, não apenas o reconhecimento da sintaxe.

Exemplos

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

Resultado

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

Executado no Chromium 157.0.8103.51. Esta função do rascunho CSS Values Level 5 não garante suporte em todos os navegadores: fornece uma alternativa e verifica com @supports. Árvores de sombra e pseudoelementos têm restrições de âmbito adicionais, não testadas neste exemplo.

Fontes