Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / CSS

@counter-style — sistema di numerazione personalizzato

La regola @counter-style definisce una rappresentazione con nome per i contatori, usata da list-style-type e dalle funzioni counter() o counters().

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

Sintassi

@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 uno stile di contatore con nome. Il descrittore system sceglie un algoritmo come numeric, alphabetic, cyclic, fixed, symbolic, additive o extends. symbols fornisce i segni per molti sistemi e additive-symbols coppie peso-simbolo. Sono descrittori della regola, non normali proprietà degli elementi.

Gli usi includono marcatori di elenco, numeri prodotti da counter() ed etichette gerarchiche con counters(). prefix e suffix circondano il risultato, negative tratta valori negativi, pad completa risultati brevi, range limita i valori e fallback indica uno stile alternativo.

Un sistema numeric richiede almeno due simboli e li tratta come cifre posizionali; "0" "1" genera quindi notazione binaria. Una definizione non valida o un valore fuori intervallo usa il fallback. L’esempio legge il vero CSSCounterStyleRule, i descrittori e il list-style-type calcolato dell’elenco.

Esempi

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);

Risultato

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

La regola @counter-style definisce una rappresentazione con nome per i contatori, usata da list-style-type e dalle funzioni counter() o counters().

Fonti