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

CKTIS / CSS

counters() — caminho de contadores aninhados

`counters()` formata todos os contadores com o mesmo nome, do mais exterior ao mais interior, e junta as representações com o separador indicado.

Versão: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required

Sintaxe

counters( <counter-name>, <string>, <counter-style>? )

counters() formata todos os contadores com o mesmo nome, do mais exterior ao mais interior, e junta as representações com o separador indicado.

O exemplo cria o valor exterior 2 e o interior 4. counters(section, ".") desenha três glifos correspondentes a 2.4, enquanto counter(section) mostra apenas o valor interior 4; as larguras medidas confirmam a hierarquia.

Gramática: counters( <counter-name>, <string>, <counter-style>? ).

O separador é uma cadeia obrigatória e o estilo opcional assume decimal. A ordem é sempre do exterior para o interior, adequada a números de secção. Um contador ausente é criado com 0; um counter-reset acidental num descendente acrescenta um nível e pode alongar inesperadamente o caminho.

Exemplos

const style = document.createElement('style');
style.textContent = '.outer{counter-reset:section 2}.inner{counter-reset:section 4}.path,.leaf{display:inline-block;font:20px monospace}.path::before{content:counters(section, ".")}.leaf::before{content:counter(section)}';
const outer = document.createElement('div'); outer.className = 'outer';
const inner = document.createElement('div'); inner.className = 'inner';
const path = document.createElement('span'); path.className = 'path';
const leaf = document.createElement('span'); leaf.className = 'leaf';
document.head.append(style); inner.append(path, leaf); outer.append(inner); document.body.append(outer);
const pathWidth = path.getBoundingClientRect().width;
const leafWidth = leaf.getBoundingClientRect().width;
console.log('path-glyphs=' + Math.round(pathWidth / leafWidth) + '; leaf-glyphs=1; width-ratio=' + (pathWidth / leafWidth).toFixed(2));

Resultado

path-glyphs=3; leaf-glyphs=1; width-ratio=3.00

`counters()` formata todos os contadores com o mesmo nome, do mais exterior ao mais interior, e junta as representações com o separador indicado.

Fontes