模态框:<dialog> 的正确用法
showModal 自带焦点陷阱与 ESC 关闭,比手写遮罩层可靠得多。附动效与滚动锁定写法。
手写模态框要处理焦点陷阱、ESC 关闭、点击遮罩关闭、滚动锁定、aria-modal、返回焦点……少做一样就是无障碍缺陷。原生 <dialog> 把这些都内置了。
最简可用版本#
<dialog id="dlg">
<h2>标题</h2>
<p>内容。</p>
<form method="dialog">
<button value="cancel">取消</button>
<button value="ok">确定</button>
</form>
</dialog>
<button id="open">打开弹窗</button>const dlg = document.getElementById('dlg');
document.getElementById('open').onclick = () => dlg.showModal();
dlg.addEventListener('close', () => console.log('返回值', dlg.returnValue));showModal() 会自动把弹窗放进 top layer(永远在最上层,不受父级 z-index 影响)、限制焦点在内部、支持 ESC 关闭、并在关闭后把焦点还给触发元素。
样式:遮罩与动效#
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 元素本身(而不是内容)时说明点到了遮罩:
dlg.addEventListener('click', (e) => {
if (e.target === dlg) dlg.close('backdrop');
});滚动锁定:一行 CSS#
html:has(dialog[open]) { overflow: hidden; }比 JS 加 body.style.overflow = 'hidden' 干净,也不会因为忘记复原导致页面永久锁死。
该用 dialog 还是 popover#
- dialog + showModal:需要用户处理、阻塞页面的场景(确认删除、登录)。
- popover:非阻塞的轻量浮层(菜单、气泡提示),点外面自动关。
- 普通绝对定位:只是视觉装饰,不涉及交互。
选错组件比写错样式影响更大。确认框用 popover,用户会误触背景;下拉菜单用 dialog,会锁住整个页面。