CKTIS / CSS
@counter-style — własny system numeracji
Reguła @counter-style definiuje nazwany sposób przedstawiania wartości licznika, używany przez list-style-type albo funkcje counter() i counters().
Wersja: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required
Składnia
@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> } tworzy nazwany styl licznika. Deskryptor system wybiera algorytm, na przykład numeric, alphabetic, cyclic, fixed, symbolic, additive albo extends. symbols dostarcza znaki dla większości systemów, a additive-symbols pary wag i symboli dla systemu addytywnego. To deskryptory reguły, nie zwykłe właściwości elementu.
Do zastosowań należą markery list, numeracja nagłówków przez counter() i wielopoziomowe oznaczenia przez counters(). prefix i suffix otaczają reprezentację, negative opisuje liczby ujemne, pad uzupełnia krótki zapis, range ogranicza obsługiwane wartości, a fallback wskazuje inny styl, gdy system nie potrafi przedstawić liczby.
System numeric wymaga co najmniej dwóch symboli i interpretuje je jak cyfry pozycyjnego systemu liczbowego; kolejność "0" "1" tworzy zapis binarny. Niepoprawna definicja lub wartość poza zakresem przechodzi do fallbacku. Przykład odczytuje rzeczywisty CSSCounterStyleRule, jego deskryptory i obliczone list-style-type, potwierdzając połączenie definicji z listą.
Przykłady
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);Wynik
rule=CSSCounterStyleRule; system=numeric; symbols="0" "1"; used=binary
Reguła @counter-style definiuje nazwany sposób przedstawiania wartości licznika, używany przez list-style-type albo funkcje counter() i counters().