用途:该规则属于前端检查清单,适用于所有 HTML 文档,用于确保页面默认人类语言可被程序化识别。屏幕阅读器会依据 lang 属性选择正确的语音与发音引擎;缺失时 VoiceOver 回退到用户系统语言、NVDA 使用默认语音,可能导致其他语言内容发音错误、难以理解。lang 也影响浏览器翻译、CSS 断词(hyphens: auto)和拼写检查。
主要能力:检查 <html> 开标签是否存在 lang 属性,值是否非空、是否为有效 BCP 47 语言代码,并与页面主要内容语言一致;同时检查页面内不同语言内容所在的块级元素是否单独标注 lang。空值 lang='' 等同未知语言,效果同缺失。
必要用法:在 <html> 上添加或修正 lang,如 <html lang='en'>、<html lang='zh-Hans'>、<html lang='zh-Hant'>。局部语言变化则在包含该内容的块级元素上加 lang。语言代码应参照 IANA Language Subtag Registry 校验。
判定依据:WCAG 2.1 SC 3.1.1(Language of Page,A 级)要求每页默认语言可程序化确定;SC 3.1.2(Language of Parts,AA 级)要求页面内语言变化可被识别。
适用场景与限制:适用于模板、服务端渲染 HTML 和共享组件输出的标记审查。需标记的问题包括 lang 缺失、lang=''、使用完整语言名称(如 lang='english' 无效)以及声明语言与实际内容语言不符。区域子标签(如 en-US、fr-CA)为可选,但对特定方言的发音和拼写检查有帮助。更完整的实现细节、代码示例与框架指导见 references/rule.md。