SuperAPI AI 工具集

heading-hierarchy

前端与建站

查看项目

更新于 10-16 05:42

技能介绍

用途:该规则(heading-hierarchy)用于审查渲染后的 HTML、交互组件或设计系统模式,确保页面采用符合逻辑的标题层级。屏幕阅读器用户会像查目录一样通过标题导航,跳级或层级混乱会让内容难以理解和定位。

主要能力:检查页面是否只有一个 h1 作为主标题;标题是否按 h1→h2→h3 顺序排列、不跳级;标题文本是否清晰描述其后的内容;是否误用标题进行视觉样式而非结构表达。可借助无障碍工具生成标题大纲来核验。

用法:在代码审查中查看渲染后的标记和相关交互状态,指出违反规则的具体元素、角色、标签、焦点行为或键盘交互,并说明如何用浏览器无障碍工具或辅助技术验证修复。修复时按内容层级组织标题,用 h1 作页面标题、h2 作主要分区、h3 作子分区,不使用标题做纯视觉样式。

适用场景:无障碍审查、前端代码评审、组件与设计系统检查。

限制:资料未提供具体框架实现细节、完整代码示例,详见 references/rule.md;也未提及收费、平台或效果保证等信息。