speak-as

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig vor der Verwendung auf produktiven Webseiten.

Die speak-as CSS Eigenschaft wird verwendet, um zu definieren, wie HTML Inhalt gesprochen wird. Die ein bis drei aufgezählten Schlüsselbegriffe bestimmen die Art und Weise, wie Elemente und Text von audiovisuellen Technologien wie Screen Readern und digitalen Assistenten wiedergegeben werden.

Diese Eigenschaft gilt für alle Inhalte, einschließlich Pseudo-Elementen, mit Ausnahme der ::marker Pseudo-Elemente, die mittels eines @counter-style erzeugt werden und einen definierten speak-as Deskriptor besitzen, welcher Vorrang vor jedem geerbten Wert der speak-as Eigenschaft hat.

Syntax

css
/* single value syntax */
speak-as: normal;
speak-as: spell-out;
speak-as: literal-punctuation;
speak-as: digits;
speak-as: no-punctuation;

/* multiple value syntax */
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;

Werte

normal

Normale Ausspracheregeln mit durch Pausen ersetzter Interpunktion. Zum Beispiel wird "Hello, world!" als "Hello (Pause) world (Pause)" ausgesprochen. Dies ist der Standardwert.

spell-out

Inhalt wird buchstabiert. Zum Beispiel wird "role" als "r" "o" "l" "e" ausgesprochen.

literal-punctuation

Satzzeichen werden buchstäblich ausgesprochen. Zum Beispiel wird "Hello, world!" als "Hello comma world exclamation mark" ausgesprochen.

digits

Zahlen werden als einzelne Ziffern ausgesprochen. Zum Beispiel wird "31" als "three one" ausgesprochen.

no-punctuation

Inhalt wird normal ohne Satzzeichen ausgesprochen. Zum Beispiel wird "Hello, world!" als "Hello" "world" ausgesprochen.

Hinweis: Die Unterstützung der speak-as Eigenschaft ist begrenzt und wird in verschiedenen unterstützenden Technologien, wie Screen Readern oder Sprachsynthesizern, inkonsistent umgesetzt. Um sicherzustellen, dass jegliche von der Aussprache abhängige kritische Informationen benutzerfreundlich und für ein breites Publikum zugänglich bleiben, sollten Sie sich nicht ausschließlich auf diese CSS Eigenschaft verlassen, um die Präsentation von Informationen auditiv zu definieren.

Formale Definition

Anfangswertauto
Anwendbar aufalle Elemente
VererbtJa
Berechneter Wertspecified value
Animationstypdiskret

Formale Syntax

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

Beispiele

HTML

html
<p class="normal">Hello, world! I'm 25.</p>
<p class="spell-out">Hello, world! I'm 25.</p>
<p class="literal-punctuation">Hello, world! I'm 25.</p>
<p class="no-punctuation">Hello, world! I'm 25.</p>
<p class="digits">Hello, world! I'm 25.</p>
<p class="multi">Hello, world! I'm 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;
}

Spezifikationen

Specification
CSS Speech Module Level 1
# speaking-props-speak-as

Browser-Kompatibilität

Siehe auch