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

CKTIS / CSS

@counter-style — sistema de numeração personalizado

A regra @counter-style define uma representação nomeada de contadores, usada por list-style-type e pelas funções counter() ou counters().

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

Sintaxe

@counter-style <counter-style-name> {
  [ system: <counter-system>; ] ||
  [ symbols: <counter-symbols>; ] ||
  [ additive-symbols: <additive-symbols>; ] ||
  [ negative: <negative-symbol>; ] ||
  [ prefix: <prefix>; ] ||
  [ suffix: <suffix>; ] ||
  [ range: <range>; ] ||
  [ pad: <padding>; ] ||
  [ speak-as: <speak-as>; ] ||
  [ fallback: <counter-style-name>; ]
}

@counter-style <counter-style-name> { <declaration-list> } cria um estilo de contador nomeado. O descritor system escolhe um algoritmo como numeric, alphabetic, cyclic, fixed, symbolic, additive ou extends. symbols fornece sinais para a maioria dos sistemas e additive-symbols pares peso-símbolo. São descritores da regra, não propriedades normais de elementos.

Usa-se em marcadores de listas, números produzidos por counter() e rótulos hierárquicos de counters(). prefix e suffix rodeiam a representação, negative trata valores negativos, pad completa saídas curtas, range limita valores e fallback identifica um estilo alternativo.

Um sistema numeric requer pelo menos dois símbolos e trata-os como algarismos posicionais; "0" "1" cria notação binária. Uma definição inválida ou valor fora do intervalo usa o fallback. O exemplo lê o verdadeiro CSSCounterStyleRule, os seus descritores e o list-style-type calculado da lista.

Exemplos

const style = document.createElement('style');
style.textContent = `@counter-style binary { system: numeric; symbols: "0" "1"; suffix: ". "; fallback: decimal; }
ol { list-style-type: binary; }`;
document.head.append(style);
const list = document.createElement('ol');
list.innerHTML = '<li>one</li><li>two</li><li>three</li>';
document.body.append(list);
const rule = style.sheet.cssRules[0];
console.log('rule=' + rule.constructor.name + '; system=' + rule.system + '; symbols=' + rule.symbols + '; used=' + getComputedStyle(list).listStyleType);

Resultado

rule=CSSCounterStyleRule; system=numeric; symbols="0" "1"; used=binary

A regra @counter-style define uma representação nomeada de contadores, usada por list-style-type e pelas funções counter() ou counters().

Fontes