Popover 气泡卡片

基础用法

与Tooltip相似,Popover也是基于ElPopper的构建。 因此对于重复属性,请参考 Tooltip 的文档,在此文档中不做详尽解释。

虚拟触发

像 Tooltip一样,Popover 可以由虚拟元素触发,这个功能就很适合使用在触发元素和展示内容元素是分开的场景。通常我们使用 #reference 来放置我们的触发元素, 用 triggering-element API,您可以任意设置您的触发元素 但注意到触发元素应该是接受 mousekeyboard 事件的元素。

WARNING

v-popover 将被废弃,请使用 virtual-ref 作为替代。

内容可扩展

可以在 Popover 中嵌套其它组件, 以下为嵌套表格的例子。

嵌套操作

当然,你还可以嵌套操作, 它比使用dialog更加轻量

指令

您可以指令性方式弹出窗口,但不再推荐 **** ,因为这使您的应用程序 变得复杂, 您可以参考上述虚拟触发来实现一样的效果。

Popover 属性

属性说明类型可选值默认值
trigger触发方式stringclick/focus/hover/contextmenuclick
title标题string
effectTooltip theme, built-in theme: dark / lightstringstringdark
contentpopover content, can be replaced with a default slotstring
widthpopover widthstring / numberMin width 150px
placementpopover placementstringtop/top-start/top-end/bottom/bottom-start/bottom-end/left/left-start/left-end/right/right-start/right-endbottom
disabledwhether Popover is disabledbooleanfalse
visible / v-model:visiblewhether popover is visibleBooleanfalse
offsetpopover offsetnumber0
transitionpopover transition animationstringel-fade-in-linear
show-arrowwhether a tooltip arrow is displayed or not. For more info, please refer to ElPopperbooleantrue
popper-optionsparameters for popper.jsobjectplease refer to popper.js{ boundariesElement: 'body', gpuAcceleration: false }
popper-classcustom class name for popoverstring
show-afterdelay of appearance, in millisecondnumber0
hide-afterdelay of disappear, in millisecondnumber200
auto-closetimeout in milliseconds to hide tooltipnumber0
tabindextabindex of Popovernumber
teleportedwhether popover dropdown is teleported to the bodybooleantrue / falsetrue
persistentwhen popover inactive and persistent is false , popover will be destroyedbooleantrue

Popover 插槽

插槽名说明
Popover 内嵌 HTML 文本
reference触发 Popover 显示的 HTML 元素

Popover 事件

事件名说明回调参数
show显示时触发
before-entertriggers when the entering transition befores
after-entertriggers when the entering transition ends
hidetriggers when popover hides
before-leavetriggers when the leaving transition befores
after-leavetriggers when the leaving transition ends