你可能不知道的dialog弹窗

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

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

  • 打开和关闭方法
// 打开弹窗
dialog.show()
// 打开关闭
dialog.close()
  • 默认打开
<dialog open></dialog>

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

表单提交特性

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

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

<dialog>
  <h3>欢迎关注</h3>
  <button>关闭</button>
</dialog>

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

  • 其实,还可以通过表单特性实现这样一个效果,具体做法是:
    • 在dialog中嵌套一层form
    • 给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-methodopen in new window

默认情况下,表单里的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>

模态窗口特性

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

dailog.showModal()

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

这个半透明的背景并不是普通的元素,而是一个叫做::backdropopen in new window的伪元素控制的,并且目前只有通过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键如何切换,焦点不会跑到弹窗外面去。

这个效果其实是和新出的inertopen in new window属性作用比较类似的,但是要比inert出现的更早,也可以说是通过inert属性将这种隔离特性通用化了,让平民老百姓也可以享受这种高级特性。

顶层特性 top-layer

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

不知道大家有没有遇到这样的问题,有些弹窗由于业务需要,不得已写在了某些容器下面,即便是fixed定位,也会有失效的时候。

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

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

但现在,有了全新的 top-layer ,一切都好办了。

你会发现,虽然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 带来的很多新特性往往是系统级别的,有可能你辛辛苦苦实现的一个功能,原生一个属性就搞定,而且效果更好,所以请不要忘了原生。

贡献者: mankueng