Popover 气泡卡片 ​

位置 ​

共 9 种方位。

content 设置悬停时展示内容;placement 为 [方向]-[对齐]:方向含 top、left、right、bottom,对齐含 start、end、空(默认)。例如 placement="left-end" 表示在左侧展示,且底部与参考元素底部对齐。

基础用法 ​

基于 UTooltip 实现,重复属性参见文字提示。

trigger 定义触发方式:hover、click、focus 或 contextmenu;需手动控制时可绑定 :visible。

虚拟触发 ​

与文字提示相同,可通过虚拟元素触发;触发器与内容分离时推荐使用 #reference 放置触发元素,或使用 virtual-ref 将触发器放在任意可接收鼠标与键盘事件的元素上。

WARNING

v-popover 即将弃用,请改用 virtual-ref。

富内容 ​

可在气泡内嵌套其他组件或元素,例如表格。

使用默认插槽替代 content 属性。

嵌套操作 ​

可嵌套更轻量的交互,替代对话框。

指令 ​

仍支持指令用法,但不推荐,易增加复杂度;建议了解虚拟触发方式。

气泡卡片 API ​

气泡卡片 属性 ​

名称说明类型默认值
trigger触发方式,受控模式下无效enum / arrayhover
trigger-keys鼠标聚焦触发元素后,可用键盘码控制显示,受控模式下无效Array['Enter','Space']
title标题string—
effect主题,内置 dark / lightenum / stringlight
content内容,可用默认插槽替代string''
width宽度string / number150
placement出现位置enumbottom
disabled是否禁用booleanfalse
visible / v-model:visible是否显示boolean / nullnull
offset偏移;Popover 基于 Tooltip,Popover 默认为 undefined,Tooltip 默认为 12numberundefined
transition过渡动画名,默认 el-fade-in-linearstring—
show-arrow是否显示箭头,详见 UPopperbooleanfalse
popper-optionspopper.js 参数object{modifiers: [{name: 'computeStyles',options: {gpuAcceleration: false}}]}
popper-class浮层自定义类名string—
popper-style浮层自定义样式string / object—
show-after延迟显示(毫秒),受控模式下无效number0
hide-after延迟隐藏(毫秒),受控模式下无效number200
auto-close自动隐藏超时(毫秒),受控模式下无效number0
tabindextabindexnumber / string0
teleported是否将下拉传送到 bodybooleantrue
append-to气泡内容挂载到的元素CSSSelector / HTMLElementbody
persistent失活且为 false 时销毁booleantrue
virtual-triggering是否启用虚拟触发boolean—
virtual-ref虚拟触发时的参考元素HTMLElement—
文字提示继承 Tooltip 全部属性——

气泡卡片 插槽 ​

名称说明类型
default气泡内容;可接收 hide 参数object
reference触发元素,仅接受单一根元素-

气泡卡片 事件 ​

名称说明类型
show显示时Function
before-enter进入过渡开始前Function
after-enter进入过渡结束后Function
hide隐藏时Function
before-leave离开过渡开始前Function
after-leave离开过渡结束后Function

气泡卡片 暴露 ​

名称说明类型
hide隐藏气泡Function