css教程网 css教程网365css.cn
公告为您打开互联网世界的窗户关于本站
首页/实战/正文
RECIPES · 实战

模态框:<dialog> 的正确用法

showModal 自带焦点陷阱与 ESC 关闭,比手写遮罩层可靠得多。附动效与滚动锁定写法。

更新于 2026-10-28 阅读约 10 分钟 标签 组件 / 弹窗 / 无障碍

手写模态框要处理焦点陷阱、ESC 关闭、点击遮罩关闭、滚动锁定、aria-modal、返回焦点……少做一样就是无障碍缺陷。原生 <dialog> 把这些都内置了。

最简可用版本#

HTML
<dialog id="dlg">
  <h2>标题</h2>
  <p>内容。</p>
  <form method="dialog">
    <button value="cancel">取消</button>
    <button value="ok">确定</button>
  </form>
</dialog>

<button id="open">打开弹窗</button>
JS
const dlg = document.getElementById('dlg');
document.getElementById('open').onclick = () => dlg.showModal();
dlg.addEventListener('close', () => console.log('返回值', dlg.returnValue));

showModal() 会自动把弹窗放进 top layer(永远在最上层,不受父级 z-index 影响)、限制焦点在内部、支持 ESC 关闭、并在关闭后把焦点还给触发元素。

样式:遮罩与动效#

CSS
dialog {
  border: 0;
  border-radius: 16px;
  padding: 24px;
  width: min(480px, calc(100vw - 32px));
  box-shadow: 0 40px 80px -40px rgb(13 17 23 / .5);
}

dialog::backdrop {
  background: rgb(13 17 23 / .45);
  backdrop-filter: blur(2px);
}

/* 进场动画:从略微缩小到原位 */
dialog[open] { animation: pop .22s cubic-bezier(.2, .9, .3, 1); }
@keyframes pop { from { opacity: 0; transform: translateY(8px) scale(.98); } }

点击遮罩关闭#

原生不提供这个行为,但可以用事件坐标判断——点击发生在 dialog 元素本身(而不是内容)时说明点到了遮罩:

JS
dlg.addEventListener('click', (e) => {
  if (e.target === dlg) dlg.close('backdrop');
});

滚动锁定:一行 CSS#

CSS
html:has(dialog[open]) { overflow: hidden; }

比 JS 加 body.style.overflow = 'hidden' 干净,也不会因为忘记复原导致页面永久锁死。

该用 dialog 还是 popover#

  • dialog + showModal:需要用户处理、阻塞页面的场景(确认删除、登录)。
  • popover:非阻塞的轻量浮层(菜单、气泡提示),点外面自动关。
  • 普通绝对定位:只是视觉装饰,不涉及交互。

选错组件比写错样式影响更大。确认框用 popover,用户会误触背景;下拉菜单用 dialog,会锁住整个页面。