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 / array | hover |
| trigger-keys | 鼠标聚焦触发元素后,可用键盘码控制显示,受控模式下无效 | Array | ['Enter','Space'] |
| title | 标题 | string | — |
| effect | 主题,内置 dark / light | enum / string | light |
| content | 内容,可用默认插槽替代 | string | '' |
| width | 宽度 | string / number | 150 |
| placement | 出现位置 | enum | bottom |
| disabled | 是否禁用 | boolean | false |
| visible / v-model:visible | 是否显示 | boolean / null | null |
| offset | 偏移;Popover 基于 Tooltip,Popover 默认为 undefined,Tooltip 默认为 12 | number | undefined |
| transition | 过渡动画名,默认 el-fade-in-linear | string | — |
| show-arrow | 是否显示箭头,详见 UPopper | boolean | true |
| popper-options | popper.js 参数 | object | {modifiers: [{name: 'computeStyles',options: {gpuAcceleration: false}}]} |
| popper-class | 浮层自定义类名 | string | — |
| popper-style | 浮层自定义样式 | string / object | — |
| show-after | 延迟显示(毫秒),受控模式下无效 | number | 0 |
| hide-after | 延迟隐藏(毫秒),受控模式下无效 | number | 200 |
| auto-close | 自动隐藏超时(毫秒),受控模式下无效 | number | 0 |
| tabindex | tabindex | number / string | 0 |
| teleported | 是否将下拉传送到 body | boolean | true |
| append-to | 气泡内容挂载到的元素 | CSSSelector / HTMLElement | body |
| persistent | 失活且为 false 时销毁 | boolean | true |
| 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 |