Popover
Placement
Popover has 9 placements.
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.
Uso básico
Popover is built with ElTooltip. Así que para algunos atributos duplicados, por favor consulte la documentación del Tooltip.
El atributo trigger es usado para definir como el popover se dispara: hover, click, focus o contextmenu. Si quieres controlarlo manualmente, puedes establecer :visible.
Activación virtual
Como el Tooltip, un Popover puede ser activado por elementos virtuales; si su caso de uso incluye separar el elemento de activación y el elemento de contenido, definitivamente debe usar el mecanismo, normalmente usamos #reference para colocar nuestro elemento desencadenante, con la API de triggering-element puede establecer su elemento desencadenante en cualquier lugar que desee, pero tenga en cuenta que el elemento de activación debe ser un elemento que acepte los eventos de mouse y keyboard.
WARNING
v-popover está a punto de ser obsoleta, por favor use virtual-ref como alternativa.
Contenido rico
Otros componentes/elementos pueden ser anidados en el popover. A continuación se muestra un ejemplo de tabla anidada.
Reemplaza el atributo content con un default slot.
Operación anidada
Por supuesto, puede anidar otras operaciones. Es más ligero que usar un dialog.
Directivas
Aún puede usar popover en la forma de directiva, pero esto no es recomendable, ya que esto hace que su aplicación sea complicada, puede referirse la Activación virtual para más información.
API
Atributos
| Nombre | Descripción | Tipo | Default |
|---|---|---|---|
| trigger | how the popover is triggered, not valid in controlled mode | enum | 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 | título del popover | string | — |
| effect | Popover tiene dos temas: dark y light | enum / string | light |
| content | contenido del popover, puede ser sustituido por un default slot | string | '' |
| width | ancho del popover | string / number | 150 |
| placement | posición del popover | enum | bottom |
| disabled | si el popover está deshabilitado | boolean | false |
| visible / v-model:visible | si el popover está 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 | si una flecha del tooltip es mostrada o no. Para obtener más información, consulte ElPopper | boolean | true |
| popper-options | parámetros para popper.js | object | {modifiers: [{name: 'computeStyles',options: {gpuAcceleration: false}}]} |
| popper-class | nombre de clase personalizada para el componente | string | — |
| popper-style | estilo personalizado para el 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 del Popover | number / string | 0 |
| teleported | si el desplegable del popover se teletransporta al body | boolean | true |
| append-to 2.9.10 | which element the popover CONTENT appends to | CSSSelector / HTMLElement | body |
| persistent | cuando el popover esté inactivo y persistent sea false, el popover será destruido | 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 | Inherits all attributes from Tooltip | — | — |
Slots
| Nombre | Descripción |
|---|---|
| default | texto contenido en popover |
| reference | Elemento HTML que dispara el popover |
Eventos
| Name | Descripción | Type |
|---|---|---|
| show | se dispara cuando se muestra el popover | Function |
| before-enter | se dispara cuando la transición de entrada comienza | Function |
| after-enter | se dispara cuando la transición de entrada termina | Function |
| hide | se dispara cuando se oculta el popover | Function |
| before-leave | se dispara cuando la transición de salida comienza | Function |
| after-leave | se dispara cuando la transición de salida termina | Function |
Exposes
| Name | Description | Type |
|---|---|---|
| hide | hide popover | Function |
Fuente
Componentes • Style • Documentación