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().