speak-as

Limited availability

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

Die speak-as CSS Eigenschaft wird verwendet, um zu definieren, wie HTML Inhalte gesprochen werden. Die ein bis drei enumerierten Schlüsselkategorien bestimmen die Art und Weise, wie Elemente und Texte von auralen Technologien, wie zum Beispiel Screenreadern und digitalen Assistenten, wiedergegeben werden.

Diese Eigenschaft gilt für alle Inhalte, einschließlich Pseudoelementen, mit Ausnahme von ::marker Pseudoelementen, die über eine @counter-style mit einem definierten speak-as Deskriptor erstellt werden. Diese haben Vorrang vor einem geerbten speak-as Eigenschaftswert.

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 ersetzten Satzzeichen. Zum Beispiel würde "Hello, world!" als "Hello (Pause) world (Pause)" ausgesprochen. Dies ist der Standardwert.

spell-out

Der Inhalt wird buchstabiert. Zum Beispiel würde "role" als "r" "o" "l" "e" ausgesprochen.

literal-punctuation

Satzzeichen werden wörtlich ausgesprochen. Zum Beispiel würde "Hello, world!" als "Hello Komma world Ausrufezeichen." ausgesprochen.

digits

Zahlen werden als einzelne Ziffern ausgesprochen. Zum Beispiel würde "31" als "drei eins" ausgesprochen.

no-punctuation

Inhalt wird normal, ohne jegliche Satzzeichen, ausgesprochen. Zum Beispiel würde "Hello, world!" als "Hello" "world" ausgesprochen.

Hinweis: Die Unterstützung der speak-as Eigenschaft ist begrenzt und uneinheitlich über verschiedene unterstützende Technologien, wie Screenreader oder Sprachsynthesizer, implementiert. Damit alle von der Aussprache abhängigen wichtigen Informationen benutzerfreundlich und für ein breites Publikum zugänglich bleiben, verlassen Sie sich nicht ausschließlich auf diese CSS-Eigenschaft, um festzulegen, wie diese Informationsinhalte auditiv präsentiert werden.

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

BCD tables only load in the browser

Siehe auch