必须为每个含文本的语义化标签显式设置符合BCP 47标准的lang属性,如zh-Hans、en-US、ja-JP等,不可仅依赖html根节点声明,且需配合aria-label和translate="no"协同控制可访问性与翻译行为。

关键在于让浏览器、屏幕阅读器和输入法等系统组件准确识别每段文本的语言,而不是只靠根节点声明。语言声明不精准,用户会遇到语音朗读错、标点间距异常、拼写检查失效、字体显示混乱等问题。
每个含文本的语义化标签都必须显式设置 lang 属性
仅设置 不够。浏览器和辅助技术按元素自身 lang 判断行为,不继承父级。例如:
-
若没加欢迎使用
lang="zh-Hans",VoiceOver 可能按英文规则读顿号、停顿 -
保留原npm install
lang是正确做法;若被全局覆盖成中文,等宽字体可能被中文字体替代,代码可读性下降 -
必须补Merci beaucoup
lang="fr",否则法语引号、重音和连字规则无法触发
lang 值必须符合 BCP 47 标准并区分书写变体
用 zh-Hans 不是 zh-CN 或 zh,用 en-US 而非 en——细微差别直接影响系统行为:
-
zh-Hans触发简体中文拼音标注与断行规则;zh-Hant对应繁体排版逻辑(如全角标点、注音符号) - iOS VoiceOver 对
ja支持弱,需明确写ja-JP才启用日语语音引擎 - 避免下划线、大写混用(如
zh_CN)、或自定义值(如chinese),这些会导致解析失败
配合 aria-label 和 translate="no" 精细控制可访问性
lang 解决“是什么语言”,但解决不了“该怎么读”或“该不该翻”。需要协同控制:
- 对缩写词如
HTML,加aria-label="超文本标记语言",确保屏幕阅读器不按英文念 - 品牌名、代码标识符(如
React、useState)用translate="no"阻止浏览器自动翻译,但前提是其父容器或自身有正确lang - 不要用
translate="no"替代lang——它不改变语言判定依据,lang 才是核心
嵌套多语言内容要分层标注,不依赖上下文推断
浏览器不会自动识别“这是引用”“这是代码注释”。所有局部外语内容必须主动声明:
- 整段英文参考文献:
References
...
- 单个日文术语:
もったいない - 避免在无语义的 或
上滥用lang,除非它确实包裹了可读文本
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











