Tooltip ​

Mostrar aviso de información con el hover del mouse.

Uso básico ​

Tooltip tiene 9 colocaciones.

Use el atributo content para establecer el contenido que se mostrará al hacer hover. El atributo placement determina la posición del tooltip. Su valor es [orientation]-[alignment] con cuatro orientaciones top, left, right, bottom y tres alineaciones start, end, null, la alineación default es null. Tome placement="left-end" como ejemplo, Tooltip será mostrado en la izquierda del elemento en que se esté haciendo hover y el fondo del tooltip se alineará con el fondo del elemento.

Temas ​

Tooltip tiene dos temas: dark y light.

TIP

Para utilizar un tema personalizado, tendrá que saber en dónde se renderiza la información, si el tooltip se procesa en el elemento raíz necesitará establecer la regla css globalmente.

Se recomienda que no utilice degradado lineal para el color de fondo cuando use el tema personalizado y que muestre la flecha al mismo tiempo, porque la flecha emergente y el contenido son dos elementos diferentes, el estilo de la flecha emergente debe establecerse individualmente, y cuando se trata del color de fondo con degradado, puede parecer un poco raro.

Use effect para modificar el tema, el valor por defecto es dark.

Más Contenido ​

Desplegar múltiples líneas de texto y establecer su formato.

Sobrescriba el atributo content del el-tooltip añadiendo un slot llamado content.

Uso Avanzado ​

Además de los usos básicos, hay algunos atributos que le permiten personalización:

el atributo transition permite personalizar la animación con la que el Tooltip se muestra o se esconde, el valor por defecto es el-fade-in-linear.

el atributo disabled permite deshabilitar el tooltip. Solo es necesario definirlo como true.

De hecho, Tooltip es una extensión basada en ElPopper, puede usar cualquier atributo permitido en ElPopper.

TIP

El componente router-link no está soportado en tooltip, por favor use vm.$router.push.

Los elementos de formulario deshabilitados no son compatibles con Tooltip, se puede encontrar más información en MDN. Necesita envolver el elemento del formulario deshabilitado con un elemento contenedor para que la Tooltip funcione.

Contenido HTML ​

El atributo de contenido puede establecerse a cadena HTML.

WARNING

Aunque la propiedad content soporta cadenas HTML, renderizar HTML arbitrario en su sitio web puede ser muy peligroso porque puede llevar fácilmente a ataques XSS. Así que cuando raw-content está usándose, por favor asegúrese de que él content es de confianza, y nunca asigne a content contenido proporcionado por el usuario.

Activación virtual ​

A veces queremos renderizar la descripción en algún otro elemento disparador, podemos separar el disparador y el contenido.

TIP

El tooltip de activación virtual es un componente controlado, por lo que tendrá que controlar la visibilidad de la información por su cuenta, cuando esto suceda, NO PODRÁ cerrar el tooltip haciendo clic en otro lugar.

Singleton ​

La descripción también puede ser singleton, lo que significa que puede tener múltiples disparadores con una sola instancia de tooltip, esta función está implementada con base en Virtual triggering

TIP

Problema conocido: al usar singleton, la ventana emergente saldrá en lugares inesperados

Control ​

La descripción puede ser controlada por el componente padre, usando :visible puede implementar la vinculación de dos vías.

Animaciones ​

Tooltip can be customized animated, you can set the desired animation use transition.

TIP

Transition Classes, more information can be found at Vue Transition.

Use the append-to ​

You must wait for the DOM to be mounted before using targetElement.

API ​

Atributos ​

NombreDescripciónTipoPor defecto
append-toWhich element the tooltip CONTENT appends toCSSSelector / HTMLElement—
effectPopover tiene dos temas: dark y lightenumdark
contentDisplay content, can be overridden by slot#contentstring''
raw-contentWhether content is treated as HTML stringbooleanfalse
placementPosition of Tooltipenumbottom
fallback-placementsList of possible positions for Tooltip popper.jsarray—
visible / v-model:visibleVisibility of Tooltipboolean—
disabledWhether Tooltip is disabledboolean—
offsetOffset of the Tooltipnumber12
transitionAnimation namestring—
popper-optionsparámetros popper.jsobjectrefer to popper.js doc{}
arrow-offset 2.9.10Controls the offset (padding) of the tooltip’s arrow relative to the popper.number5
show-afterDelay of appearance, in millisecond, not valid in controlled modenumber0
show-arrowWhether the tooltip content has an arrowbooleantrue
hide-afterDelay of disappear, in millisecond, not valid in controlled modenumber200
auto-closeTimeout in milliseconds to hide tooltip, not valid in controlled modenumber0
popper-classCustom class name for Tooltip's popperstring—
popper-styleCustom style for Tooltip's popperstring / object—
enterableWhether the mouse can enter the tooltipbooleantrue
teleportedWhether tooltip content is teleported, if true it will be teleported to where append-to setsbooleantrue
triggerHow should the tooltip be triggered (to show), not valid in controlled modeenum / arrayhover
virtual-triggeringIndica si la activación virtual está habilitadaboolean—
virtual-refIndica el elemento de referencia al que se adjunta el tooltipHTMLElement—
trigger-keysWhen you click the mouse to focus on the trigger element, you can define a set of keyboard codes to control the display of tooltip through the keyboard, not valid in controlled modeArray['Enter','Space']
persistentWhen tooltip inactive and persistent is false , tooltip will be destroyedboolean—
aria-label a11ySame as aria-labelstring—
focus-on-target 2.11.2When triggering tooltips through hover, whether to focus the trigger element, which improves accessibilitybooleanfalse

Eventos ​

NombreDescripciónTipo
before-showTriggers before tooltip is shown. Passes trigger reason as argument.Function
showTriggers when tooltip is shown. Passes trigger reason as argument.Function
before-hideTriggers before tooltip is hidden. Passes trigger reason as argument.Function
hideTriggers when tooltip is hidden. Passes trigger reason as argument.Function

Slots ​

NombreDescripción
defaultTooltip triggering & reference element, only a single root element is accepted
contentCustomize content

Expuesto ​

NombreDescriciónTipo
popperRefinstancia del componente el-popperobject
contentRefinstancia del componente el-tooltip-contentobject
isFocusInsideContentValidate current focus event is trigger inside el-tooltip-contentFunction
updatePopperUpdate el-popper component instanceFunction
onOpenExpose onOpen function to manage el-tooltip open stateFunction
onCloseExpose onClose function to manage el-tooltip open stateFunction
hideExpose hide functionFunction

FAQ ​

How to allow spaces in the input box when tooltip is nested? ​

Typical issue: #20907

vue
<template>
  <el-tooltip content="tooltip content" placement="top" :trigger-keys="[]">
    <el-input v-model="value" placeholder="" />
  </el-tooltip>
</template>

Fuente ​

Componentes • Style • Documentación

Contribuidores ​