SpeechSynthesisUtterance:text 属性

基线 广泛可用

此功能已得到很好的建立,并且可以在许多设备和浏览器版本上运行。它自 2018 年 9 月.

报告反馈

text 属性是 SpeechSynthesisUtterance 接口的属性,用于获取和设置当话语被朗读时将被合成的文本。

文本可以以纯文本形式提供,也可以以格式良好的 SSML 文档形式提供。不支持 SSML 的设备会剥离 SSML 标签。

示例

一个字符串,表示要合成的文本。每个话语中可以朗读的文本的最大长度为 32,767 个字符。
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 (let i = 0; i < voices.length; i++) {
    if (voices[i].name === selectedOption) {
      utterThis.voice = voices[i];
    }
  }
  console.log(utterThis.text);
  synth.speak(utterThis);
  inputTxt.blur();
};

规范

js
Web 语音 API
# 规范

浏览器兼容性

dom-speechsynthesisutterance-text

另请参见