Feedback e status

VToast

Componentev-model9 exemplos12 propsA2UI · Toast

Mensagem transitória de feedback (transient feedback message) que informa ação, evento de sistema ou atualização de status de forma breve e não intrusiva. Aparece temporariamente, mantém o usuário informado e desaparece automaticamente. Promessa hero: "Deliver feedback without interruption.

Importação
<script setup lang="ts">
import { VToast } 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 VToast.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 { VToast } from 'vueui-nova-kit'
</script>

<template>
  <VToast v-model="value" message="New updates are available." />
</template>

Success

Variação Sucesso. Props: variant="success", message="Project saved successfully.".

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

<template>
  <VToast
    v-model="value"
    message="Project saved successfully."
    variant="success" />
</template>

Warning

Variação Aviso. Props: variant="warning", message="Connection is unstable.".

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

<template>
  <VToast
    v-model="value"
    message="Connection is unstable."
    variant="warning" />
</template>

Error

Variação Erro. Props: variant="error", message="Failed to upload file.".

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

<template>
  <VToast v-model="value" message="Failed to upload file." variant="error" />
</template>

Sizes

Variação Tamanhos.

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

<template>
  <div style="display:flex;flex-direction:column;gap:12px;max-width:420px;">
    <VToast size="sm" variant="success" message="Saved successfully." :duration="0" />
    <VToast size="md" variant="success" message="Saved successfully." :duration="0" />
    <VToast size="lg" variant="success" message="Saved successfully." :duration="0" />
  </div>
</template>

Loading

Variação Carregando. Props: variant="loading", message="Enviando arquivo…", duration=0.

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

<template>
  <VToast
    v-model="value"
    message="Enviando arquivo…"
    variant="loading"
    :duration="0" />
</template>

Without Progress Not Closable

Variação Sem Progress Not Closable. Props: showProgress=false, closable=false, message="Toast fixo, sem barra e sem…", duration=0.

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

<template>
  <VToast
    v-model="value"
    message="Toast fixo, sem barra e sem botão de fechar."
    :duration="0"
    :show-progress="false"
    :closable="false" />
</template>

Stack (useVToastQueue)

Fila de toasts com VToastStack + useVToastQueue(). O stack é teleportado para o body; escolha placement entre os seis cantos/centros.

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

const stack = ref(null)
const placement = ref('top-right')
const placements = [
  'top-right',
  'top-left',
  'top-center',
  'bottom-right',
  'bottom-left',
  'bottom-center'
]
const push = () => stack.value?.push({ message: `Notifica\xE7\xE3o #${++n}`, variant: variants[n % 4], duration: 4e3 })
const clear = () => stack.value?.clear()
</script>

<template>
  <div style="display:flex;gap:8px;flex-wrap:wrap;align-items:center;">
        <VToastStack ref="stack" :placement="placement" />
        <VButton variant="primary" @click="push">Adicionar toast</VButton>
        <VButton variant="outline" @click="clear">Limpar</VButton>
        <select v-model="placement"><option v-for="p in placements" :key="p" :value="p">{{ p }}</option></select>
      </div>
</template>

Disabled

Variação Desabilitado. Props: disabled=true, duration=0.

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

<template>
  <VToast
    v-model="value"
    message="New updates are available."
    :duration="0"
    disabled />
</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
messagestring——
variantVToastVariant"info"—
sizeVToastSize"md"—
durationnumber5000—
closablebooleantrue—
showProgressbooleantrue—
loadingbooleanfalse—
disabledbooleanfalse—
dismissLabelstring——
ariaLabelstring——
modelValuebooleantrue—
motionVMotionLevelV_MOTION_DEFAULT ("expressive")—

Events

EventoPayloadDescrição
@update:modelValuevalue: boolean—
@close——

Slots

SlotProps do slot
#icon—
#default—

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