用途:确保一个 HTML 文档中每个 id 属性只出现一次,并让 label、ARIA 属性、JavaScript 选择器等引用正确指向对应元素。该规则适用于检查模板、服务端渲染的 HTML 以及输出标记的共享组件。
主要检查点:扫描整个页面,确认所有 id 值唯一;关注组件库可能引入的重复 ID。
修复方式:删除重复的 id 值,保证每个 id 每页只用一次,并同步更新 label、ARIA 属性或 JavaScript 选择器等引用。
原因:重复 ID 会破坏可访问性(表单标签无法连接、ARIA 关系失效),并让 getElementById 返回错误元素,产生难以发现的缺陷。样式应使用 class,ID 只用于唯一锚点或引用。
审查方式:在代码审查中,针对渲染后的浏览器端标记(而非仅源模板)定位违反规则的具体元素、属性和路由。
完整实现细节、代码示例与框架相关指引见 references/rule.md;规则页面为 https://frontendchecklist.io/rules/html/unique-id。