lang属性必须设在标签上并遵循BCP 47标准,配合系统语音包和读屏软件才能正确朗读;局部语言需为对应元素单独设置lang,动态切换时须同步更新document.documentElement.lang。

HTML里用lang属性指定朗读语言
浏览器和屏幕阅读器靠lang属性决定用哪种语音引擎读内容,不是靠页面编码或系统语言。不写lang,读出来大概率是错的音调、断句甚至乱码发音。
实操建议:
-
lang必须加在标签上,比如,这是全局默认语言 - 局部切换语言时,给对应元素加
lang,比如一段英文引文:The quick brown fox...
- 值要选BCP 47标准格式,
zh-CN、ja-JP、es-ES可以,chinese或zh(没地区)可能被忽略或降级处理 - 别用
hreflang代替lang——那是给搜索引擎看的链接语言提示,不影响朗读
为什么lang写对了,语音还是念错
常见错误现象:写了lang="zh-CN",但NVDA或VoiceOver仍用英文语音读中文,或者把“行”读成“háng”而不是“xíng”。
原因和应对:
- 系统没装对应语音包:macOS默认不带中文TTS语音,需在「系统设置→辅助功能→语音」里手动下载「普通话(中国大陆)」;Windows需确认「设置→时间和语言→语音」中已安装
Microsoft XiaoYun等中文语音 - 浏览器未继承系统语音:Chrome有时会绕过系统TTS,改用内置轻量引擎(尤其Linux),效果差;Edge和Safari通常更可靠
- 嵌套语言没闭合:比如
,Hello
世界span没重设lang,就会被当成英文读“shì jiè”,得写成世界
aria-label和aria-roledescription怎么配合lang
当按钮文字是图标或缩写(比如),光靠lang不够,屏幕阅读器不知道该读“English”还是“Ee-En”。
生成可在 deepbi 沙箱 iframe 内运行或作为独立文件运行的交互式 HTML 页面,使用 `window.deepbi` JS SDK 实现数据查询、空间管理、文件浏览及用户操作。当用户提出以下需求时启用该能力: - 创建 KPI 仪表盘、数据表格、文件浏览器、成员列表、管理页面; - 明确要求“转成 dhtml”、“转译成 HTML”、“把 XX 页面转成……”、“控制台页面”、“管理后台”、“DeepBI 页面迁移”; - 提及位于 `apps/console/src/featur
这时需要语义补全:
-
aria-label覆盖可访问名称,且自带语言继承:如果父容器是lang="zh-CN",aria-label="搜索"就会用中文读;但若想强制英文播报,得写aria-label="Search" lang="en-US" -
aria-roledescription慎用:它改的是控件类型描述(比如把button说成“筛选按钮”),不改变语言;如果设了aria-roledescription="搜索"却没配lang,很可能被读成拼音或英文音译 - 避免重复定义:不要同时用
aria-label和title,后者不被所有读屏支持,且无语言上下文
多语言站点中动态切换lang的坑
单页应用(SPA)切语言时,只改文案不改lang属性,会导致新内容仍按旧语言朗读——这是最常被忽略的一环。
关键动作:
- React/Vue项目里,不能只更新state,必须同步操作DOM:
document.documentElement.lang = "ja-JP" - 服务端渲染(SSR)场景下,
lang必须随首屏HTML一起输出,不能靠JS补;否则首屏朗读就是错的 - 切换后别忘了触发
aria-live区域更新,否则读屏可能卡在旧语言没反应,比如用配合JS注入提示文本 - 测试时别只听Chrome自带朗读(
Ctrl+Shift+U),它不走系统TTS,行为和真实读屏(NVDA/JAWS/VoiceOver)差异大
真正起作用的永远是lang属性+系统语音包+读屏软件三者对齐,缺一不可。很多人调了半天CSS或JS,最后发现只是Mac没下中文语音包。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!










