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 puede ser animado de forma personalizada, puede configurar la función de animación como desee.

API

Atributos

NombreDescripciónTipoPor defecto
append-toa qué elemento se agrega el CONTENT del tooltipCSSSelector / HTMLElement
effectPopover tiene dos temas: dark y lightenumdark
contentcontenido a mostrar, puede ser sobre-escrito por slot#contentstring''
raw-contentsi content es tratado como cadena HTMLbooleanfalse
placementposición del Tooltipenumbottom
fallback-placementslist of possible positions for Tooltip popper.jsarray
visible / v-model:visiblevisibilidad del Tooltipboolean
disabledsaber si el Tooltip se encuentra deshabilitadoboolean
offsetoffset del Tooltipnumber12
transitionnombre de animaciónstring
popper-optionsparámetros popper.jsobjectrefer to popper.js doc{}
show-afterretraso de la aparición, en milisegundosnumber0
show-arrowsi el contenido de la descripción tiene una flechabooleantrue
hide-afterretraso de la desaparición, en milisegundosnumber200
auto-closetiempo de espera en milisegundos para ocultar el tooltip de forma automáticanumber0
popper-classnombre de clase personalizada para el popper del Tooltipstring
enterablesi el mouse puede entrar al Tooltipbooleantrue
teleportedsi el contenido del tooltip es teletransportado, si es true será teletransportado a donde establezca append-tobooleantrue
triggerCómo debería activarse la descripción (para mostrar)enumhover
virtual-triggeringIndica si la activación virtual está habilitadaboolean
virtual-refIndica el elemento de referencia al que se adjunta el tooltipHTMLElement
trigger-keysCuando hace clic en el ratón se enfoca en el elemento desencadenante, puede definir un conjunto de códigos de teclado para controlar la visualización de la descripción a través del tecladoArray['Enter','Space']
persistentcuando el tooltip este inactivo y persistent es false, el tooltip será destruidoboolean
aria-label a11yigual que aria-label en nativostring

Slots

NombreDescripción
defaultElemento de referencia & disparador del tooltip
contentcontenido personalizado

Expuesto

NombreDescripciónTipo
popperRefinstancia del componente el-popperobject
contentRefinstancia del componente el-tooltip-contentobject
isFocusInsideContentvalida el evento de focus actual se activa dentro del contenido el-tooltip-contentFunction
updatePopperactualiza la instancia del componente el-popperFunction
onOpenexpone la función onOpen para manipular el estado abierto del tooltipFunction
onCloseexpone la función onClose para manipular el estado abierto del tooltipFunction
hideexpone la función ocultarFunction

Fuente

ComponentesStyleDocumentación

Contribuidores