range
Baseline
2023
Newly available
Since September 2023, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.
Der range Deskriptor ermöglicht es dem Autor, einen oder mehrere Bereiche von Zählerwerten anzugeben, für die der Stil angewendet wird, wenn benutzerdefinierte Zählerstile mit dem @counter-style At-Regel definiert werden. Wenn der range Deskriptor enthalten ist, wird der definierte Zähler nur für Werte innerhalb der festgelegten Bereiche verwendet. Liegt der Zählerwert außerhalb des angegebenen Bereichs, wird der Fallback-Stil verwendet, um die Darstellung des Markers zu konstruieren.
Syntax
/* Keyword value */
range: auto;
/* Range values */
range: 2 5;
range: infinite 10;
range: 6 infinite;
range: infinite infinite;
/* Multiple range values */
range:
2 5,
8 10;
range:
infinite 6,
10 infinite;
Werte
Der Wert ist eine durch Kommas getrennte Liste von Bereichen, die jeweils ein unteres und ein oberes Limit oder das Schlüsselwort auto enthalten.
auto-
Die gesamte Menge der durch den Zähler darstellbaren Zahlen
system. Diese Bereichswerte hängen vom Zählsystem ab:- Für
cyclic,numericundfixedSysteme reicht der Bereich von negativerUnendlichkeitbis positiverUnendlichkeit. - Für
alphabeticundsymbolicSysteme reicht der Bereich von1bis positiveUnendlichkeit. - Für
additiveSysteme reicht der Bereich von0bis positiveUnendlichkeit. - Bei der Verwendung von
extend, um ein System zu erweitern, ist der Bereich das, wasautofür das erweiterte System erzeugen würde, einschließlich Erweiterungen komplexer vordefinierter Stile, wie einige japanische, koreanische, chinesische und äthiopische Zählerstile.
- Für
[ [ <integer> | infinite ]{2} ]#-
Jeder Bereich in der durch Kommas getrennten Liste von Bereichen umfasst zwei Werte, die entweder ein
<integer>oder das Schlüsselwortinfinitesind. Wenninfiniteals erster Wert in einem Bereich verwendet wird, steht es für negative Unendlichkeit; wenn es als zweiter Wert verwendet wird, steht es für positive Unendlichkeit. Der erste Wert jedes Bereichs ist die untere Grenze für den Bereich und der zweite Wert ist die obere Grenze, inklusive. Wenn die untere Grenze eines Bereichs in der Liste höher ist als die obere Grenze, ist der gesamterangeDeskriptor ungültig und wird ignoriert.
Beschreibung
Der Wert des range Deskriptors kann entweder auto oder eine durch Kommas getrennte Liste von unteren und oberen Grenzbereichen sein, die mit negativen oder positiven Ganzzahlen oder dem Schlüsselwort infinite angegeben werden.
Verständnis von auto
Wenn der Wert auf auto eingestellt ist, ist der Bereich der Standardbereich für das Zählsystem. Ist das system cyclic, numeric oder fixed, reicht der Bereich von negativer Unendlichkeit bis positiver Unendlichkeit. Ist das system alphabetic oder symbolic, reicht der Bereich von 1 bis positive Unendlichkeit. Für system: additive ergibt auto den Bereich von 0 bis positive Unendlichkeit.
Wenn ein Zähler erweitert wird, wird bei eingestelltem range: auto der Bereichswert der Bereich des system des erweiterten Zählers, nicht der range Wert, falls vorhanden, dieses Zählers. Wenn zum Beispiel der Zähler "B" das system: extends A hat, wobei der Zähler ein alphabetic Zähler ist, setzt range: auto auf "B" den Bereich von "B" von 1 bis Unendlichkeit. Dies ist der Bereich des alphabetic Systems, nicht unbedingt der Bereich, der in der "A" Zählerstildefinition festgelegt ist. Mit range: auto auf "B" wird der range auf den Standardbereich des alphabetic Systems gesetzt, nicht auf den range Wert, der in der Deskriptorliste des Zählers A festgelegt wurde.
Erklärung von infinite
Wenn der Bereich als Ganzzahlen angegeben wird (im Gegensatz zu auto), kann der Wert infinite verwendet werden, um Unendlichkeit darzustellen. Wenn infinite als erster Wert in einem Bereich angegeben wird, wird es als negative Unendlichkeit interpretiert. Wenn es als obere Grenze verwendet wird, also als zweiter Wert im Bereichspaar, wird es als positive Unendlichkeit betrachtet.
Liste der Bereiche
Der Wert von range ist entweder auto, wie oben besprochen, oder eine durch Kommas getrennte Liste von einem oder mehreren Bereichen. Der Bereich des Zählerstils ist die Vereinigung aller in der Liste definierten Bereiche.
Jeder Bereich in der Bereichsliste nimmt zwei Werte an. Diese Werte sind entweder ein <integer> oder das Schlüsselwort infinite. Der erste Wert ist die untere Grenze, inklusive. Der zweite Wert ist die obere Grenze, inklusive. Bei zwei Ganzzahlenwerten muss der niedrigere Wert zuerst kommen. Wenn die untere Grenze eines Bereichs in der Liste höher ist als die obere Grenze, ist der gesamte range Deskriptor ungültig und wird ignoriert. Das Schlüsselwort infinite macht den Bereich nicht ungültig, da die Position von infinite seinen Wert bestimmt; entweder negative oder positive Unendlichkeit, abhängig davon, ob es die untere oder obere Grenze ist.
Formale Definition
| Zugehörige @-Regel | @counter-style |
|---|---|
| Anfangswert | auto |
| Berechneter Wert | wie angegeben |
Formale Syntax
range =
[ [ <integer> | infinite ]{2} ]# |
auto
Beispiele
>Zählerstil über einen Bereich einstellen
HTML
<ul class="list">
<li>One</li>
<li>Two</li>
<li>Three</li>
<li>Four</li>
<li>Five</li>
<li>Six</li>
<li>Seven</li>
<li>Eight</li>
<li>Nine</li>
<li>Ten</li>
</ul>
CSS
@counter-style range-multi-example {
system: cyclic;
symbols: "\25A0" "\25A1";
range:
2 4,
7 9;
}
.list {
list-style: range-multi-example;
}
Ergebnis
Der erste Bereich in der Liste der Bereiche umfasst 2, 3 und 4. Der zweite umfasst 7, 8 und 9. Der Bereich ist die Vereinigung dieser beiden Bereiche, also 2, 3, 4, 7, 8 und 9.
Spezifikationen
| Specification |
|---|
| CSS Counter Styles Level 3> # counter-style-range> |
Browser-Kompatibilität
Siehe auch
- Andere
@counter-styleDeskriptoren:system,symbols,additive-symbols,negative,prefix,suffix,pad,speak-as, undfallback list-style,list-style-image,list-style-positionsymbols(): die funktionale Notation zur Erstellung anonymer Zählerstile.- CSS Zählerstile Modul
- CSS Listen und Zähler Modul