Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.

View in English Always switch to English

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.

Le descripteur CSS additive-symbols de la règle @counter-style est utilisé pour spécifier les symboles du compteur lorsque la valeur du descripteur system de @counter-style est définie sur additive. Le système additif permet de construire des systèmes de numérotation à valeur de signe (sign-value numbering) comme les chiffres romains.

Syntaxe

css
/* Élément unique */
additive-symbols: 3 "*";

/* Liste d'éléments séparés par des virgules */
additive-symbols:
  3 "0",
  2 "\2E\20",
  1 url("symbol.png");

/* Compteur binaire */
additive-symbols:
  2 "1",
  1 "0";

/* Compteur étrusque (civilisation de l'Italie antique) */
additive-symbols:
  100 "𐌟",
  50 "𐌣",
  10 "𐌢",
  5 "𐌡",
  1 "𐌠";

Valeurs

Ce descripteur accepte une liste de tuples additifs (ensemble d'éléments) séparés par des virgules, chaque tuple étant composé des deux valeurs suivantes séparées par un espace :

<integer>

Un entier positif ou nul qui indique le poids entier associé au symbole du tuple.

<symbol>

Spécifie le symbole du compteur à utiliser pour la valeur de poids définie par l'entier associé du tuple.

Note : Les tuples additifs doivent être spécifiés dans l'ordre décroissant des poids ; sinon, la déclaration du descripteur n'est pas valide et sera ignorée.

Description

Le descripteur additive-symbols définit une liste de tuples additifs séparés par des virgules. Chaque tuple additif contient un entier positif ou nul et un symbole de compteur, séparés par un espace. Pour être valide, la liste doit être dans l'ordre décroissant des entiers. L'entier et le symbole sont concaténés pour former le symbole du compteur.

Lorsque la valeur du descripteur system est cyclic, numeric, alphabetic, symbolic ou fixed, utilisez le descripteur symbols() à la place de additive-symbols.

Définition formelle

En lien avec les règles @@counter-style
Valeur initialen/a (required)
Valeur calculéecomme spécifié

Syntaxe formelle

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

Exemples

Spécification des symboles additifs

HTML

Dans cet exemple, system: additive avec les valeurs du descripteur additive-symbols spécifie comment les nombres doivent être représentés en chiffres romains. La valeur de chaque élément <li> de la liste est convertie en chiffre romain selon les règles définies dans @counter-style.

html
<ul>
  <li>Un</li>
  <li>Deux</li>
  <li>Trois</li>
  <li>Quatre</li>
  <li>Cinq</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;
}

Résultat

Pour l'élément de liste ayant la valeur 109, le chiffre C représente 100 et IX représente 9. Cela génère le compteur CIX pour l'élément de liste 109. L'élément suivant reçoit automatiquement la valeur 110. Le chiffre romain CX est obtenu à partir de C pour 100 et X pour 10.

Spécifications

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

Compatibilité des navigateurs

Voir aussi