# 实际验证范围

验证日期：2026-11-01。环境为 Windows，Node.js 26.12.0，pnpm 12.11.2，Vue 与 SFC 编译器 3.5.44，Vite 8.3.5，Playwright 1.64.1。测试消费本包真实 SFC 构建后的静态页面。

## 浏览器行为

| 自动化内核 | 版本 | 结果 |
| --- | --- | --- |
| Chromium | 156.0.8078.4 | 25 项通过 |
| Firefox | 157.0 | 25 项通过 |
| Playwright WebKit | 27.2 | 25 项通过 |

检查覆盖初始 model / DOM、模态打开和初始焦点、Tab 不进入背景控件、required 校验、formnovalidate、返回值与重置、关闭后焦点恢复、cancel 取消、业务 preventDefault 后不关闭、窗口内拖到遮罩不误关、忙碌状态、退出中重开、嵌套 Esc、点击遮罩、auto popover 的 Esc / 外部点击 / 自动互斥、toggle 合并、迟到 close、两种动画模式的状态同步、打开时卸载、390px 宽度和减少动态效果。

焦点恢复用例先将触发按钮聚焦，再用 Enter 打开。鼠标点击是否让按钮获得焦点受平台策略影响，不能把上述用例外推成所有鼠标点击都回到按钮。Tab 检查允许用户转到浏览器自身界面，只要求不进入背景页面控件。

详细用例和版本记录位于文章资源 `data/chromium-report.json`、`data/firefox-report.json` 与 `data/webkit-report.json`，没有保留机器绝对路径或表单隐私数据。

## 工程与视觉

- 在独立示例目录实际执行 pnpm install、pnpm typecheck、pnpm build 和 pnpm build:playground。
- 静态 playground 与源码使用同一套 SFC 编译链；离线 HTML 内联 Vue runtime、JavaScript 与 CSS。
- 文章 Code Lab 使用只读源码与构建快照预览；源码编辑和 SFC 热更新通过本地开发服务器进行。
- native-overlays-preview 是脚本生成的静态预览投影，源码与维护包逐文件校验一致。
- 本地 Hexo 文章实际加载了 Code Lab、带内容版本的 JS / CSS / MANIFEST / FILES；iframe 内检查了 SFC 样式、dialog 打开与表单返回 save、popover 的 Esc 关闭和模型同步，并检查 390px 文章布局。
- 桌面截图为 1280×1000 CSS 像素、2 倍像素密度；移动页面检查使用 390×844。
- 三张机制图保留文字 SVG 维护源，发布 SVG 内嵌字体子集与许可；在 Chromium 实际渲染，检查文字、箭头、边距与图示的事实条件。

## 这些检查不覆盖什么

没有使用真实 iPhone、iPad、Android WebView 或微信内核，也没有进行 VoiceOver / NVDA / TalkBack 的完整任务测试。Playwright WebKit 不是 Safari 产品或 iOS 实机。兼容表依据 BCD，不来自把新浏览器模拟成旧版本。

纯 CSS 模式检查了原生状态同步，不能据此承诺每个内核都有完整 display / overlay 视觉退场。跨浏览器背景滚动锁、软键盘、视觉视口、RTL、全 placement 定位、复杂布局位移、KeepAlive 停用和业务异步确认不属于本示例的完整实现范围。

没有做与 Ant Design、Element Plus 或 Tippy 的性能 / 包体对照，因此不提供这类量化收益结论。