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

CKTIS / CSS

counter() — valor de um contador

`counter()` converte o valor mais interno de um contador CSS nomeado em texto ou imagem segundo o estilo de contador escolhido.

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

Sintaxe

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

counter() converte o valor mais interno de um contador CSS nomeado em texto ou imagem segundo o estilo de contador escolhido.

O exemplo apresenta counter(step) como 7 e counter(step, decimal-leading-zero) como 07; a largura dupla do segundo pseudoelemento prova que o zero inicial está no conteúdo efetivamente gerado.

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

O segundo argumento é opcional e assume decimal. A função lê o contador mais próximo com esse nome, não todos os âmbitos em conjunto, e o nome não pode ser none. Se não existir, o navegador cria-o com 0. Use-a em conteúdo gerado ou marcadores com reposições e incrementos deliberados.

Exemplos

const style = document.createElement('style');
style.textContent = '.plain,.padded{display:inline-block;font:20px monospace}.plain{counter-reset:step 7}.padded{counter-reset:step 7}.plain::before{content:counter(step)}.padded::before{content:counter(step, decimal-leading-zero)}';
const plain = document.createElement('span'); plain.className = 'plain';
const padded = document.createElement('span'); padded.className = 'padded';
document.head.append(style); document.body.append(plain, padded);
const one = plain.getBoundingClientRect().width;
const two = padded.getBoundingClientRect().width;
console.log('decimal-glyphs=' + Math.round(one / (one || 1)) + '; leading-zero-glyphs=' + Math.round(two / (one || 1)) + '; width-ratio=' + (two / one).toFixed(2));

Resultado

decimal-glyphs=1; leading-zero-glyphs=2; width-ratio=2.00

`counter()` converte o valor mais interno de um contador CSS nomeado em texto ou imagem segundo o estilo de contador escolhido.

Fontes