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

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

• 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é.

auto

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

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.

Syntaxe formelle

auto | bullets | numbers | words | spell-out | <counter-style-name>
où 
<counter-style-name> = <custom-ident>

Exemples

CSS

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


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

HTML

<ul class="exemple">
  <li>One</li>
  <li>Two</li>
  <li>Three</li>
  <li>Four</li>
  <li>Five</li>
</ul>

Résultat

Spécifications

Compatibilité des navigateurs

Voir aussi

• list-style,
• list-style-image,
• list-style-position,
• symbols() : la notation fonctionnelle qui permet de créer des styles de compteur anonymes.