使用 modern web guidance 时,先用 search 查一个具体的前端任务,再用 retrieve 读取命中的指南。以原生弹窗的遮罩动画为例,最终要核对动画、关闭行为和不支持动画时的回退。
怎么把弹窗需求写成检索词?
搜索词不用写得太复杂,精准描述单个要实现的能力就行。这次要找弹窗遮罩动画的实现方案,直接用描述弹窗和动画的短语当关键词就好。返回的结果里可能顺带带出点击弹窗外部关闭、禁止底层页面滚动的相关内容,先快速扫一遍每条的简介,再挑你需要的那篇就行。
npx -y modern-web-guidance@latest search "animate a dialog modal backdrop"
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

根据 ID 读取实际实现建议
找到 ID 为 animate-to-from-top-layer 的条目之后,运行下面的命令。读指南的时候重点看进场状态、离散过渡规则和浏览器兼容回退方案。
npx -y modern-web-guidance@latest retrieve animate-to-from-top-layer

把指南落到代码审查和浏览器验证
如果现有页面已经用 showModal() 唤起弹窗,不用改动已有的打开和关闭逻辑,直接在现有基础上补动画实现就行。测试要覆盖点击按钮打开、按Esc关闭弹窗的场景,检查键盘焦点流转,确认弹窗关闭后焦点能回到之前的对应位置。就算浏览器本身缺少动画支持能力,弹窗的所有基础操作也必须能正常运行。
请使用 Modern Web Guidance 查找原生 dialog 的进出场动画。先说明命中的指南 ID,再调整样式。保留现有的键盘关闭行为,并说明如何验证回退。











