Popover 气泡卡片
基础用法
与Tooltip相似,Popover也是基于ElPopper的构建。 因此对于重复属性,请参考 Tooltip 的文档,在此文档中不做详尽解释。
虚拟触发
像 Tooltip一样,Popover 可以由虚拟元素触发,这个功能就很适合使用在触发元素和展示内容元素是分开的场景。通常我们使用 #reference 来放置我们的触发元素, 用 triggering-element API,您可以任意设置您的触发元素 但注意到触发元素应该是接受 mouse 和 keyboard 事件的元素。
WARNING
v-popover 将被废弃,请使用 virtual-ref 作为替代。
内容可扩展
可以在 Popover 中嵌套其它组件, 以下为嵌套表格的例子。
嵌套操作
当然,你还可以嵌套操作, 它比使用dialog更加轻量
指令
您可以指令性方式弹出窗口,但不再推荐 **** ,因为这使您的应用程序 变得复杂, 您可以参考上述虚拟触发来实现一样的效果。
Popover 属性
| 属性 | 说明 | 类型 | 可选值 | 默认值 |
|---|---|---|---|---|
| trigger | 触发方式 | string | click/focus/hover/contextmenu | click |
| title | 标题 | string | — | — |
| effect | Tooltip theme, built-in theme: dark / light | string | string | dark |
| content | popover content, can be replaced with a default slot | string | — | — |
| width | popover width | string / number | — | Min width 150px |
| placement | popover placement | string | top/top-start/top-end/bottom/bottom-start/bottom-end/left/left-start/left-end/right/right-start/right-end | bottom |
| disabled | whether Popover is disabled | boolean | — | false |
| visible / v-model:visible | whether popover is visible | Boolean | — | false |
| offset | popover offset | number | — | 0 |
| transition | popover transition animation | string | — | el-fade-in-linear |
| show-arrow | whether a tooltip arrow is displayed or not. For more info, please refer to ElPopper | boolean | — | true |
| popper-options | parameters for popper.js | object | please refer to popper.js | { boundariesElement: 'body', gpuAcceleration: false } |
| popper-class | custom class name for popover | string | — | — |
| show-after | delay of appearance, in millisecond | number | — | 0 |
| hide-after | delay of disappear, in millisecond | number | — | 200 |
| auto-close | timeout in milliseconds to hide tooltip | number | — | 0 |
| tabindex | tabindex of Popover | number | — | — |
| teleported | whether popover dropdown is teleported to the body | boolean | true / false | true |
| persistent | when popover inactive and persistent is false , popover will be destroyed | boolean | — | true |
Popover 插槽
| 插槽名 | 说明 |
|---|---|
| — | Popover 内嵌 HTML 文本 |
| reference | 触发 Popover 显示的 HTML 元素 |
Popover 事件
| 事件名 | 说明 | 回调参数 |
|---|---|---|
| show | 显示时触发 | — |
| before-enter | triggers when the entering transition befores | — |
| after-enter | triggers when the entering transition ends | — |
| hide | triggers when popover hides | — |
| before-leave | triggers when the leaving transition befores | — |
| after-leave | triggers when the leaving transition ends | — |