Feedback e status
VToast
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.
<script setup lang="ts">
import { VToast } from 'vueui-nova-kit'
</script>Uso
<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
<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
<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
<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
<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
<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
<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
<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
<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
<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
| Trigger | Property | Duration | Easing |
|---|---|---|---|
| Hover | background/transform | 100ms | standard |
| Focus | outline/box-shadow | 100ms | standard |
| Enter/Exit | opacity/transform | 160ms | standard |
Respeitar prefers-reduced-motion.
Todas as transições respeitam prefers-reduced-motion e os tokens --v-duration-*.
Props
| Prop | Tipo | Default | Descrição |
|---|---|---|---|
message | string | — | — |
variant | VToastVariant | "info" | — |
size | VToastSize | "md" | — |
duration | number | 5000 | — |
closable | boolean | true | — |
showProgress | boolean | true | — |
loading | boolean | false | — |
disabled | boolean | false | — |
dismissLabel | string | — | — |
ariaLabel | string | — | — |
modelValue | boolean | true | — |
motion | VMotionLevel | V_MOTION_DEFAULT ("expressive") | — |
Events
| Evento | Payload | Descrição |
|---|---|---|
@update:modelValue | value: boolean | — |
@close | — | — |
Slots
| Slot | Props do slot |
|---|---|
#icon | — |
#default | — |
Fonte: src/components/feedback/VToast/VToast.vue · tipos: src/components/feedback/VToast/VToast.types.ts