上个月接手一个后台项目,样式挺新,交互却全是老一套。打开源码一看,光弹窗就有四套实现:一套是自己写的 z-index 加 fixed 定位,一套用了某个组件库的 Modal,还有两套是不同人各写各的。点击遮罩关闭、按 Esc 关闭、打开后聚焦第一个输入框、关闭后焦点回到原按钮——这四个功能在四套实现里的表现全都不一致。
最典型的一个 bug:用键盘 Tab 键能 Tab 到弹窗背后的按钮上,然后按回车,页面在弹窗没关的情况下直接跳走了。这不是谁的疏忽,纯手写这套东西本来就很容易漏。
其实浏览器早就把这些活干了。popover、dialog 加上新近落地的 command 属性,合起来能覆盖绝大部分弹窗场景,而且焦点管理、Esc 关闭、顶层渲染都是浏览器原生行为。这篇就用一个”列表页 + 筛选面板 + 删除确认”的真实页面,把这几个特性过一遍。
先分清 popover 和 dialog
这两个经常被混着用,但它们解决的问题不一样。
dialog 是模态的。 用 showModal() 打开后,背后的页面是”惰性”的,点不动、Tab 不进去、读屏软件也读不到。适合需要用户必须做出决定的场景:删除确认、填写表单、重要提示。
popover 是非模态的。 打开之后页面照常可交互,点外面就关掉。适合下拉菜单、筛选面板、颜色选择器、气泡提示这类”顺手用一下”的东西。
判断标准很简单:用户能不能边看这个边操作页面其他部分?能,用 popover;不能,用 dialog。
popover 入门:一个筛选面板
传统写法要先写一个绝对定位的 div,再在 JS 里监听 document 的 click 判断点在不在里面,还要处理滚动位置、窗口 resize、层级冲突。用 popover 的话,HTML 就这么多:
<button type="button" popovertarget="filter-panel">筛选</button>
<div id="filter-panel" popover>
<form id="filter-form">
<label>
状态
<select name="status">
<option value="">全部</option>
<option value="1">已发布</option>
<option value="0">草稿</option>
</select>
</label>
<label>
关键词
<input type="search" name="kw">
</label>
<button type="submit">应用</button>
</form>
</div>
就这么几行,浏览器已经帮你做了这些事:
- 元素被放进 top layer,永远不会被别的元素盖住,不用再调 z-index
- 点面板外面自动关闭
- 按 Esc 自动关闭
- 关闭后焦点回到触发按钮
- 打开时
display从none变成可见,不用手动切 class
这里有个细节:那个触发按钮必须加 type="button"。它如果被包在表单里(后台项目里很常见),默认类型是 submit,点一下就把整个页面的表单提交了。
auto 和 manual 的区别
popover 属性不写值时等于 popover="auto"。auto 有两个行为:点外面会关,而且同一时间只能有一个 auto 弹层开着。打开第二个 auto popover,第一个会自己关掉。
大部分场景这是想要的效果。但如果你做的是那种”点一下打开、要点关闭按钮才关”的面板,就写 popover="manual"。manual 不响应外部点击,也不受互斥规则约束。
顺便提一句,还存在 popover="hint",是介于两者之间的一个级别(比如工具提示),关闭逻辑比较微妙,一般业务代码用不到,遇到再说。
用 :popover-open 和 toggle 事件
样式上判断开没开,用 :popover-open 伪类,比自定义 class 靠谱得多:
.panel {
border: 1px solid #ddd;
border-radius: 8px;
padding: 16px;
width: 280px;
}
.panel:popover-open {
box-shadow: 0 8px 24px rgba(0, 0, 0, .12);
}
JS 里需要知道状态变化,监听 toggle 事件:
const panel = document.getElementById('filter-panel');
panel.addEventListener('toggle', (e) => {
// newState 是字符串 'open' 或 'closed'
if (e.newState === 'open') {
// 打开时把焦点放到关键词输入框,省用户一次 Tab
panel.querySelector('input[name="kw"]').focus();
}
});
想打开前做拦截,用 beforetoggle,里面可以 preventDefault()。
手动控制的话,元素上挂载了三个方法:showPopover()、hidePopover()、togglePopover(),还有一个只读属性 :popover-open 对应的 matches(':popover-open') 判断。提交筛选表单后主动收起来就是:
const form = document.getElementById('filter-form');
form.addEventListener('submit', (e) => {
e.preventDefault();
const data = new FormData(form);
// 这里发请求或者过滤本地列表
console.log(data.get('status'), data.get('kw'));
document.getElementById('filter-panel').hidePopover();
});
dialog:模态确认框
dialog 的老用法大家基本都熟,这里重点说两个容易被忽略的地方:method="dialog" 和 closedby。
<dialog id="delete-dialog">
<form method="dialog">
<h2>确认删除</h2>
<p>这条记录删除后无法恢复。</p>
<button value="cancel">取消</button>
<button value="confirm">删除</button>
</form>
</dialog>
method="dialog" 的表单,提交时不会发 HTTP 请求,而是直接关闭所在的 dialog,并把点击的那个按钮的 value 写进 dialog.returnValue。等于说,取消和确认这两个动作,一行 JS 都不用写。
const dlg = document.getElementById('delete-dialog');
dlg.addEventListener('close', () => {
if (dlg.returnValue === 'confirm') {
// 才真正执行删除
}
});
这比用两个 onclick 分别处理干净得多,而且天然支持在按钮里按回车提交。
但光这样还不够——用户点遮罩不会关,这个体验很别扭。新加的 closedby 属性就是干这个的:
<dialog id="delete-dialog" closedby="any">
closedby 有三个值:none 表示只能靠代码关,closerequest 只响应 Esc(其实这就是模态 dialog 的默认行为),any 连点遮罩也算。加上 any 之后,点外面关掉、返回到 returnValue 为空字符串,逻辑上正好落在”没确认”那一支,很顺。
如果你的用户群里还有一批老浏览器,可以在 JS 里补一段:
if (!('closedBy' in HTMLDialogElement.prototype)) {
dlg.addEventListener('click', (e) => {
// 点击的是 dialog 元素本身而不是内部内容,说明点到了遮罩区
if (e.target === dlg) dlg.close('cancel');
});
}
注意判断条件是 e.target === dlg,这不是多余的——dialog 的内边距区域点击也是 target === dlg,所以记得把 dialog 的 padding 设为 0,让内部容器去承担间距。
command 属性:把”点击”声明化
上面两个例子里,打开 dialog 还得写 dlg.showModal()。command 属性出现之后,这一步也能写进 HTML:
<button commandfor="delete-dialog" command="show-modal">删除</button>
commandfor 指向目标元素的 id,command 说明要执行什么动作。内置的动作有几个:
show-modal/close/request-close——作用于 dialogshow-popover/hide-popover/toggle-popover——作用于 popover,和popovertarget等价- 任意以
--开头的自定义命令
自定义命令这一条挺有意思,它把”按钮点了要干什么”这件事从 JS 里搬到了标签上:
<button commandfor="delete-dialog" command="--purge">彻底清除</button>
<script>
document.getElementById('delete-dialog').addEventListener('command', (e) => {
if (e.command === '--purge') {
// 注意:自定义命令不会自动关闭 dialog,需要自己调
e.target.close('purge');
}
});
</script>
相比 onclick,command 的好处是语义明确——这个按钮的作用对象是哪个元素,从标记上就能读出来,不需要翻 JS 找选择器。而且它不依赖闭包,按钮从 HTML 里复制粘贴到别处照样能用。
兼容性上,command 是最新的一个。稳妥的做法是写一层降级:
const supportsCommand = 'command' in document.createElement('button');
if (!supportsCommand) {
document.addEventListener('click', (e) => {
const btn = e.target.closest('button[commandfor]');
if (!btn) return;
const target = document.getElementById(btn.getAttribute('commandfor'));
if (!target) return;
const cmd = btn.getAttribute('command');
if (cmd === 'show-modal' && target instanceof HTMLDialogElement) {
target.showModal();
} else if (cmd === 'close' && target instanceof HTMLDialogElement) {
target.close();
} else if (cmd === 'toggle-popover' && target.togglePopover) {
target.togglePopover();
}
});
}
这段代码放在入口文件里,业务代码里的 HTML 完全不用改,新老浏览器走不同的路。
把动画补上
原生弹窗弹出是硬切,视觉上有点生硬。加过渡的时候会遇到一个经典问题:元素从 display: none 变成可见,transition 不会触发,因为浏览器没有”上一帧”可以过渡。
解法是 @starting-style 加上 transition-behavior: allow-discrete:
[popover] {
opacity: 0;
transform: translateY(-8px);
transition:
opacity .18s ease,
transform .18s ease,
display .18s allow-discrete,
overlay .18s allow-discrete;
}
[popover]:popover-open {
opacity: 1;
transform: translateY(0);
}
@starting-style {
[popover]:popover-open {
opacity: 0;
transform: translateY(-8px);
}
}
三个要点。display 要加进 transition 并且带 allow-discrete,否则它瞬间切换,动画根本没机会播。overlay 同理,它管的是元素什么时候从 top layer 里移除——不加的话,元素一关闭就从顶层掉下来,关闭动画会被下面的内容盖住。@starting-style 负责提供”第一帧”的初始值。
dialog 也一样的写法,把 [popover] 换成 dialog,另外给 ::backdrop 单独加淡入:
dialog::backdrop {
background: rgba(0, 0, 0, .4);
opacity: 0;
transition: opacity .18s ease, display .18s allow-discrete, overlay .18s allow-discrete;
}
dialog[open]::backdrop {
opacity: 1;
}
@starting-style {
dialog[open]::backdrop {
opacity: 0;
}
}
顺带说一句,::backdrop 只对 showModal() 打开的对话框有效。show() 打开的 dialog 是”非模态”的,没有遮罩,行为其实更接近 popover,用的人不多。
定位问题
popover 默认的定位是 position: fixed; inset: 0; margin: auto,也就是屏幕正中。做筛选面板、下拉菜单显然不能放正中间,得自己定位。
最省事的办法是把它挂在按钮旁边,用绝对定位:
.filter-wrap {
position: relative;
display: inline-block;
}
.filter-wrap [popover] {
position: absolute;
inset: auto;
margin: 6px 0 0 0;
top: anchor(bottom);
left: anchor(left);
}
不过要注意,anchor() 是 CSS Anchor Positioning 的语法,目前支持面还不如 popover 本身广。更通用的做法是把按钮和面板放进同一个 relative 容器,面板用 position: absolute; top: 100%; left: 0。虽然这样会脱离 top layer 的定位优势,但 popover 本身仍然在 top layer 里,层级是安全的。
如果面板内容可能很长,记得加 max-height 和 overflow-y: auto,不然在小屏幕上会溢出。
几个真踩过的坑
popover 里再嵌一个 popover,外层会先关。 因为 auto 弹层互斥,里面的打开会把外面的顶掉。要么给外层设 popover="manual",要么把外层的关闭逻辑自己接管。
表单校验失败时 dialog 不该关。 method="dialog" 的表单也有 submit 事件,校验不通过就 e.preventDefault(),对话框会停在那里,输入框上的 :invalid 样式也照常生效。
dialog 默认有宽度限制。 浏览器给的 max-width: calc(100% - 6px - 2em) 之类的默认值,做大表单的时候会莫名其妙卡住,直接写 max-width: 560px; width: 90% 覆盖掉。
auto popover 会吃掉页面的滚动。 这不算 bug,是设计如此——打开时背景滚动被锁住了。如果你做的是一个跟随鼠标的浮层,希望背景能滚,用 manual。
隐藏状态下的 popover 会被 display: none 藏起来,offsetWidth 是 0。 需要测量尺寸的话,先 showPopover() 再读,或者干脆在 toggle 事件里读。
完整示例:一个列表页
把上面的东西拼起来,一个带筛选和删除确认的列表页大概是这样:
<div class="filter-wrap">
<button type="button" popovertarget="filter-panel">筛选</button>
<div id="filter-panel" popover>
<form id="filter-form">
<label>状态
<select name="status">
<option value="">全部</option>
<option value="1">已发布</option>
<option value="0">草稿</option>
</select>
</label>
<label>关键词
<input type="search" name="kw">
</label>
<button type="submit">应用</button>
</form>
</div>
</div>
<table>
<tbody id="list"></tbody>
</table>
<button commandfor="delete-dialog" command="show-modal">删除选中</button>
<dialog id="delete-dialog" closedby="any">
<form method="dialog">
<h2>确认删除</h2>
<p>删除后不可恢复。</p>
<button value="cancel">取消</button>
<button value="confirm">删除</button>
</form>
</dialog>
<script>
const form = document.getElementById('filter-form');
const panel = document.getElementById('filter-panel');
const dlg = document.getElementById('delete-dialog');
form.addEventListener('submit', (e) => {
e.preventDefault();
const fd = new FormData(form);
fetchList({ status: fd.get('status'), kw: fd.get('kw') });
panel.hidePopover();
});
dlg.addEventListener('close', () => {
if (dlg.returnValue === 'confirm') {
doDelete();
}
});
async function fetchList(params) {
const qs = new URLSearchParams(
Object.entries(params).filter(([, v]) => v !== '')
).toString();
const res = await fetch('/api/list?' + qs);
// 渲染逻辑略
}
async function doDelete() {
// 删除逻辑略
}
</script>
整份代码里没有任何手动管理焦点、没有 z-index、没有点击外部判断。这些以前要写小一百行的东西,现在 HTML 属性就包了。
兼容性怎么办
popover 的支持面已经比较宽(2023 年底之后的主流浏览器都没问题),dialog 更早,command 最晚。如果是内部系统或者 App 内的 WebView,基本可以直接上;如果是面向大众的 C 端页面,建议做三档处理:
- popover:用
@supports selector(:popover-open)做特性检测,不支持的走老的自定义 class 方案 - dialog:
typeof HTMLDialogElement !== 'undefined'判断,不支持的引一个 dialog-polyfill - command:像上面那样加一段事件委托的兜底,成本最低
不建议无脑引大而全的 polyfill。这些东西的核心价值就是”浏览器原生帮你做”,如果为了兼容把原生整套重新实现一遍,还不如老老实实写自己的组件。
写到这里
浏览器这几年在交互层补的课挺实在。以前做弹窗要跟 z-index、焦点、遮罩、Esc 键搏斗,现在大部分交给三个属性就够了。剩下要自己处理的,主要还是业务逻辑和视觉细节。
可以按这个顺序接进项目:先把新写的下拉、气泡换成 popover,风险最小;再把确认类弹窗换成 dialog 加 method="dialog";最后看浏览器支持情况决定要不要上 command。一步一步来,不用一次推倒重写。

