additive-symbols

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 additive-symbols Deskriptor der @counter-style at-Regel wird verwendet, um Zählersymbole anzugeben, wenn der Wert des @counter-style system Deskriptors auf additive gesetzt ist. Das additive System wird verwendet, um Sign-Value-Nummerierungssysteme wie römische Zahlen zu konstruieren.

Syntax

css
/* Single tuple */
additive-symbols: 3 "*";

/* Comma-separated list of tuples */
additive-symbols:
  3 "0",
  2 "\2E\20",
  1 url(symbol.png);

/* Binary counter */
additive-symbols:
  2 "1",
  1 "0";

/* Etruscan (a civilization in ancient Italy) counter  */
additive-symbols:
  100 "𐌟",
  50 "𐌣",
  10 "𐌢",
  5 "𐌡",
  1 "𐌠";

Werte

Der Deskriptor akzeptiert eine kommagetrennte Liste von additiven Tupeln, wobei jedes Tupel aus den folgenden zwei Werten besteht, die durch ein Leerzeichen getrennt sind:

<integer>

Ein nicht-negativer Ganzzahlwert, der das Gewicht des zugehörigen Symbolwerts des Tupels angibt.

<symbol>

Gibt das Zählersymbol an, das für den durch den zugehörigen <integer> Gewichtswert des Tupels definierten Gewichts verwendet werden soll.

Hinweis: Die additiven Tupel müssen in absteigender Gewichtsreihenfolge angegeben werden; andernfalls ist die Deskriptor-Deklaration nicht gültig und wird ignoriert.

Beschreibung

Der additive-symbols Deskriptor definiert eine kommagetrennte Liste von additiven Tupeln. Jedes additive Tupel enthält eine durch Leerzeichen getrennte nicht-negative ganze Zahl und ein Zählersymbol. Um gültig zu sein, muss die Liste in absteigender Reihenfolge der Zahlen stehen. Die ganze Zahl und das Symbol werden zusammengefügt, um das Zählersymbol zu bilden.

Wenn der Wert des system Deskriptors cyclic, numeric, alphabetic, symbolic oder fixed ist, verwenden Sie den symbols() Deskriptor anstelle von additive-symbols.

Formale Definition

Zugehörige @-Regel@counter-style
Anfangswertn/a (required)
Berechneter Wertwie angegeben

Formale Syntax

additive-symbols = 
  [ <integer [0,∞]> && <symbol> ]#  

<symbol> = 
  <string>        |
  <image>         |
  <custom-ident>  

<image> = 
  <url>       |
  <gradient>  

<url> = 
  <url()>  |
  <src()>  

<url()> = 
  url( <string> <url-modifier>* )  |
  <url-token>                      

<src()> = 
  src( <string> <url-modifier>* )

Beispiele

Additive Symbole angeben

HTML

In diesem Beispiel geben system: additive zusammen mit den additive-symbols Deskriptorwerten an, wie Zahlen als römische Ziffern dargestellt werden sollen. Der Wert jedes <li> Elements in der Liste wird gemäß den in @counter-style definierten Regeln in eine römische Zahl umgewandelt.

html
<ul>
  <li>One</li>
  <li>Two</li>
  <li>Three</li>
  <li>Four</li>
  <li>Five</li>
  <li value="109">109</li>
  <li>110</li>
</ul>

CSS

css
@counter-style uppercase-roman {
  system: additive;
  additive-symbols:
    1000 M,
    900 CM,
    500 D,
    400 CD,
    100 C,
    90 XC,
    50 L,
    40 XL,
    10 X,
    9 IX,
    5 V,
    4 IV,
    1 I;
}

ul {
  list-style: uppercase-roman;
  padding-left: 5em;
}

Ergebnis

Für das Listenelement mit dem Wert 109 steht die Zahl C für 100 und IX für 9. Dies erzeugt das CIX-Zähler für das Listenelement 109. Das nächste Listenelement erhält automatisch einen Wert von 110. Die römische Zahl CX wird aus C für 100 und X für 10 abgeleitet.

Spezifikationen

Specification
CSS Counter Styles Level 3
# counter-style-symbols

Browser-Kompatibilität

Siehe auch