浮层管理
在 VEUI 中,有大量组件使用到了浮层功能:
针对这些组件,我们抽离了具备如下功能的浮层模块:
- 能够浮于页面上所有普通元素之上;
- 能够进行层叠顺序管理;
- 能够基于指定元素定位。
层叠覆盖
为了避免浮层被上层 overflow: hidden
的元素意外遮盖,我们将浮层根元素直接置于 <body>
下统一管理。
在浮层组件中,.veui-overlay-box
对应了浮层根元素,该元素在组件初始化的时候,会被放置到 <body>
之下,组件销毁的时候,会被移除掉。
层叠顺序管理
在将浮层根元素置于 <body>
下后,原有的层级嵌套关系会丢失,同时也无法通过原生的层叠上下文机制来控制浮层的层叠顺序。比如:
- 某个对话框组件 A 上有一个下拉选择组件 B,那么 B 组件浮层应该位于 A 组件浮层之上。
- 警告框浮层应该位于普通对话框浮层之上。
基于上述限制,浮层模块实现了自己的层叠顺序管理机制。整个浮层层级嵌套关系,是通过一棵树来表达的:
树中每一个蓝色节点都对应关联到具体的浮层组件实例。针对上图,树的构造顺序可以是:
- 弹出“对话框 1”,创建一个“对话框 1”节点,根据节点权重信息创建一个分组,然后将分组挂在 root 节点之下。
- 弹出“对话框 2”,创建一个“对话框 2”节点,发现已经存在相同权重的分组,就直接将“对话框 2”节点放置在该分组的末尾位置。
- 在“对话框 2”中实例化一个“下拉选择 1”组件实例,由于“对话框 2”组件实例是“下拉选择 1”组件实例的父级,因此对应的浮层节点也应当具备父子关系,因此按照类似于“步骤 1”的顺序在“对话框 2”节点下生成分组及“下拉选择 1”节点。
- 此时由于程序运行出现了故障,弹出了“警告弹框 1”,由于“警告弹框”类型的组件相对于“对话框”组件具备更高的层级权重,因此在 root 之下新建了一个靠右的分组,并将生成的“警告弹框 1”节点置于分组末尾。
有了树之后,就会按照深度优先的遍历顺序生成每个节点的 z-index
值。
其中,基准 z-index
值可以通过全局配置对象进行配置:
import config from 'veui/managers/config'
config.set('overlay.baseZIndex', 200)
可以针对组件类型,甚至组件实例粒度设置层叠优先级,层叠优先级值越大,最终生成的 z-index
值就越大。具有相同层叠优先级的同级组件实例,越靠后实例化的组件,生成的 z-index
值越大。
浮层组件、对话框组件、弹框组件等提供了 priority
属性,用于自定义组件实例的层叠优先级:
<veui-dialog :priority="300"/>
一些比较特殊的组件,会提供基于组件类型粒度的层叠优先级配置:
组件 | 配置字段 | 默认值 | 修改配置示例 |
---|---|---|---|
警告弹框 | alertbox.priority | 100 |
|
确认弹框 | confirmbox.priority | 100 |
|
输入弹框 | promptbox.priority | 100 |
|
总结起来,确定某个浮层系组件实例的层叠优先级的逻辑流程为:
- 如果能够设置组件实例级别的层叠优先级,并且设置了,那么就使用这个层叠优先级值,否则进入下一步;
- 如果能够设置组件类型级别的层叠优先级,并且设置了,那么就使用这个层叠优先级值,否则进入下一步;
- 使用默认的层叠优先级值:
1
。
定位
VEUI 中,浮层支持两种定位方式:
- 在页面范围内,以坐标值的形式进行定位;
- 相对于某个元素,指定偏移和变换规则进行定位。
以坐标方式定位时,需要自己写 CSS 进行控制(浮层模块内部只会生成浮层根元素的 z-index
值)。
相对元素定位时,可以通过浮层组件的 options
属性描述偏移和变换规则。由于目前内部采用 Popper.js 实现,因此完整的配置项可以参考 Popper.js 官网。
样式
由于浮层根元素被手动放置到 <body>
元素之下了,要设置浮层内容的样式,就需要给浮层根元素指定 class
。所有浮层系组件都支持 overlay-class
属性,通过该属性为浮层根元素设置 class
:
<template>
<veui-dialog overlay-class="my-dialog-overlay"/>
<template>
<style>
.my-dialg-overlay {
/* 自定义浮层样式 */
}
</style>