2021-10-22 19:32:39 +08:00
---
lang: en-US
2021-10-25 13:57:18 +08:00
type: component
2021-10-22 19:32:39 +08:00
---
2021-09-17 00:18:50 +08:00
# Popover
2020-08-13 15:18:26 +08:00
2021-09-17 00:18:50 +08:00
## Basic usage
2020-08-13 15:18:26 +08:00
Similar to Tooltip, Popover is also built with `Vue-popper` . So for some duplicated attributes, please refer to the documentation of Tooltip.
2020-11-29 18:50:46 +08:00
:::demo The `trigger` attribute is used to define how popover is triggered: `hover` , `click` , `focus` or `manual` . As for the triggering element, you can write it in two different ways: use the `#reference` named slot, or use the `v-popover` directive and set it to Popover's `ref` .
2020-08-13 15:18:26 +08:00
2021-09-17 00:18:50 +08:00
popover/basic-usage
2021-09-04 19:29:28 +08:00
2020-08-13 15:18:26 +08:00
:::
2021-09-17 00:18:50 +08:00
## Nested information
2020-08-13 15:18:26 +08:00
Other components can be nested in popover. Following is an example of nested table.
:::demo replace the `content` attribute with a default `slot` .
2021-09-17 00:18:50 +08:00
popover/nested-information
2021-09-04 19:29:28 +08:00
2020-08-13 15:18:26 +08:00
:::
2021-09-17 00:18:50 +08:00
## Nested operation
2020-08-13 15:18:26 +08:00
Of course, you can nest other operations. It's more light-weight than using a dialog.
:::demo
2021-09-04 19:29:28 +08:00
2021-09-17 00:18:50 +08:00
popover/nested-operation
2021-09-04 19:29:28 +08:00
2020-08-13 15:18:26 +08:00
:::
2021-09-17 00:18:50 +08:00
## Attributes
2021-09-04 19:29:28 +08:00
| Attribute | Description | Type | Accepted Values | Default |
| ------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- | --------------- | --------------------------------------------------------------------------------------------------------- | ------------------------------------------------------- |
| trigger | how the popover is triggered | string | click/focus/hover/manual | click |
| title | popover title | string | — | — |
| 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 [Vue-popper ](https://github.com/element-component/vue-popper ) | boolean | — | true |
| popper-options | parameters for [popper.js ](https://popper.js.org/documentation.html ) | object | please refer to [popper.js ](https://popper.js.org/documentation.html ) | `{ 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 | — | 0 |
| auto-close | timeout in milliseconds to hide tooltip | number | — | 0 |
| tabindex | [tabindex ](https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/tabindex ) of Popover | number | — | — |
2020-08-13 15:18:26 +08:00
2021-09-17 00:18:50 +08:00
## Slots
2021-09-04 19:29:28 +08:00
| Name | Description |
| --------- | ---------------------------------- |
| — | text content of popover |
2020-08-13 15:18:26 +08:00
| reference | HTML element that triggers popover |
2021-09-17 00:18:50 +08:00
## Events
2021-09-04 19:29:28 +08:00
| Event Name | Description | Parameters |
| ----------- | ------------------------------------------ | ---------- |
| show | triggers when popover shows | — |
| after-enter | triggers when the entering transition ends | — |
| hide | triggers when popover hides | — |
| after-leave | triggers when the leaving transition ends | — |
