Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / CSS

@counter-style — vlastní systém číslování

Pravidlo @counter-style definuje pojmenované zobrazení hodnot čítače pro list-style-type a funkce counter() nebo counters().

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

Syntaxe

@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> } vytváří pojmenovaný styl čítače. Deskriptor system volí algoritmus jako numeric, alphabetic, cyclic, fixed, symbolic, additive nebo extends. symbols dodává znaky většině systémů, additive-symbols dvojice váha-znak. Jde o deskriptory pravidla, ne běžné vlastnosti prvku.

Použitím jsou značky seznamu, čísla z counter() a hierarchické popisky z counters(). prefix a suffix obklopují výsledek, negative řeší záporné hodnoty, pad doplňuje krátký zápis, range omezuje hodnoty a fallback jmenuje náhradní styl.

Systém numeric potřebuje alespoň dva symboly a chápe je jako poziční číslice; "0" "1" proto vytváří binární zápis. Neplatná definice či hodnota mimo rozsah použije fallback. Příklad čte skutečný CSSCounterStyleRule, jeho deskriptory a vypočtené list-style-type seznamu.

Příklady

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

Výsledek

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

Pravidlo @counter-style definuje pojmenované zobrazení hodnot čítače pro list-style-type a funkce counter() nebo counters().

Zdroje