CKTIS / CSS
@counter-style — eigenes Nummerierungssystem
Die Regel @counter-style definiert eine benannte Darstellung für Zählerwerte, die list-style-type sowie counter() und counters() verwenden können.
Version: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required
Syntax
@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> } erzeugt einen benannten Zählerstil. Der Deskriptor system wählt einen Algorithmus wie numeric, alphabetic, cyclic, fixed, symbolic, additive oder extends. symbols liefert Zeichen für die meisten Systeme; additive-symbols enthält Gewichts-Zeichen-Paare. Es sind Regeldeskriptoren, keine normalen Elementeigenschaften.
Anwendungen sind Listenmarker, mit counter() erzeugte Überschriftennummern und hierarchische Bezeichnungen durch counters(). prefix und suffix umgeben die Darstellung, negative behandelt negative Werte, pad ergänzt kurze Ausgaben, range begrenzt Werte und fallback benennt einen Ersatzstil.
Ein numeric-System benötigt mindestens zwei Symbole und nutzt sie als Ziffern eines Stellenwertsystems; "0" "1" ergibt daher Binärdarstellung. Eine ungültige Definition oder ein Wert außerhalb des Bereichs verwendet den Fallback. Das Beispiel liest die echte CSSCounterStyleRule, ihre Deskriptoren und das berechnete list-style-type der Liste.
Beispiele
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);Ergebnis
rule=CSSCounterStyleRule; system=numeric; symbols="0" "1"; used=binary
Die Regel @counter-style definiert eine benannte Darstellung für Zählerwerte, die list-style-type sowie counter() und counters() verwenden können.