原生弹窗怎么做?popover + dialog + command 属性实战拆解

2026-11-22 0 939

上个月接手一个后台项目,样式挺新,交互却全是老一套。打开源码一看,光弹窗就有四套实现:一套是自己写的 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——作用于 dialog
  • show-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。一步一步来,不用一次推倒重写。

原生弹窗怎么做?popover + dialog + command 属性实战拆解
收藏 (0) 打赏

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

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

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

淘吗网 html 原生弹窗怎么做?popover + dialog + command 属性实战拆解 https://www.taomawang.com/web/html/3036.html

常见问题

相关文章

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

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