speak-as

Le descripteur speak-as, rattaché à la règle @ @counter-style, permet d'indiquer la représentation sonore du compteur qui doit être utilisée par l'agent utilisateur si nécessaire. Ainsi, on peut utiliser ce descripteur pour que le compteur soit énoncé comme un nombre ou avec un signal audio particulier.

Ce descripteur pourra prendre les valeurs auto, bullets, numbers, words, spell-out ou alors pourra pointer vers un autre style de compteur avec le nom de ce style.

Syntaxe

css
/* Valeurs avec un mot-clé */
speak-as: auto;
speak-as: bullets;
speak-as: numbers;
speak-as: words;
speak-as: spell-out;

/* Nom d'un autre style @counter-style */
speak-as: <counter-style-name>;

Valeurs

auto

Dans ce cas, la valeur réelle de speak-as sera définie selon la valeur utilisée pour le descripteur system :

  • Si system vaut alphabetic, speak-as sera alors synonyme de spell-out.
  • Si system vaut cyclic, speak-as sera alors synonyme de bullets.
  • Si system vaut extends, la valeur de speak-as sera la même que celle correspondante à auto dans le style étendu.
  • Dans les autres cas, le comportement de numbers sera utilisé.
bullets

Un morceau ou un signal sonore utilisé par l'agent utilisateur et qui représente la façon d'énoncer une liste non-ordonnée.

numbers

La valeur numérique du compteur sera énoncée dans la langue du document.

words

L'agent utilisateur génèrera une représentation normale du compteur et la lira comme un mot, dans la langue du document.

spell-out

L'agent utilisateur génèrera une représentation normale du compteur et l'énoncera en l'épelant. Si l'agent utilisateur ne sait pas comment prononcer une valeur du compteur, il la prononcera comme avec la valeur numbers.

<counter-style-name>

Si la valeur du descripteur est le nom d'un autre style de compteur, ce sera la valeur de speak-as de ce style qui sera utilisée. Si la style visé n'existe pas, cette valeur sera alors synonyme de auto.

Définition formelle

En lien avec les règles @@counter-style
Valeur initialeauto
Valeur calculéecomme spécifié

Syntaxe formelle

speak-as = 
  auto                  |
  bullets               |
  numbers               |
  words                 |
  spell-out             |
  <counter-style-name>

Exemples

CSS

css
@counter-style speak-as-exemple {
  system: fixed;
  symbols:     ;
  suffix: " ";
  speak-as: numbers;
}

.exemple {
  list-style: speak-as-exemple;
}

HTML

html
<ul class="exemple">
  <li>Un</li>
  <li>Deux</li>
  <li>Trois</li>
  <li>Quatre</li>
  <li>Cinq</li>
</ul>

Résultat

Accessibilité

La prise en charge de cette fonctionnalité par les outils d'assistance est actuellement très restreinte. Veillez à ne pas reposer sur cette propriété si vous souhaitez transmettre des informations majeures quant au but de la page.

Spécifications

Specification
CSS Counter Styles Level 3
# counter-style-speak-as

Compatibilité des navigateurs

BCD tables only load in the browser

Voir aussi