你可能不知道的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()
方法来主动关闭弹窗。
其实,还可以通过表单特性实现这样一个效果,具体做法是:
在 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-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
键如何切换,焦点不会跑到弹窗外面去,下面是一个对比效果
普通弹窗效果
模态弹窗效果
这个效果其实是和新出的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 其实也是在不断发展的,有必要把以前已经用过的再翻出来过一遍,说不定还能发现意想不到的结果,下面是要点总结
dialog
的打开和关闭方法很迷惑,分别是show() / close()
dialog
中表单元素在添加method=dialog
属性之后,只要触发表单提交就会自动关闭弹窗,无需额外 js通过 showModal()
可以打开模态弹窗,并且后打开的弹窗永远比先打开的弹窗层级要高,无需手动计算层级打开弹窗会自动聚焦到弹窗内的第一个可聚焦元素,方便快速输入 模态弹窗的焦点不会聚焦到弹窗外部,这和 inert
特性比较类似模态弹窗其实是渲染到了 html
文档流之外,一个叫#top-layer
的层级上,因此不会受到原父容器的影响
很多同学往往过于关注 JavaScript
和现代流行框架,而忽视了原生 dom
的发展,但原生 dom
带来的很多新特性往往是系统级别的,有可能你辛辛苦苦实现的一个功能,原生一个属性就搞定,而且效果更好,所以请不要忘了原生。最后,如果觉得还不错,对你有帮助的话,欢迎点赞、收藏、转发❤❤❤
参考资料
::backdrop: https://developer.mozilla.org/zh-CN/docs/Web/CSS/::backdrop
[2]xy-ui 中的 dialog 组件: https://xy-ui.codelabo.cn/docs/#/xy-dialog