SpeechSynthesisUtterance: lang-Eigenschaft

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2018.

Die lang-Eigenschaft der SpeechSynthesisUtterance-Schnittstelle ruft die Sprache der Äußerung ab und setzt sie.

Wenn sie nicht festgelegt ist, wird die Sprache der App (d.h. der <html>-lang-Wert) verwendet, oder die Benutzeragenten-Voreinstellung, falls diese ebenfalls nicht festgelegt ist.

Wert

Ein String, der einen BCP 47-Sprachcode darstellt.

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;
    }
  }
  utterThis.lang = "en-US";
  synth.speak(utterThis);
  inputTxt.blur();
};

Spezifikationen

Specification
Web Speech API
# dom-speechsynthesisutterance-lang

Browser-Kompatibilität

Siehe auch