Overlays

VTooltip

Componente7 exemplos11 propsA2UI · Tooltip

Dica contextual (contextual helper hint) que exibe informação breve e contextual ao dar hover, focus ou tap num elemento. Explica recursos, reduz carga cognitiva e mantém a interface limpa e focada. Promessa hero: "Explain more with less. Small hints.

Importação
<script setup lang="ts">
import { VTooltip } from 'vueui-nova-kit'
</script>

Uso

Exemplo
<script setup lang="ts">

</script>

<template>
  
</template>

Playground

Os controles abaixo são gerados a partir das props declaradas em VTooltip.types.ts; o código acompanha cada mudança.

Exemplos

Variantes, tamanhos e estados, extraídos das stories da biblioteca.

Default

Variação Padrão. Estado padrão do componente; use a aba Controls para experimentar as props ao vivo.

Ver código
vue
<script setup lang="ts">
import { VTooltip, VButton } from 'vueui-nova-kit'

const args = {
  content: 'This is a helpful tooltip',
  size: 'md',
  variant: 'default',
  placement: 'top'
}
</script>

<template>
  <VTooltip v-bind="args">
    <VButton variant="secondary">Hover me</VButton>
  </VTooltip>
</template>

Placements

Variação Placements.

Ver código
vue
<script setup lang="ts">
import { VTooltip, VButton } from 'vueui-nova-kit'
</script>

<template>
  <div style="display:grid;gap:24px;place-items:center;padding:80px;">
    <VTooltip content="Top tooltip" placement="top"><VButton variant="secondary" size="sm">Top</VButton></VTooltip>
    <div style="display:flex;gap:48px;align-items:center;">
      <VTooltip content="Left tooltip" placement="left"><VButton variant="secondary" size="sm">Left</VButton></VTooltip>
      <VTooltip content="Right tooltip" placement="right"><VButton variant="secondary" size="sm">Right</VButton></VTooltip>
    </div>
    <VTooltip content="Bottom tooltip" placement="bottom"><VButton variant="secondary" size="sm">Bottom</VButton></VTooltip>
  </div>
</template>

Variants

Variação Variantes.

Ver código
vue
<script setup lang="ts">
import { VTooltip, VButton } from 'vueui-nova-kit'
</script>

<template>
  <div style="display:flex;flex-wrap:wrap;gap:16px;padding:48px;">
    <VTooltip content="Supports text only." variant="default"><VButton variant="secondary" size="sm" aria-label="Ajuda">?</VButton></VTooltip>
    <VTooltip content="With an icon" variant="with-icon"><VButton variant="secondary" size="sm" aria-label="Ajuda">?</VButton></VTooltip>
    <VTooltip content="Success saved!" variant="success"><VButton variant="secondary" size="sm" aria-label="Ajuda">?</VButton></VTooltip>
    <VTooltip content="Action unavailable" variant="error"><VButton variant="secondary" size="sm" aria-label="Ajuda">?</VButton></VTooltip>
    <VTooltip content="Pro tip!" variant="brand"><VButton variant="secondary" size="sm" aria-label="Ajuda">?</VButton></VTooltip>
    <VTooltip content="Light tooltip" variant="light"><VButton variant="secondary" size="sm" aria-label="Ajuda">?</VButton></VTooltip>
  </div>
</template>

No Arrow

Variação Sem Arrow. Props: showArrow=false, content="Sem seta".

Ver código
vue
<script setup lang="ts">
import { VTooltip, VButton } from 'vueui-nova-kit'

const args = {
  content: 'Sem seta',
  size: 'md',
  variant: 'default',
  placement: 'top',
  showArrow: false
}
</script>

<template>
  <div style="padding:64px;">
    <VTooltip v-bind="args">
      <VButton variant="secondary">Sem seta</VButton>
    </VTooltip>
  </div>
</template>

Hide Delay

Variação Hide Delay. Props: hideDelay=800, content="Some após 800ms".

Ver código
vue
<script setup lang="ts">
import { VTooltip, VButton } from 'vueui-nova-kit'

const args = {
  content: 'Some após 800ms',
  size: 'md',
  variant: 'default',
  placement: 'top',
  hideDelay: 800
}
</script>

<template>
  <div style="padding:64px;">
    <VTooltip v-bind="args">
      <VButton variant="secondary">Hide delay</VButton>
    </VTooltip>
  </div>
</template>

Warm Group

Variação Warm grupo. Props: warmGroup="toolbar", content="Grupo aquecido".

Ver código
vue
<script setup lang="ts">
import { VTooltip, VButton } from 'vueui-nova-kit'

const args = {
  content: 'Grupo aquecido',
  size: 'md',
  variant: 'default',
  placement: 'top',
  warmGroup: 'toolbar'
}
</script>

<template>
  <div style="display:flex;gap:16px;padding:64px;">
    <VTooltip v-bind="args">
      <VButton variant="secondary">Ação 1</VButton>
    </VTooltip>
    <VTooltip v-bind="args">
      <VButton variant="secondary">Ação 2</VButton>
    </VTooltip>
  </div>
</template>

Disabled

Variação Desabilitado. Props: disabled=true, content="Desabilitado". O trigger responde ao hover, mas o tooltip não aparece.

Ver código
vue
<script setup lang="ts">
import { VTooltip, VButton } from 'vueui-nova-kit'

const args = {
  content: 'Desabilitado',
  size: 'md',
  variant: 'default',
  placement: 'top',
  disabled: true
}
</script>

<template>
  <div style="padding:64px;">
    <VTooltip v-bind="args">
      <VButton variant="secondary">Desabilitado</VButton>
    </VTooltip>
  </div>
</template>

Acessibilidade

Semântica nativa primeiro, foco visível, labels acessíveis e teclado conforme o padrão WAI-ARIA correspondente.

Estados

Default · Hover · Focus-visible · Pressed/Active quando aplicável · Disabled · Loading quando aplicável.

Motion

TriggerPropertyDurationEasing
Hoverbackground/transform100msstandard
Focusoutline/box-shadow100msstandard
Enter/Exitopacity/transform160msstandard

Respeitar prefers-reduced-motion.

Todas as transições respeitam prefers-reduced-motion e os tokens --v-duration-*.

Props

PropTipoDefaultDescrição
contentstring——
placementVTooltipPlacement"top"—
sizeVTooltipSize"md"—
variantVTooltipVariant"default"—
disabledbooleanfalse—
showArrowbooleantrue—
hideDelaynumber500—
ariaLabelstring——
motionVMotionLevelV_MOTION_DEFAULT ("expressive")—
warmGroupstring—Warm Tooltip: share open delay within a toolbar group.
openbooleanundefinedModo controlado: quando definido (!== undefined) força a visibilidade e ignora hover/focus/teclado. Sem a prop, o comportamento é o padrão.

Events

Não emite eventos.

Slots

SlotProps do slot
#default—
#icon—
#content—

Fonte: src/components/feedback/VTooltip/VTooltip.vue · tipos: src/components/feedback/VTooltip/VTooltip.types.ts