dialog showModal 打开失败 浏览器不支持时怎么降级

现象

项目里用 dialog 元素加 showModal 做确认框,Chrome 正常,Safari 15 以下点按钮没反应,控制台提示 showModal is not a function;部分旧安卓 WebView 里弹窗直接内联显示在页面底部,遮罩和居中都没有。

原因

dialog 元素和 showModal 方法从 Safari 15.4 才开始支持,更早版本只把它当成未知行内元素,方法不存在。即使支持,没写 ::backdrop 样式时遮罩是透明的,看起来像没弹出。元素被移出文档后再调用 showModal,也会直接抛错。

解决步骤

第一步,先做能力检测,不支持时走自定义弹层。把 showFallbackModal 做成和原生表现一致的函数,样式复用同一套类名。

const dlg = document.querySelector("#confirm");
const supported =
  typeof dlg.showModal === "function";
if (supported) {
  dlg.showModal();
} else {
  showFallbackModal(dlg);
}

第二步,补遮罩和居中样式。::backdrop 设半透明背景,dialog 本身用固定定位加 margin:auto 居中,不要依赖浏览器默认样式,否则新旧版本位置差异明显。

第三步,管理焦点和关闭。打开时聚焦第一个按钮,关闭时把焦点还给触发元素;Esc 关闭依赖原生行为,降级版本要自己监听 keydown 补上。

验证

在 Chrome 和 Safari 上各点一次,弹窗居中且带遮罩;用 Tab 键确认焦点被限制在弹窗内,按 Esc 能正常关闭,关闭后焦点回到原按钮。

小结

dialog 的兼容分界线在 Safari 15.4。能力检测加降级弹层是底线,遮罩、居中、焦点管理补齐,老浏览器上也不会出现弹窗贴在页脚的情况。

您可以还会对下面的文章感兴趣: