SuperAPI AI 工具集

progressive-enhancement

编程与开发

查看项目

更新于 10-16 03:48

技能介绍

用途:本技能面向“HTML 优先”的渐进增强开发,目标是让功能在没有 JavaScript 时也能工作,再由 CSS 提供视觉反馈与交互,JavaScript 仅在确有必要时作为增强层。

分层原则:第 1 层 HTML,保证任何浏览器、屏幕阅读器、搜索引擎可用;第 2 层 CSS,负责布局、主题、校验反馈与动画;第 3 层 JS 为可选增强。每个功能都应有纯 HTML 基线体验,由 CSS 增强。

主要能力:使用原生元素实现交互,无需 JS。用 <details>/<summary> 做手风琴展开收起;用 <dialog> 做模态框,配合 command/commandfor 声明式打开关闭并自带焦点管理与 backdrop;用 Popover API 做非模态浮层,命令包括 toggle-popover、show-popover、hide-popover。对比:<dialog> 具备模态阻塞与焦点陷阱,适合确认与表单;popover 支持点外部轻关闭,适合菜单、提示与下拉。

command/commandfor 内置命令有 show-modal、close、toggle-popover、show-popover、hide-popover,也支持以 -- 前缀定义自定义命令并由 JS 监听 command 事件处理;相比 onclick 更利于 CSP,并自带无障碍状态。其余能力包括 <datalist> 自动补全、复选框/单选框 Hack 实现菜单与主题切换、纯 CSS 标签页、:has() 父级与兄弟状态样式、:user-valid/:user-invalid、:placeholder-shown、:required 等表单校验伪类,以及 View Transitions API 无 JS 页面过渡。

用法与限制:无 JS 时的降级可用 <noscript> 提示、隐藏 JS 专用 UI、跳转静态回退页,或用 @media (scripting: none) 检测;CSS 新特性用 @supports 做基线回退;无法用 @supports 检测的特性再用 JS 写 data 属性暴露给 CSS。需注意可访问性(:focus-visible、prefers-reduced-motion、隐藏复选框标签配 sr-only 文本),复杂状态、异步请求、程序化焦点、实时更新与复杂手势动画仍需 JavaScript。具体浏览器兼容版本、安装或引入方式、许可与收费信息,资料未提供。