用途:用于审查自定义元素(custom element)类定义或 Web Component 源码,检查是否缺少 ARIA 反射、键盘交互处理与表单关联。
主要能力:检查自定义元素定义中是否缺少 ElementInternals 设置、ARIA 反射、键盘交互模式,以及类似输入组件是否缺少表单关联。资料强调应先确认该组件是否真的需要自定义,而不是用原生控件加样式即可。
必要用法:在构造函数中附加 ElementInternals,实现 ariaRole 与 ariaLabel 反射;按 ARIA 作者实践添加键盘事件处理;对自定义输入元素使用 formAssociated;对复合组件(listbox、toolbar、menu)应用 roving tabindex。优先使用原生 <button>、<input>、<select>、<details>。
适用场景:适合在代码审查阶段检查自定义元素类文件,关注 ElementInternals 附加、ARIA 属性反射、键盘交互(Tab、Enter、Space、方向键)、焦点管理,以及类似输入元素上的 formAssociated 静态属性。
限制:资料指出 shadow DOM 在没有 ElementInternals 的情况下不会自动向无障碍树暴露 ARIA。完整实现细节、代码示例与框架相关指南见 references/rule.md。具体收费、平台与效果暂未提供。