你可能不知道的dialog弹窗

想必大家都知道 HTML5 中有 dialog 这样一个标签，顾名思义，就是“弹窗”。

除了有良好的语义外，随着浏览器的不断更新迭代，还出现了许多你可能不知道的特性，快速了解一下吧~

一、打开和关闭方法

首先，在不查阅任何官方文档的情况下，先做一个选择题目

请问：下面哪组方法（打开/关闭）是合法的？

思考 10 秒...

🤔

🤔

🤔

🤔

正确答案是 C，也就是

// 打开弹窗
dialog.show()
// 打开关闭
dialog.close()

很多同学可能会觉得是 A 或者 B，但是官方文档上确是 C，确实是一个令人迷惑的方法。至于原因，有解释说，dialog是存在于页面上的元素，所以打开用show，而关闭表示中断弹窗内的行为，所以用close，只能说有联系，但比较牵强，或许就是规范设计疏忽了，大家记住就好。

还有一个，如果需要弹窗默认显示，大家先猜猜看？

再来思考 10 秒...

🤔

🤔

🤔

🤔

正确答案是 B，也就是

<dialog open></dialog>

🤣是不是又和上面的show()对不上了？

除了dialog元素，details元素的打开属性也是open

二、表单提交特性

弹窗很多时候的作用都是充当表单输入。

比如一个弹窗中需要有一个关闭或者取消按钮

<dialog>
  <h3>欢迎关注前端侦探</h3>
  <button>关闭</button>
</dialog>

通常情况下，我们可能需要用到前面提到的dialog.close()方法来主动关闭弹窗。

其实，还可以通过表单特性实现这样一个效果，具体做法是：

1. 在dialog中嵌套一层form
2. 给form添加一个method=dialog属性

如下

<dialog>
  <form method="dialog">
    <h3>欢迎关注前端侦探</h3>
    <button>关闭</button>
  </form>
</dialog>

这样就可以不用绑定额外的事件来实现关闭功能了，效果如下

其实原因就在于表单上的method=dialog属性，如果表单在dialog元素中，提交时就会触发关闭对话框

https://developer.mozilla.org/zh-CN/docs/Web/HTML/Element/form#attr-method

默认情况下，表单里的button都会触发提交，等同于type=submit，但如果设置了type=button或者type=reset，则不会触发表单提交，自然也不会关闭弹窗

<dialog>
  <form method="dialog">
    <h3>欢迎关注前端侦探</h3>
    <button>关闭</button>
    <button type="button">不会关闭</button>
  </form>
</dialog>

效果如下

另外还有一个小特性，dialog还有一个returnValue属性，可以返回表单中提交按钮的value值

<dialog>
  <form method="dialog">
    <h3>欢迎关注前端侦探</h3>
    <button value="AAA">提交</button>
  </form>
</dialog>

在提交后可以打印弹窗的returnValue，如下

不过暂时还没有想到很有用的场景

三、模态窗口特性

弹窗除了可以通过dialog.show()打开之外，还提供了一个模态窗口，方法是

dailog.showModal()

通过这个方法打开的弹窗，会自带一个半透明的背景，并且完全水平垂直居中

这个半透明的背景并不是普通的元素，而是一个叫做::backdrop^[1]的伪元素控制的，并且目前只有通过dailog.showModal()这个方法才能生成

要自定义背景也很容易

dialog::backdrop {
  background: rgba(255,0,0,.25);
}

这样就变成了半透明红色

如果希望打开弹窗有动画，可以自定义默认样式，通过visibility的方式实现隐藏显示

dialog{
  position: fixed;
  margin: auto;
  inset: 0;
  width: fit-content;
  height: fit-content;
  display: block;
  visibility: hidden;
  opacity: 0;
  transform: translateY(100px);
  transition: .2s;
}
dialog[open] {
  visibility: visible;
  opacity: 1;
  transform: translateY(0);
}

效果如下

其实这里我是不太建议动画的，弹窗就是要反应快速，加了动画反而会拖累整体。

另外，还可以通过:modal伪类来区分是普通弹窗还是模态弹窗

dialog:modal{
  /*模态弹窗*/
}
dialog:not(:modal){
  /*普通弹窗*/
}

这样可以更多进行自定义行为

模态弹窗还有一个非常省心的点，就是无需关注层级。它有一套非常直观的规则，哪个后打开，哪个层级最高，比如这样两个弹窗

<dialog id="dialog2">
  ...
</dialog>
<dialog id="dialog1">
  ...
  <button type="button">打开弹窗2</button>
  ...
</dialog>

在不指定层级的情况下，肯定是后面的层级更高，但如果是通过dialog.showModal打开，就非常直观了，后打开的弹窗肯定会覆盖前面的，效果如下

说到这里，我又想到了一些UI组件库里大到可怕的z-index，大概率就是通过计算不断叠加得出的

四、焦点隔离特性

除了上面一些比较直观的特性外，还有一些可能会忽略的，比如焦点的控制。

默认情况下，打开弹窗后会自动聚焦到弹窗内的第一个可聚焦元素上

还可以有input输入框

<dialog>
  <form method="dialog">
    <h3>欢迎关注前端侦探</h3>
    <input name="txt">
    <button>关闭</button>
  </form>
</dialog>

打开弹窗后可以直接输入，无需额外操作，简直不要太方便

注意，注意，注意：经测试发现，如果添加了打开动画，聚焦特性就会失效

当然，这些只是小儿科，一点点额外的 JS 也能解决，下面介绍一个系统级别的焦点隔离特性。什么意思呢？就是说在打开弹窗后，弹窗就成了一个独立的载体，焦点只能在这个范围内移动，也就是说，无论tab键如何切换，焦点不会跑到弹窗外面去，下面是一个对比效果

1. 普通弹窗效果

2. 模态弹窗效果

这个效果其实是和新出的inert属性作用比较类似的，但是要比inert出现的更早，也可以说是通过inert属性将这种隔离特性通用化了，让平民老百姓也可以享受这种高级特性。有兴趣的可以访问我之前的这篇文章：快速了解 inert 属性

五、顶层特性 top-layer

最后介绍一个即便是 JS 也无法模拟的系统级新特性，top-layer。

不知道大家有没有遇到这样的问题，有些弹窗由于业务需要，不得已写在了某些容器下面，即便是fixed定位，也会有失效的时候，比如下面这个例子，父容器如果有transform相关属性并且超出隐藏，就会出现这样被裁剪的情形

上面这个例子来源于 xy-ui 中的 dialog 组件^[2]，后续优化，敬请期待~

在以前，或者说很多框架中，都会想办法把弹窗放到最外层的 body下，这样就不受影响了，比如下面是vue3中的处理方式

<div>
  <Teleport to="body"> <!--将子内容传送到body下-->
   <dialog></dialog>
  </Teleport>
</div>

但现在，有了全新的 top-layer ，一切都好办了，比如下面是一个通过dialog.showModal()打开的弹窗

你会发现，虽然dialog仍然在原来位置上，但真正渲染到了一个#top-layer的层级上，这个层级非常特殊，已经超越了html文档流，可以说是独一档的存在，这样，无论的dialog在什么位置，最后渲染的地方其实都在#top-layer层级上，自然也不会被父容器裁剪被隐藏了，示意如下

是不是和现代框架有些许类似呢？下面是一个弹窗里嵌套另外一个弹窗

<dialog id="dialog1">
  ...
  <button type="button" >打开弹窗2</button>
  <dialog id="dialog2">
  ...
  </dialog>
</dialog>

效果如下

其实这也是后打开的弹窗永远要高于之前弹窗的原因，#top-layer是动态创建的，只有打开的弹窗才会渲染到该层级之下。

另外，经测试发现，firefox 以及 safari 虽然在开发者工具上看不到#top-layer，但是dialog表现基本几乎一致，应该是已经成为了标准规范，日后可以放心使用。

六、dom 其实也是在不断发展的

dialog其实我在两三年之前就有研究过，那时还没有这么多新特性，也有可能是研究不精，后来就搁置了，然后最近在项目中用了dialog，无意中又发现了很多有意思的新特性，这意味着，dom 其实也是在不断发展的，有必要把以前已经用过的再翻出来过一遍，说不定还能发现意想不到的结果，下面是要点总结

1. dialog 的打开和关闭方法很迷惑，分别是show() / close()
2. dialog中表单元素在添加method=dialog属性之后，只要触发表单提交就会自动关闭弹窗，无需额外 js
3. 通过showModal()可以打开模态弹窗，并且后打开的弹窗永远比先打开的弹窗层级要高，无需手动计算层级
4. 打开弹窗会自动聚焦到弹窗内的第一个可聚焦元素，方便快速输入
5. 模态弹窗的焦点不会聚焦到弹窗外部，这和inert特性比较类似
6. 模态弹窗其实是渲染到了html文档流之外，一个叫#top-layer的层级上，因此不会受到原父容器的影响

很多同学往往过于关注 JavaScript和现代流行框架，而忽视了原生 dom 的发展，但原生 dom 带来的很多新特性往往是系统级别的，有可能你辛辛苦苦实现的一个功能，原生一个属性就搞定，而且效果更好，所以请不要忘了原生。最后，如果觉得还不错，对你有帮助的话，欢迎点赞、收藏、转发❤❤❤

参考资料