Popover 气泡卡片

位置

共 9 种方位。

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

基础用法

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

trigger 定义触发方式:hoverclickfocuscontextmenu;需手动控制时可绑定 :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 基于 TooltipPopover 默认为 undefinedTooltip 默认为 12numberundefined
transition过渡动画名,默认 el-fade-in-linearstring
show-arrow是否显示箭头,详见 UPopperbooleantrue
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