SuperAPI AI 工具集

html-semantic-engineering

前端与建站

查看项目

更新于 10-16 00:21

技能介绍

这是一套面向生产环境的 HTML 工程规则集,核心原则是语义正确优先,其次无障碍,最后性能。内容覆盖语义结构、无障碍、表单与验证、性能、SEO 与元数据、安全、表格与交互组件等主题。

语义结构方面:不跳级使用标题;优先使用语义元素而非 div;为导航提供地标区域。无障碍方面(WCAG 2.1 AA):图片必须有 alt 文本,装饰图用空 alt;实现跳转链接;表单控件关联标签;正确使用 ARIA(用于自定义组件,不替代原生语义);保证键盘可访问。表单与验证方面:使用合适的 input 类型;HTML5 原生验证并配合可访问错误提示;用 fieldset 和 legend 分组;用 autocomplete 辅助用户数据填写。性能方面:首屏以下图片懒加载;用资源提示加载关键资源;指定图片宽高避免布局偏移;延迟非关键脚本;用 modulepreload 预加载关键组件防止 FOUC;用 CSS 规则防止自定义元素未定义时闪现。SEO 方面:提供必要元标签与结构化数据。安全方面:配置内容安全策略;外部资源使用 SRI 与 crossorigin;表单加入 CSRF 令牌。表格方面:使用 caption、thead、th scope 构建可访问数据表。交互组件方面:模态对话框需焦点捕获与正确 ARIA。

该技能与 web-components-architecture、javascript-pragmatic-rules、utopia-fluid-scales、utopia-grid-layout、utopia-container-queries 等技能配合使用。设计系统基于 Utopia 流体尺度与 cqi 单位,不硬编码像素值,使用设计令牌(如 --step-、--space-、--grid-gutter)。cqi 单位需父元素设置 container-type: inline-size。

具体使用方式、安装命令及官方细节暂未提供。