HTML5的标签不用于朗读网页文字,仅播放预录音频;实现无障碍语音朗读须用Web Speech API的SpeechSynthesis。需正确标记、提供文字稿并避免自动播放,SpeechSynthesis则负责动态内容实时朗读,二者协同提升无障碍体验。

HTML5 的 <audio></audio> 标签本身不是为“朗读网页内容”设计的,它只负责播放预录音频文件。要为视障用户实现**网页内容的无障碍语音朗读**,核心应使用 **Web Speech API 的语音合成(SpeechSynthesis)**,而非依赖 <audio></audio>。但 <audio></audio> 在无障碍场景中仍有明确、不可替代的作用——它必须被**正确标记、可控、可理解**,避免干扰或误导屏幕阅读器用户。
一、明确分工:audio 标签不朗读文字,只承载有声内容
很多开发者误以为给 <audio></audio> 加个 aria-label 就算支持无障碍,其实关键在于:它是否属于“非装饰性多媒体”?如果是,就必须满足 WCAG 对预录音频的完整要求:
- 所有非背景、非装饰性的音频(如讲解录音、课程旁白、提示音)都需提供等效文字稿(transcript),且页面上要有显式链接,例如:
<a href="transcript.html">查看本音频文字稿</a> - 若音频含重要语义信息(如语音导航指令、操作反馈),不能仅靠声音传递——需同步在界面上以文本形式呈现,或通过
aria-live动态播报 -
<audio></audio>自身不支持alt属性,应使用aria-label(简明用途)或aria-labelledby(关联外部标题),例如:<h3 id="audio-title">第3章:CSS盒模型详解</h3><br><audio aria-labelledby="audio-title" src="chapter3.mp3"></audio>
二、真正实现“网页文字转语音朗读”的是 SpeechSynthesis
当你想让按钮点击后朗读一段说明、让文章段落被逐句诵读、或为表单错误提示配音,这才是 window.speechSynthesis 的用武之地。它原生、轻量、无需网络请求,且完全受键盘与屏幕阅读器控制:
生成可在 deepbi 沙箱 iframe 内运行或作为独立文件运行的交互式 HTML 页面,使用 `window.deepbi` JS SDK 实现数据查询、空间管理、文件浏览及用户操作。当用户提出以下需求时启用该能力: - 创建 KPI 仪表盘、数据表格、文件浏览器、成员列表、管理页面; - 明确要求“转成 dhtml”、“转译成 HTML”、“把 XX 页面转成……”、“控制台页面”、“管理后台”、“DeepBI 页面迁移”; - 提及位于 `apps/console/src/featur
- 初始化时检查支持性:
if ('speechSynthesis' in window),再调用getVoices()获取可用中文语音(如 Chrome 通常自带“Microsoft YaYa”或“TianTian”) - 构造朗读任务:
const utterance = new SpeechSynthesisUtterance('请填写您的电子邮箱');,设置lang='zh-CN'、rate=0.9(更自然语速)、pitch=1.1 - 绑定事件确保可中断:
utterance.onstart = () => btn.setAttribute('aria-busy', 'true');,utterance.onend = () => btn.removeAttribute('aria-busy'); - 提供明确操作控件:一个“朗读全文”按钮 + 一个“停止朗读”按钮,两个都需
role="button"、tabindex="0",并用aria-pressed反映当前状态
三、audio 与语音合成协同提升无障碍体验
二者不是互斥,而是互补。典型协作方式包括:
立即学习“前端免费学习笔记(深入)”;
- 用
<audio></audio>播放高质量预录的欢迎语音、品牌音效或复杂语音解说;用SpeechSynthesis实时朗读动态生成的内容(如搜索结果、实时通知、表单校验提示) - 当用户启用系统级“减少动画/运动”偏好(
prefers-reduced-motion)时,可自动禁用语音合成的自动朗读,仅保留手动触发,避免信息过载 - 在高对比度模式下,确保自定义语音控制按钮的图标和文字有足够对比度(≥4.5:1),且不依赖颜色区分“正在朗读”和“已暂停”
- 为
<audio></audio>添加playsinline(iOS 必须),防止全屏弹出打断屏幕阅读器上下文;同时为其控件添加aria-label,例如:<button aria-label="增大音量">?</button>
四、避开常见无障碍陷阱
以下做法看似方便,实则严重损害视障用户访问体验:
- ❌ 给
<audio autoplay></audio>—— 大多数浏览器已禁止无用户交互的自动播放,且会打断屏幕阅读器当前朗读 - ❌ 仅用图标(如 ?)表示“点击朗读”,未配
aria-label或视觉隐藏文本(<span class="sr-only">朗读此段文字</span>) - ❌ 把长篇文字硬塞进
<audio src="data:audio/wav;base64,..."></audio>—— Base64 音频体积大、无法缓存、加载慢,且无法提供文字稿 - ❌ 使用
document.execCommand('play')等过时方法控制语音,应统一走speechSynthesis.speak()和speechSynthesis.cancel()


















