SuperAPI AI 工具集

web-platform-design

设计与创作

查看项目

更新于 10-15 21:10

技能介绍

用途:为构建网页界面、审计无障碍、实现响应式布局和评审前端代码提供与框架无关的规则集,依据 WCAG 2.2、MDN Web Docs 与现代 Web 平台 API。

主要能力: 一、无障碍(关键)。要求使用语义化 HTML 元素(main、nav、header、footer、article、section、aside、figure、details、dialog、time、mark、address),避免 div 汤;交互元素必须有可访问名称,优先可见文本,必要时用 aria-label 或 aria-labelledby;保证键盘可达可操作,自定义组件用 tabindex="0" 与 keydown,禁止 tabindex 大于 0,模态框需焦点陷阱并在关闭时归还焦点;不得移除焦点轮廓,需提供可见替代(:focus-visible);提供跳转链接;图片必须有 alt(信息性描述内容、装饰性用空 alt、功能性描述动作);遵守对比度(普通文本 4.5:1、大文本 3:1、UI 组件 3:1),不得仅靠颜色传达信息;表单输入需程序化关联标签,错误需文本说明并用 aria-describedby 或 aria-errormessage 关联;动态内容用 aria-live 区域(默认 polite,紧急用 alert);优先原生 HTML 而非 ARIA;可见文本存在时可访问名称须包含该文本(SC 2.5.3)。 二、响应式(关键)。移动优先,用 min-width 媒体查询叠加复杂度;用 clamp()、min()、max() 实现流式排版与间距;使用容器查询按容器而非视口调整组件;断点基于内容而非设备;触控目标至少 44×44 CSS 像素(AA 要求 24×24);必须包含 viewport meta,禁止 maximum-scale=1 或 user-scalable=no;320px 宽度下不得出现横向滚动。 三、表单(高)。每个输入需可见且程序化关联的标签;使用 autocomplete 属性;选择正确 input 类型;在 blur 时校验并展示成功与错误状态;用 fieldset 与 legend 分组;标明必填项;不要禁用提交按钮,改为提交时校验并显示错误;把说明放在字段附近。 四、排版(高)。使用系统字体栈或带回退的 Web 字体;字号与间距用 rem,组件相对尺寸用 em;正文行高至少 1.5。

使用方式:作为设计、开发与评审时的检查清单逐条对照;资料未提供安装命令或具体工具调用方式。

适用场景:构建网页界面、无障碍审计、响应式布局实现、前端代码评审。

限制:资料未提供收费、价格、平台支持范围或效果数据;部分规则标注为最佳实践,超出 WCAG AA 级别。