SuperAPI AI 工具集

vercel-web-design-guidelines

前端与建站

查看项目

更新于 10-15 21:09

技能介绍

用途:审查 UI 代码是否符合 Web 界面最佳实践,可审计无障碍、性能与 UX 等 100 多条规则。适用场景包括审查 UI 组件的无障碍合规性、按最佳实践审计网页、检查 UX 模式与用户交互、改进表单校验与错误处理、优化动画与过渡。

核心类别:无障碍(语义 HTML、ARIA、键盘导航、屏幕阅读器)、性能(加载、渲染、动画、懒加载)、UX 模式(表单、反馈、错误处理、导航)、视觉设计(排版、间距、颜色对比、响应式)、交互(悬停状态、焦点管理、触控目标)。

关键规则:无障碍方面,动作用 <button>、导航用 <a>,标题层级 h1→h2→h3,使用 <nav>、<main>、<article>、<aside> 地标;所有交互元素可聚焦,焦点指示可见(不可无替代地 outline: none),Tab 顺序符合视觉流,Escape 关闭弹窗/下拉;ARIA 仅在原生 HTML 不足时使用,图标按钮用 aria-label,可展开内容用 aria-expanded,动态更新用 aria-live;文本对比度至少 4.5:1,不单靠颜色传达信息,支持减少动态偏好。表单方面,每个输入需可见 <label> 并用 htmlFor/id 关联,错误就近内联显示,使用 aria-invalid 与 aria-describedby,出错不清空表单,提交时聚焦首个错误字段。性能方面,用骨架屏而非加载圈,大内容渐进加载,首屏下图片懒加载,预加载关键资源;动画用 CSS transform 与 opacity,尊重 prefers-reduced-motion,反馈动画控制在 300ms 内,谨慎使用 will-change。交互元素触控目标至少 44x44px,状态清晰,异步操作有加载态;弹窗内捕获焦点,关闭后归还焦点,提供跳转链接。响应式采用移动优先、clamp() 流式排版,在 320、768、1024、1440 断点测试。

审计清单:图片有 alt、输入有关联标签、对比度达 WCAG 2.1 AA、交互元素可键盘访问、焦点指示可见、动画尊重减少动态、错误信息具描述性、触控目标至少 44px、标题层级正确、ARIA 使用得当。输出格式为 file.tsx:42 - Missing alt text on image 这类逐条定位报告。限制:资料未提供安装命令、收费与平台信息。