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

speak-as

Disponibilité limitée

Cette fonctionnalité n'est pas Compatible car elle ne fonctionne pas dans certains des navigateurs les plus utilisés.

Expérimental: Il s'agit d'une technologie expérimentale.
Vérifiez attentivement le tableau de compatibilité des navigateurs avant de l'utiliser en production.

La propriété CSS speak-as est utilisée pour définir comment le contenu HTML est prononcé. Les un à trois termes clés énumérés déterminent la manière dont les éléments et le texte sont rendus par les technologies auditives, telles que les lecteurs d'écran et les assistants numériques.

Cette propriété s'applique à tout le contenu, y compris les pseudo-éléments, à l'exception des pseudo-éléments ::marker construits par un @counter-style avec un descripteur speak-as défini, qui prend le pas sur toute valeur héritée de la propriété speak-as.

Syntaxe

css
/* syntaxe à valeur unique */
speak-as: normal;
speak-as: spell-out;
speak-as: literal-punctuation;
speak-as: digits;
speak-as: no-punctuation;

/* syntaxe à valeurs multiples */
speak-as: spell-out literal-punctuation;
speak-as: spell-out no-punctuation;
speak-as: digits literal-punctuation;
speak-as: digits no-punctuation;
speak-as: spell-out digits literal-punctuation;
speak-as: spell-out digits no-punctuation;

Valeurs

normal

Règles de prononciation normales avec la ponctuation remplacée par des pauses. Par exemple, « Bonjour, le monde ! » serait prononcé comme « Bonjour (pause) le monde (pause) ». C'est la valeur par défaut.

spell-out

Le contenu est épelé lettre par lettre. Par exemple, « rôle » serait prononcé comme « r » « o » « l » « e ».

literal-punctuation

Les signes de ponctuation sont prononcés littéralement. Par exemple, « Bonjour, le monde ! » serait prononcé comme « Bonjour virgule le monde point d'exclamation ».

digits

Les nombres sont prononcés chiffre par chiffre. Par exemple, « 31 » serait prononcé comme « trois un ».

no-punctuation

Le contenu est prononcé normalement sans aucune ponctuation. Par exemple, « Bonjour, le monde ! » serait prononcé comme « Bonjour » « le monde ».

Note : Le support de la propriété speak-as est limité et implémenté de manière incohérente dans différentes technologies d'assistance, telles que les lecteurs d'écran ou les synthétiseurs vocaux. Pour garantir que toute information critique dépendant de la prononciation reste conviviale et accessible à un large public, ne vous fiez pas uniquement à cette propriété CSS pour définir comment ce contenu est présenté oralement.

Définition formelle

Valeur initialeauto
Applicabilitétous les éléments
Héritéeoui
Valeur calculéevaleur définie
Type d'animationdiscrète

Syntaxe formelle

speak-as = 
normal |
spell-out || digits || [ literal-punctuation | no-punctuation ]

Exemples

HTML

html
<p class="normal">Bonjour, le monde&nbsp;! Je suis 25.</p>
<p class="spell-out">Bonjour, le monde&nbsp;! Je suis 25.</p>
<p class="literal-punctuation">Bonjour, le monde&nbsp;! Je suis 25.</p>
<p class="no-punctuation">Bonjour, le monde&nbsp;! Je suis 25.</p>
<p class="digits">Bonjour, le monde&nbsp;! Je suis 25.</p>
<p class="multi">Bonjour, le monde&nbsp;! Je suis 25.</p>

CSS

css
.normal {
  speak-as: normal;
}

.spell-out {
  speak-as: spell-out;
}

.literal-punctuation {
  speak-as: literal-punctuation;
}

.no-punctuation {
  speak-as: no-punctuation;
}

.digits {
  speak-as: digits;
}
.multi {
  speak-as: literal-punctuation digits;
}

Spécifications

Spécification
CSS Speech Module Level 1
# speaking-props-speak-as

Compatibilité des navigateurs

Voir aussi