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
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
title | string | — | 卡片标题 |
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 个方位 |
arrow | boolean | true | 是否显示箭头 |
offset | number | 8 | 气泡与触发元素的间距(px) |
width | number | string | — | 气泡卡片宽度 |
delay | number | [number, number] | — | 延迟(ms),数字统一设置,数组分别设置 [show, hide] |
disabled | boolean | false | 是否禁用 |
modelValue | boolean | — | 显隐状态,支持 v-model |
Events
| 事件名 | 说明 |
|---|---|
show | 气泡显示时触发 |
hide | 气泡隐藏时触发 |
update:modelValue | 显隐状态变化时触发 |
update:visible | 显隐状态变化时触发 |
Slots
| 插槽名 | 说明 |
|---|---|
default | 气泡卡片内容 |
trigger | 触发元素 |
header | 自定义头部(设置后 title 不生效) |
footer | 底部操作区域 |
Methods
| 方法名 | 说明 |
|---|---|
show() | 显示气泡 |
hide() | 隐藏气泡 |
updatePos() | 更新气泡位置 |