Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / CSS

@counter-style — sistema de numeración personalizado

La regla @counter-style define una representación con nombre para contadores, utilizable por list-style-type y por counter() o counters().

Versión: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required

Sintaxis

@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> } crea un estilo de contador con nombre. El descriptor system elige un algoritmo como numeric, alphabetic, cyclic, fixed, symbolic, additive o extends. symbols aporta signos para la mayoría de sistemas y additive-symbols pares peso-signo. Son descriptores de regla, no propiedades ordinarias de elementos.

Se usa en marcadores de lista, números generados con counter() y etiquetas jerárquicas de counters(). prefix y suffix rodean la representación, negative trata valores negativos, pad completa salidas cortas, range limita valores y fallback nombra un estilo alternativo.

Un sistema numeric necesita al menos dos símbolos y los interpreta como dígitos posicionales; "0" "1" produce notación binaria. Una definición inválida o un valor fuera del intervalo usa el fallback. El ejemplo lee el CSSCounterStyleRule real, sus descriptores y el list-style-type calculado de la lista.

Ejemplos

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

La regla @counter-style define una representación con nombre para contadores, utilizable por list-style-type y por counter() o counters().

Fuentes