别急着装 UI 库:用原生 dialog 与 Popover API 实现能上线的弹层

2026-11-12 0 232

上个月接了个后台项目,需求很简单:一个确认框、一个下拉菜单、一个图片预览。按照以前的习惯,我会装一个组件库然后从里面挑三个组件出来。但这次项目有个限制——打包体积预算压在 60KB 以内,装完库基本上就没什么空间了。

于是我回头翻了一下规范,发现这两年浏览器在弹层这块补得差不多了。<dialog> 早就是正式标准,Popover API 也在主流浏览器全面落地。这篇文章就是那次折腾的完整记录,包括我踩过的坑。

先说清楚 dialog 的两个打开方式不是一回事

很多人第一次用 <dialog> 会写成 dialog.show(),然后发现背景还能点、页面还能滚,于是得出”原生 dialog 不好用”的结论。其实问题出在方法选错了。

<dialog id="confirm">
  <p>确定要删除这条记录吗?</p>
  <button value="cancel">取消</button>
  <button value="ok">确定</button>
</dialog>

<script>
  const dlg = document.getElementById('confirm')

  dlg.show()        // 非模态:背景可交互,无 backdrop,ESC 不关闭
  dlg.showModal()   // 模态:进入顶层,背景 inert,ESC 可关闭
</script>

showModal() 做的事情比想象中多:元素被移到 top layer,不受任何父级 overflow 和 z-index 影响;页面其余部分自动变成 inert,键盘 Tab 也跳不出去;同时生成一个 ::backdrop 伪元素。而 show() 只是把 open 属性加上去而已,本质上跟一个普通 div 显示出来没区别。

还有一点容易忽略:showModal() 会抛错。元素没挂到 DOM 上,或者它已经是打开的模态状态,都会抛 InvalidStateError。动态创建弹窗的代码里一定要先 document.body.appendChild(dlg) 再调用。

关闭事件有个陷阱:它不是一种来源

用户关掉一个 dialog 的方式有好几种:点关闭按钮、按 ESC、点背景遮罩、表单提交。如果只是一股脑监听 close 事件,你并不知道到底是哪种,也就没法做”点了遮罩要不要真的关”这种判断。

正确的顺序是先监听 cancel。cancel 只在按 ESC 时触发,而且它可以被取消:

dlg.addEventListener('cancel', (e) => {
  if (hasUnsavedChanges()) {
    e.preventDefault()      // 拦住 ESC,弹窗保持打开
    showTip('请先保存或放弃修改')
  }
})

dlg.addEventListener('close', () => {
  // 此时 dlg.open 已经是 false
  const action = dlg.returnValue || 'dismissed'
  if (action === 'ok') submit()
})

另外 close 事件不冒泡。你想在父级用事件委托统一处理所有弹窗,是收不到的,必须一个个绑。这点跟很多人对 DOM 事件的直觉相反。

表单和 dialog 的配合值得单独说

在 dialog 里放 <form method="dialog">,提交时浏览器会自动关闭弹窗,并把被点击按钮的 value 写进 dialog.returnValue。这意味着确认框可以完全不写 JS 关闭逻辑:

<dialog id="confirm">
  <form method="dialog">
    <h2 id="confirm-title">删除确认</h2>
    <p>删除后不可恢复,请确认。</p>
    <button value="cancel">再想想</button>
    <button value="ok" formnovalidate>确定删除</button>
  </form>
</dialog>

这里加 formnovalidate 是必要的。如果弹窗里同时有输入项和要求填的字段,用户点”取消”,表单照样会走校验,结果取消按钮点不动。这个问题我第一次遇到时排查了挺久。

还有一个坑:<form method="dialog"> 不会阻止页面刷新,但它也不会触发 submit 事件的默认行为——你注册的 submit 监听器仍然会执行。如果监听器里写了 e.preventDefault(),弹窗就不会自动关,按钮看起来像”点了没反应”。

Popover:下拉菜单终于不需要自己算位置了

下拉菜单比弹窗更麻烦,因为要处理”点外面关闭”、”打开另一个就关掉当前的”、”不能被父级 overflow 裁掉”。过去这些都要手写,现在一行属性就能搞定:

<button popovertarget="menu">更多操作</button>

<div id="menu" popover>
  <button>编辑</button>
  <button>复制链接</button>
  <button>删除</button>
</div>

popovertarget 的值是目标元素的 id,点了就切换显示。目标元素带了 popover 属性(默认值是 auto),会被自动放进 top layer,同时获得 light dismiss 能力——点空白处、按 ESC,它就关掉了。

三种取值的行为差异需要记牢:

取值 light dismiss 同时打开多个 适用场景
auto 支持 不支持,开新的会关旧的 下拉菜单、气泡提示
manual 不支持 支持 需要手动控制关闭的面板
hint 支持 不支持,但不会关闭其他 auto 悬浮提示,不打断用户流程

有个行为第一次遇到会懵:嵌套的 popover,如果你在内层点了一下,外层的也会被关掉,因为 click 事件会穿过内层冒泡到外层文档上,触发外层的 light dismiss。解决办法是在内层监听 click 并阻止冒泡,或者把内层设成 popover="manual" 自己管理。

按钮的状态联动也有现成方案。加 popovertargetaction 可以指定是显示、隐藏还是切换,浏览器还会自动给触发按钮加上 :popover-open 相关的 aria 状态:

<button popovertarget="menu" popovertargetaction="show">打开</button>
<button popovertarget="menu" popovertargetaction="hide">关闭</button>

定位:锚点定位可以用了,但要留退路

popover 默认居中对齐锚点,跟下拉菜单想要的效果差得远。想让它贴在按钮下方,需要 CSS Anchor Positioning:

.trigger {
  anchor-name: --menu-anchor;
}

#menu {
  position-anchor: --menu-anchor;
  position-area: bottom span-right;
  margin-top: 4px;
}

position-area: bottom 表示放在锚点正下方,空间不够时浏览器会自动翻到上方——这正是手写定位最烦的那部分逻辑。但截至写这篇文章时,position-area 在 Firefox 上还需要手动开启实验特性,Safari 也只是部分支持。

所以我的做法是分层:默认用 position-area,再用 @supports 检测,不支持时退回绝对定位加 JS 计算。检测写法比想象中刁钻,因为 @supports 对未知属性返回 false,但属性名本身已知、值不合法时也会返回 false:

@supports (position-area: bottom) {
  #menu {
    position-anchor: --menu-anchor;
    position-area: bottom span-right;
  }
}

@supports not (position-area: bottom) {
  #menu {
    position: fixed;
    /* 由 JS 在 toggle 事件里写入 top / left */
  }
}

JS 兜底的时机选在 toggle 事件里,而不是点击时。因为 popover 也可能被 ESC 或外部点击关掉,只有 toggle 才能准确反映状态变化:

menu.addEventListener('toggle', (e) => {
  if (e.newState !== 'open') return
  const rect = trigger.getBoundingClientRect()
  menu.style.top = `${rect.bottom + 4}px`
  menu.style.left = `${rect.left}px`
})

动画:为什么加了 transition 没效果

给 dialog 或 popover 写 transition,打开时生硬地出现,关闭时直接消失,过渡完全没生效。原因是元素从 display: none 变成其他值,没有起始状态可以过渡。

需要两个东西配合。@starting-style 提供起始帧,transition-behavior: allow-discrete 让 display 这个离散属性也能参与过渡:

dialog {
  opacity: 0;
  translate: 0 12px;
  transition: opacity .24s ease, translate .24s ease,
              display .24s allow-discrete,
              overlay .24s allow-discrete;
}

dialog[open] {
  opacity: 1;
  translate: 0 0;
}

@starting-style {
  dialog[open] {
    opacity: 0;
    translate: 0 12px;
  }
}

注意 overlay 那一行。dialog 和 popover 在 top layer 里的存在状态由 overlay 属性控制,如果不让它一起过渡,关闭动画播到一半元素就被移出顶层了,看起来像是”闪一下消失”。这个属性比较新,老浏览器会忽略,也不会报错,属于安全写法。

遮罩的动画要单独处理。::backdrop 不继承宿主元素的状态,得自己写一份 @starting-style:

dialog::backdrop {
  background: rgb(0 0 0 / 0);
  transition: background .24s ease, display .24s allow-discrete,
              overlay .24s allow-discrete;
}

dialog[open]::backdrop {
  background: rgb(0 0 0 / .45);
}

@starting-style {
  dialog[open]::backdrop {
    background: rgb(0 0 0 / 0);
  }
}

无障碍这块,原生只帮你做了一半

用 showModal() 打开后,焦点会自动进入 dialog,Tab 被限制在内部,关闭后焦点回到原来的元素——这些浏览器都处理好了,比自己写 focus trap 靠谱得多。但下面两件事仍然要手动补:

给 dialog 加可访问名称。没有名字的 dialog 在屏幕阅读器里只会读出”对话框”,用户不知道这是干什么的。用 aria-labelledby 指向标题,或者直接 aria-label:

<dialog id="confirm" aria-labelledby="confirm-title">
  <h2 id="confirm-title">删除确认</h2>
  ...
</dialog>

给 popover 补角色。popover 属性只管显示逻辑,不会自动加 role。下拉菜单要写 role="menu" 配合子项的 role="menuitem",气泡提示写 role="dialog" 或 role="tooltip"。另外触发按钮需要 aria-expanded 状态同步,虽然现代浏览器在 popovertarget 场景下会自动维护,但如果你是用 JS 调 showPopover(),那就得自己更新。

落地时的兼容策略

我对这套方案的定位是”渐进增强,兜底能跑”。具体做法是在入口加一次能力检测,把结果挂到一个全局变量上:

const supports = {
  dialog: typeof HTMLDialogElement !== 'undefined'
    && typeof HTMLDialogElement.prototype.showModal === 'function',
  popover: HTMLElement.prototype.hasOwnProperty('popover')
}
document.documentElement.dataset.dialog = supports.dialog ? 'yes' : 'no'
document.documentElement.dataset.popover = supports.popover ? 'yes' : 'no'

不支持的浏览器(主要是老版本 iOS Safari 和部分国产内核),加载一个轻量 polyfill。dialog 有个官方维护的 polyfill 包,体积不大;popover 的 polyfill 也有人在做,但功能覆盖不全,我的建议是 popover 场景直接降级成”点击切换 hidden 属性 + 手动监听 document click”,二十行代码的事,不必强上 polyfill。

另外要提醒一句,<dialog> 和 popover 都会把元素提升到 top layer,这一层高于所有 z-index。如果你的项目里有 toast 提示是固定定位加 z-index: 99999 的,弹窗打开后 toast 会被压在下面看不见。解决办法是把 toast 也改成 popover 或 dialog 的兄弟节点,让它们同在顶层里按 DOM 顺序排列。

最后一版代码长什么样

把上面这些拼起来,一个完整的确认弹窗大约是这样,不需要任何依赖:

function confirmDialog(message, { title = '提示', okText = '确定', cancelText = '取消' } = {}) {
  return new Promise((resolve) => {
    const dlg = document.createElement('dialog')
    dlg.setAttribute('aria-labelledby', 'dlg-title')
    dlg.innerHTML = `
      <form method="dialog">
        <h2 id="dlg-title">${escapeHtml(title)}</h2>
        <p>${escapeHtml(message)}</p>
        <button value="cancel" formnovalidate>${escapeHtml(cancelText)}</button>
        <button value="ok" formnovalidate>${escapeHtml(okText)}</button>
      </form>
    `
    document.body.appendChild(dlg)

    dlg.addEventListener('close', () => {
      resolve(dlg.returnValue === 'ok')
      dlg.remove()
    })

    dlg.showModal()
  })
}

用的时候就是 if (await confirmDialog('删除后不可恢复')) { ... },跟引入一个 UI 库的体验没区别,但体积是零。那次项目最后打包出来 47KB,省下的空间刚好够放一个图表库。

当然原生方案不是万能的。如果你的项目需要复杂的日期选择器、级联选择、可拖拽的抽屉,现成的组件库效率仍然高得多。但对确认框、下拉菜单、气泡提示这类高频又简单的弹层,原生能力已经够用,而且省下的每一 KB 都会体现在首屏时间上。

别急着装 UI 库:用原生 dialog 与 Popover API 实现能上线的弹层
收藏 (0) 打赏

感谢您的支持,我会继续努力的!

打开微信/支付宝扫一扫,即可进行扫码打赏哦,分享从这里开始,精彩与您同在
点赞 (0)

版权声明:
本站资源有的来自互联网收集整理,本站纯免费分享提供学习使用,如果侵犯了您的合法权益,请发送邮件1506151422@qq.com联系,将会及时下架删除。
本站资源仅供研究、学习交流之用,免费开源项目不代表完全可商用,若商业用途请先咨询开发企业能否商用,否则产生的一切后果将由下载用户自行承担。
原创板块未经允许不得转载,否则将追究法律责任。

淘吗网 html 别急着装 UI 库:用原生 dialog 与 Popover API 实现能上线的弹层 https://www.taomawang.com/web/html/3014.html

常见问题

相关文章

猜你喜欢
发表评论
暂无评论
官方客服团队

为您解决烦忧 - 24小时在线 专业服务