mirror of
https://github.com/element-plus/element-plus.git
synced 2026-03-13 07:51:17 +08:00
130 lines
16 KiB
Markdown
130 lines
16 KiB
Markdown
---
|
|
title: Popover
|
|
lang: en-US
|
|
---
|
|
|
|
# Popover
|
|
|
|
## Placement
|
|
|
|
Popover has 9 placements.
|
|
|
|
:::demo Use attribute `content` to set the display content when hover. The attribute `placement` determines the position of the Popover. Its value is `[orientation]-[alignment]` with four orientations `top`, `left`, `right`, `bottom` and three alignments `start`, `end`, `null`, and the default alignment is null. Take `placement="left-end"` for example, Popover will display on the left of the element which you are hovering and the bottom of the Popover aligns with the bottom of the element.
|
|
|
|
popover/placement
|
|
|
|
:::
|
|
|
|
## Basic usage
|
|
|
|
Popover is built with `ElTooltip`. So for some duplicated attributes, please refer to the documentation of Tooltip.
|
|
|
|
:::demo 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`.
|
|
|
|
popover/basic-usage
|
|
|
|
:::
|
|
|
|
## 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.
|
|
|
|
:::
|
|
|
|
:::demo
|
|
|
|
popover/virtual-triggering
|
|
|
|
:::
|
|
|
|
## Rich content
|
|
|
|
Other components/elements can be nested in popover. Following is an example of nested table.
|
|
|
|
:::demo replace the `content` attribute with a default `slot`.
|
|
|
|
popover/nested-information
|
|
|
|
:::
|
|
|
|
## Nested operation
|
|
|
|
Of course, you can nest other operations. It's more light-weight than using a dialog.
|
|
|
|
:::demo
|
|
|
|
popover/nested-operation
|
|
|
|
:::
|
|
|
|
## 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.
|
|
|
|
:::demo
|
|
|
|
popover/directive-usage
|
|
|
|
:::
|
|
|
|
## API
|
|
|
|
### Attributes
|
|
|
|
| Name | Description | Type | Default |
|
|
| ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------- |
|
|
| trigger | how the popover is triggered, not valid in controlled mode | ^[enum]`'click' \| 'focus' \| 'hover' \| 'contextmenu'` / ^[object]`Array<'click' \| 'focus' \| 'hover' \| 'contextmenu'>` | hover |
|
|
| trigger-keys ^(2.9.8) | When you click the mouse to focus on the trigger element, you can define a set of keyboard codes to control the display of popover through the keyboard, not valid in controlled mode | ^[Array] | ['Enter','Space'] |
|
|
| title | popover title | ^[string] | — |
|
|
| effect | Tooltip theme, built-in theme: `dark` / `light` | ^[enum]`'dark' \| 'light'` / ^[string] | light |
|
|
| content | popover content, can be replaced with a default `slot` | ^[string] | '' |
|
|
| width | popover width | ^[string] / ^[number] | 150 |
|
|
| placement | popover placement | ^[enum]`'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] / ^[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](https://github.com/element-plus/element-plus/tree/dev/packages/components/popper) | ^[boolean] | true |
|
|
| popper-options | parameters for [popper.js](https://popper.js.org/docs/v2/) | ^[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, not valid in controlled mode | ^[number] | 0 |
|
|
| hide-after | delay of disappear, in millisecond, not valid in controlled mode | ^[number] | 200 |
|
|
| auto-close | timeout in milliseconds to hide tooltip, not valid in controlled mode | ^[number] | 0 |
|
|
| tabindex | [tabindex](https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/tabindex) of Popover | ^[number] / ^[string] | 0 |
|
|
| teleported | whether popover dropdown is teleported to the body | ^[boolean] | true |
|
|
| append-to ^(2.9.10) | which element the popover CONTENT appends to | ^[CSSSelector] / ^[HTMLElement] | body |
|
|
| persistent | when popover inactive and `persistent` is `false` , popover will be destroyed | ^[boolean] | true |
|
|
| virtual-triggering | Indicates whether virtual triggering is enabled | ^[boolean] | — |
|
|
| virtual-ref | Indicates the reference element to which the popover is attached | ^[HTMLElement] | — |
|
|
| [tooltip](./tooltip.md#attributes) | Inherits all attributes from Tooltip | — | — |
|
|
|
|
### Slots
|
|
|
|
| Name | Description |
|
|
| --------- | -------------------------------------------------------------------------- |
|
|
| default | text content of popover |
|
|
| reference | HTML element that triggers popover, only a single root element is accepted |
|
|
|
|
### Events
|
|
|
|
| Name | Description | Type |
|
|
| ------------ | -------------------------------------------- | ----------------------- |
|
|
| show | triggers when popover shows | ^[Function]`() => void` |
|
|
| before-enter | triggers when the entering transition before | ^[Function]`() => void` |
|
|
| after-enter | triggers when the entering transition ends | ^[Function]`() => void` |
|
|
| hide | triggers when popover hides | ^[Function]`() => void` |
|
|
| before-leave | triggers when the leaving transition before | ^[Function]`() => void` |
|
|
| after-leave | triggers when the leaving transition ends | ^[Function]`() => void` |
|
|
|
|
### Exposes
|
|
|
|
| Name | Description | Type |
|
|
| ---- | ------------ | ----------------------- |
|
|
| hide | hide popover | ^[Function]`() => void` |
|