Popover
Basic usage
Popover is built with ElTooltip
. So for some duplicated attributes, please refer to the documentation of Tooltip.
The trigger
attribute is used to define how popover is triggered: hover
, click
, focus
or contextmenu
. If you want to manually control it, you can set :visible
.
Virtual triggering
Like Tooltip, Popover can be triggered by virtual elements, if your use case includes separate the triggering element and the content element, you should definitely use the mechanism, normally we use #reference
to place our triggering element, with triggering-element
API you can set your triggering element anywhere you like, but notice that the triggering element should be an element that accepts mouse
and keyboard
event.
WARNING
v-popover
is about to be deprecated, please use virtual-ref
as alternative.
Rich content
Other components/elements can be nested in popover. Following is an example of nested table.
replace the content
attribute with a default slot
.
Nested operation
Of course, you can nest other operations. It's more light-weight than using a dialog.
Directive
You can still using popover in directive way but this is not recommended anymore since this makes your application complicated, you may refer to the virtual triggering for more information.
API
Attributes
Name | Description | Type | Default |
---|---|---|---|
trigger | how the popover is triggered | enum | hover |
title | popover title | string | — |
effect | Tooltip theme, built-in theme: dark / light | enum / string | light |
content | popover content, can be replaced with a default slot | string | '' |
width | popover width | string / number | 150 |
placement | popover placement | enum | bottom |
disabled | whether Popover is disabled | boolean | false |
visible / v-model:visible | whether popover is visible | boolean / null | null |
offset | popover offset, Popover is built with Tooltip , offset of Popover is undefined , but offset of Tooltip is 12 | number | undefined |
transition | popover transition animation, the default is el-fade-in-linear | string | — |
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 | {modifiers: [{name: 'computeStyles',options: {gpuAcceleration: false}}]} |
popper-class | custom class name for popover | string | — |
popper-style | custom style for popover | string / object | — |
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 / string | 0 |
teleported | whether popover dropdown is teleported to the body | boolean | true |
persistent | when popover inactive and persistent is false , popover will be destroyed | boolean | true |
Slots
Name | Description |
---|---|
default | text content of popover |
reference | HTML element that triggers popover |
Events
Name | Description | Type |
---|---|---|
show | triggers when popover shows | Function |
before-enter | triggers when the entering transition before | Function |
after-enter | triggers when the entering transition ends | Function |
hide | triggers when popover hides | Function |
before-leave | triggers when the leaving transition before | Function |
after-leave | triggers when the leaving transition ends | Function |
Exposes
Name | Description | Type |
---|---|---|
hide | hide popover | Function |