Popover 气泡卡片

点击或悬停弹出气泡卡片,常用于展示附加信息或操作面板。

基础用法
默认 hover 触发,鼠标移入显示气泡卡片。
触发方式
支持 hover、click、focus、manual 四种触发方式。
手动控制状态:隐藏
弹出位置
支持 12 个弹出方位。
不显示箭头
设置 arrow 为 false 可隐藏气泡箭头。
延迟显示/隐藏
设置 delay 来控制显示和隐藏的延迟时间(ms),可传入数组分别设置 [show, hide]。
自定义偏移距离
设置 offset 控制气泡与触发元素的距离(px)。
自定义宽度
设置 width 控制气泡卡片宽度,支持数字(px)或字符串。
带底部操作
使用 footer 插槽添加底部操作按钮。
自定义头部
使用 header 插槽自定义头部内容。
禁用状态
设置 disabled 时气泡卡片不会弹出。
嵌套复杂内容
气泡卡片内可以嵌入表格、表单等复杂内容。
方法调用
通过 ref 调用 show / hide 方法手动控制。
事件回调
监听 show / hide 事件。
暂无事件

Props

参数类型默认值说明
titlestring卡片标题
trigger'hover' | 'click' | 'focus' | 'manual''hover'触发方式
placement'top' | 'top-start' | 'top-end' | 'bottom' | 'bottom-start' | 'bottom-end' | 'left' | 'left-start' | 'left-end' | 'right' | 'right-start' | 'right-end''top'弹出位置,共 12 个方位
arrowbooleantrue是否显示箭头
offsetnumber8气泡与触发元素的间距(px)
widthnumber | string气泡卡片宽度
delaynumber | [number, number]延迟(ms),数字统一设置,数组分别设置 [show, hide]
disabledbooleanfalse是否禁用
modelValueboolean显隐状态,支持 v-model

Events

事件名说明
show气泡显示时触发
hide气泡隐藏时触发
update:modelValue显隐状态变化时触发
update:visible显隐状态变化时触发

Slots

插槽名说明
default气泡卡片内容
trigger触发元素
header自定义头部(设置后 title 不生效)
footer底部操作区域

Methods

方法名说明
show()显示气泡
hide()隐藏气泡
updatePos()更新气泡位置