我们后台管理系统的通知中心,之前是一个 320 行的 Vue 3 组件。
这 320 行里干的事很杂:算弹层该出现在铃铛按钮右下角多少像素、监听 document 的 click 判断点在不在面板内部、维护 z-index 计数器防止被表格的固定表头盖住、打开时给 body 加 overflow hidden、监听 ESC 键、监听路由变化顺手关掉、还有一堆「弹层打开时点击外部要关,但点击下拉选择器内部不能关」的判断。每次改一点样式就要动其中两三处,改完还要在四五个页面挨个回归。
后来团队里有人提了一句:这些东西浏览器现在原生就管了,你要不要试试 popover。我当时的反应是「能稳吗」,结果试下来——能,但没那么简单,下面这些坑是实打实踩出来的。
先看原生能替掉哪部分
HTML 的 popover 是一个全局属性,挂在任意元素上,加上之后这个元素默认隐藏,点击带 popovertarget 的按钮才会显示。浏览器自己实现了这几件事:
- 显示与隐藏的时序
- 点击面板外部自动关闭(light dismiss)
- 按 ESC 关闭最上层那个
- 同时只显示一个
popover="auto"的面板 - 把面板提升到 top layer,不参与父元素的层叠上下文计算
最后一条是我最想甩掉的包袱。以前弹层盖不住表格固定表头,就是因为在同一个层叠上下文里比 z-index,怎么加都会撞上某个 transform 或者 filter 创建的新的层叠上下文。top layer 是在文档之外单独渲染的,跟 z-index 完全没关系。
HTML 长这样:
<button class="bell"
popovertarget="notify-panel"
aria-expanded="false"
aria-controls="notify-panel">
通知
<span class="badge">3</span>
</button>
<div id="notify-panel" popover class="notify-panel">
<header>
<h2>通知</h2>
<button popovertarget="notify-panel" popovertargetaction="hide" aria-label="关闭">×</button>
</header>
<ul>
<li>订单 #20250311 已发货</li>
<li>库存预警:SKU 8812 剩余 3 件</li>
<li>结算单待审核</li>
</ul>
</div>
popovertarget 的值是目标元素的 id,popovertargetaction 不写默认是 toggle,也可以显式写 show 或 hide。关闭按钮不用再绑 click 事件,这一点省掉的不只是代码,还有「事件绑在组件销毁时没解绑导致内存泄漏」这类老问题。
坑一:它默认出现在屏幕正中间
第一次跑起来,我盯着屏幕中央那个小方块愣了三秒。弹层确实弹出来了,但它没在铃铛旁边,而是稳稳待在视口正中。
原因是 UA 样式表里对处于显示状态的 popover 有一组默认值,大致是:
[popover]:popover-open {
position: fixed;
inset: 0;
width: fit-content;
height: fit-content;
margin: auto;
border: solid;
padding: 0.25em;
overflow: auto;
color: CanvasText;
background-color: Canvas;
}
inset: 0 加 margin: auto 就是经典的居中定位写法,所以它跑到中间去了。要让它在铃铛下方,必须把这几个值显式覆盖掉:
.notify-panel {
inset: auto; /* 撤掉 UA 的 inset: 0 */
margin: 0; /* 撤掉 UA 的 margin: auto */
top: 56px;
right: 24px;
width: 340px;
max-height: 60vh;
border: 0;
padding: 0;
border-radius: 12px;
background: #fff;
box-shadow: 0 8px 24px rgb(0 0 0 / 0.12);
overflow: auto;
overscroll-behavior: contain;
}
这里我暂时用了写死的 top 和 right,因为铃铛按钮在顶栏里的位置是固定的。如果要做成跟着按钮走、并且视口边缘自动翻转的浮动菜单,那就得上 CSS Anchor Positioning:
.bell { anchor-name: --bell; }
.notify-panel {
position-anchor: --bell;
top: anchor(bottom);
right: anchor(right);
margin-top: 8px;
position-try-fallbacks: flip-block, flip-inline;
}
Anchor Positioning 在 Chromium 系已经可用,能省掉「溢出自适应」那一大坨 JS。但我们后台要兼容一批还没升级的浏览器,目前只在这种位置固定的场景用原生方案,真正需要跟随定位的就保留旧逻辑。没必要为了统一而统一。
坑二:popover 没有 ::backdrop
这个误解害我把代码回滚了一次。给 popover 写 ::backdrop 是不会有任何效果的——::backdrop 是 <dialog> 专用的伪元素,popover 压根不进入模态状态,也就没有那层遮罩。
想做「点遮罩关闭 + 半透明背景」的效果,只有两条路:
一是自己塞一个遮罩元素,用 :has() 配合状态伪类控制显隐:
html:has(.notify-panel:popover-open) .page-mask {
display: block;
}
二是干脆用 <dialog>。showModal() 打开之后遮罩、焦点圈定、ESC 关闭全都是现成的。我最后的判断标准是:面板需要用户先处理完才能继续操作页面,就用 dialog;只是看一眼、随时可以点别处走开的,用 popover。通知中心属于后者,所以它没有遮罩,也不需要。
坑三:焦点不会自动移进去
用键盘 Tab 到铃铛按钮上按回车,面板打开了,焦点还停在按钮上,再按 Tab 直接就跳到页面下一个元素去了,人根本进不去面板里。
这是 popover 和 dialog 的关键区别。dialog 用 showModal() 时会自动把焦点移到第一个可聚焦元素或带 autofocus 的元素上,关闭时还会还回去。popover 不做这些,规范里它是「非模态」的,焦点留在原处是符合预期的行为。
所以要么用 JS 移焦点,要么干脆把面板里第一个可聚焦元素标上 autofocus。我试过 autofocus,在 popover 上它确实生效,但只有 Chromium 系认,得看看目标浏览器覆盖情况再决定。最后写了几行:
const panel = document.getElementById('notify-panel');
panel.addEventListener('toggle', (e) => {
if (e.newState !== 'open') return;
const first = panel.querySelector('button, [href], input, select, textarea');
first?.focus();
});
顺便说,toggle 事件在 popover 上触发时是不冒泡的,所以这里必须直接监听元素本身,不能挂在 document 上指望它冒上来。事件对象里的 newState 是 'open' 或 'closed',比自己去读属性可靠得多——尤其是 ESC 关闭的时候,你根本收不到任何点击事件。
坑四:aria-expanded 不会自己同步
这一点挺意外:popovertarget 把行为和按钮关联起来了,但浏览器不会自动帮你维护 aria-expanded。屏幕阅读器读到的按钮永远是「已折叠」,即使面板已经展开着。
只能自己补。好在有 toggle 事件,几行就够:
document.addEventListener('toggle', (e) => {
const target = e.target;
if (!(target instanceof HTMLElement) || !target.matches('[popover]')) return;
const trigger = document.querySelector(`[popovertarget="${target.id}"]`);
if (!trigger) return;
trigger.setAttribute('aria-expanded', e.newState === 'open' ? 'true' : 'false');
}, true);
注意最后那个 true。不加它监听器根本收不到事件,因为前面说了 toggle 不冒泡。捕获阶段能拿到,是因为事件从 window 往下走到目标元素时会经过 document,即使后面不冒泡,捕获这一段照样会触发。这一点我调试了半个小时才反应过来。
坑五:多层弹层按 ESC,关闭顺序不对
通知面板里点一条通知,弹出一个详情窗(也是 popover)。这时候按 ESC,我期望先关详情窗,再按一次关通知面板。实际测下来 Chromium 的行为是对的,确实按打开顺序倒着关。
但有个前提:这两层都得是 popover="auto"。如果详情窗写成了 popover="manual",ESC 根本不会关它,因为 manual 的意思就是「我不受自动关闭规则管,什么时候关由我决定」。
还有一处隐蔽的:如果一个 auto popover 里面又嵌了一个 auto popover,点内层面板的空白区域,关闭的是内层,外层保留。这个行为是对的,符合直觉。但如果是通过 JS 调用 showPopover() 打开内层,再调用 hidePopover() 关外层,内层会一起消失——因为它在外层的子树里。关闭外层之前记得先关内层,否则会留下一个永远关不掉的孤儿面板。
坑六:移动端底部抽屉,还是得用 dialog
后台的通知中心改完之后,我很想把移动端那个筛选抽屉也一起换掉。筛选项有十几个,还要支持「清空 / 应用」两个按钮,本质上是个表单。
这里 popover 不够用了。抽屉打开时用户必须先处理完筛选才能继续,属于模态场景;而且我们需要遮罩、需要锁滚动、需要在关闭时拿到用户点了哪个按钮。这几点 dialog 一次给齐:
<dialog id="filter-sheet" class="sheet">
<form method="dialog">
<header><h2>筛选</h2></header>
<fieldset>
<legend>状态</legend>
<label><input type="radio" name="status" value="all" checked> 全部</label>
<label><input type="radio" name="status" value="paid"> 已支付</label>
<label><input type="radio" name="status" value="shipped"> 已发货</label>
</fieldset>
<footer>
<button value="reset" formnovalidate>重置</button>
<button value="apply">应用</button>
</footer>
</form>
</dialog>
form method="dialog" 这一段值得单独说。表单提交时不会发请求,而是直接关闭 dialog,并把点中的那个按钮的 value 写进 dialog.returnValue。等于说「用户点了哪个按钮」这个信息不用再挂事件监听去记:
const sheet = document.getElementById('filter-sheet');
sheet.addEventListener('close', () => {
if (sheet.returnValue === 'apply') {
applyFilter(new FormData(sheet.querySelector('form')));
} else if (sheet.returnValue === 'reset') {
sheet.querySelector('form').reset();
sheet.showModal(); // 重置后保持打开
}
});
样式上,抽屉的「从底部滑上来」得自己写:
.sheet {
position: fixed;
inset: auto 0 0 0;
margin: 0;
width: 100%;
max-height: 80vh;
border: 0;
border-radius: 16px 16px 0 0;
padding: 0;
overflow: auto;
overscroll-behavior: contain;
}
.sheet::backdrop {
background: rgb(0 0 0 / 0.4);
}
UA 对 dialog 也有一组默认样式(居中、margin: auto、border: solid),跟 popover 一个套路,该覆盖的都要覆盖。
坑七:点遮罩不会关 dialog,滚动也不会锁
两个很常见的预期落差。
第一,点击 ::backdrop 默认不关闭 dialog。以前用第三方库习惯了点遮罩就关,换原生之后发现点了没反应。得自己判断:
sheet.addEventListener('click', (e) => {
if (e.target === sheet) sheet.close('cancel');
});
这里判断 e.target === sheet 是因为 dialog 自身的盒子覆盖整个遮罩区域,点到「遮罩」其实是点到了 dialog 元素本身。如果抽屉是 inset: auto 0 0 0 这种只占底部的写法,那这条判断就不成立,需要另外处理。
第二,dialog 打开时页面是能滚动的。手指在遮罩上滑动,背后列表跟着动,体验很差。用 :has() 一行解决:
html:has(dialog[open]) {
overflow: hidden;
}
注意这里用的是 [open] 而不是 :modal。:modal 更精确,只匹配 showModal() 打开的 dialog,但现在再用 :has(dialog:modal) 在个别老版本上会失效,用属性选择器覆盖面更宽。非模态的 dialog(show() 打开)我们项目里没有,所以这么写不吃亏。
关于 commandfor:可以再等等
新规范里有个 commandfor 属性,打算统一替代 popovertarget 和各种按钮的默认行为,写法是:
<button commandfor="filter-sheet" command="show-modal">打开筛选</button>
<button commandfor="notify-panel" command="toggle-popover">通知</button>
看着确实更整齐,一个属性管所有。但它目前主要落在 Chromium 上,Firefox 和 Safari 还没跟上。所以现在的策略是:popovertarget 作为主写法,等 commandfor 覆盖率上来再迁移。界面上不依赖它的场景就直接用 popovertarget,零风险。
iOS 那边的情况
项目要覆盖到一批公司内部的 iPad,有几台还卡在 iOS 16。所以上线前加了一次能力检测:
const supportsPopover = 'popover' in HTMLElement.prototype;
const supportsDialog = typeof HTMLDialogElement !== 'undefined'
&& typeof HTMLDialogElement.prototype.showModal === 'function';
if (!supportsPopover) {
// 走旧的 JS 弹层实现
}
测下来,Safari 从 17 开始支持 popover,dialog 更早一些(15.4 就有 showModal() 了)。所以真正需要回退的只有 popover 那部分,dialog 可以直接用。'popover' in HTMLElement.prototype 这个检测比查 UA 靠谱得多,切到微信内置浏览器、企业微信这些壳子里也不会误判。
改完之后的数据
通知中心那个 Vue 组件从 320 行降到 41 行,其中一半是 aria-expanded 同步和焦点处理,另一半是「标记已读」的业务逻辑。移动端筛选抽屉删掉了 168 行(原来的滚动锁定、遮罩点击、按钮回调、动画状态管理全没了),换成 3 行 form method=”dialog” 的提交处理。
打包体积上,通知中心原来引了一个 12KB 的定位计算工具函数,现在不需要了。dayjs 之类的东西还在,跟这次改造没关系。
交互层面有个明显变化:弹层第一次出现的时机变快了。以前要先等 JS 初始化、算位置、再设置 visibility: visible,中间会闪一下;原生方案是浏览器在点击的同一帧里把元素放进 top layer,没有这个中间态。这个体感比任何指标都明显。
还没解决的事
有两个点目前还是将就着的,写出来给要上同样方案的人提个醒。
一是动画。[popover]:popover-open 上的过渡效果,在元素从 display: none 变成 display: block 的那一帧不会生效,得用 @starting-style 或者 transition-behavior: allow-discrete。这块浏览器支持还不齐,我们暂时关掉了动画,等支持面广一点再说。没有动画不致命,闪一下很难看。
二是嵌套场景下的关闭逻辑。项目里有个「商品选择器」弹层,它内部又弹一个「分类树」的 popover。两个都是 auto 的时候,在外层弹层里点击会关闭内层,这个没问题;但如果用户直接点页面别处,两个会一起关掉,而业务上要求外层保留。目前的做法是把外层改成 popover="manual",自己接管关闭时机。代价是失去了 light dismiss,需要多写一点逻辑,但比起去猜浏览器行为,这个取舍我觉得值。

