SpeechSynthesisUtterance: text-Eigenschaft
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit September 2018 browserübergreifend verfügbar.
Die text-Eigenschaft der Schnittstelle SpeechSynthesisUtterance ruft den Text ab oder setzt ihn, der synthetisiert wird, wenn der Ausspruch gesprochen wird.
Der Text kann als reiner Text oder als wohlgeformtes SSML-Dokument bereitgestellt werden. Die SSML-Tags werden von Geräten entfernt, die SSML nicht unterstützen.
Wert
Ein String, der den zu synthetisierenden Text darstellt. Die maximale Länge des Textes, der in jedem Ausspruch gesprochen werden kann, beträgt 32.767 Zeichen.
Beispiele
js
const synth = window.speechSynthesis;
const inputForm = document.querySelector("form");
const inputTxt = document.querySelector("input");
const voiceSelect = document.querySelector("select");
const voices = synth.getVoices();
// …
inputForm.onsubmit = (event) => {
event.preventDefault();
const utterThis = new SpeechSynthesisUtterance(inputTxt.value);
const selectedOption =
voiceSelect.selectedOptions[0].getAttribute("data-name");
for (const voice of voices) {
if (voice.name === selectedOption) {
utterThis.voice = voice;
}
}
console.log(utterThis.text);
synth.speak(utterThis);
inputTxt.blur();
};
Spezifikationen
| Spezifikation |
|---|
| Web Speech API # dom-speechsynthesisutterance-text |