Feedback e status
VBanner
Faixa de aviso **da página ou do app**: ocupa a largura toda no topo, sem cantos arredondados nem sombra, em uma linha compacta (título + descrição) com as ações à direita. Use texto curto e reserve banners para informação de alto valor.
<script setup lang="ts">
import { VBanner } from 'vueui-nova-kit'
</script>Uso
<VBanner
variant="info"
title="New version available"
description="A new version of VueUI Nova is available."
closable
@close="handleClose">
<template #action>
<VButton size="sm">Update now</VButton>
</template>
</VBanner>Playground
Os controles abaixo são gerados a partir das props declaradas em VBanner.types.ts; o código acompanha cada mudança.
Exemplos
Variantes, tamanhos e estados, extraídos das stories da biblioteca.
Default
Aviso da página ou do app: faixa de ponta a ponta no topo, uma linha compacta (título + descrição), ações à direita. Para mensagens dentro do conteúdo use o VAlert.
Ver código
<script setup lang="ts">
import { VBanner, VButton } from 'vueui-nova-kit'
const args = {
variant: 'info',
size: 'md',
title: 'Scheduled maintenance',
description: 'The workspace will be read-only on Sunday from 02:00 to 03:00 UTC.',
closable: true
}
const page = 'min-height:320px;background:var(--v-color-bg);'
const body = 'margin:24px;height:220px;border:1px dashed var(--v-color-border);border-radius:12px;'
</script>
<template>
<div :style="page">
<VBanner v-bind="args">
<template #action><VButton size="sm" variant="outline">View status</VButton></template>
</VBanner>
<div :style="body" />
</div>
</template>Variants
info, success, warning, error e neutral (anúncio de produto, com ícone de megafone).
Ver código
<script setup lang="ts">
import { VBanner, VButton } from 'vueui-nova-kit'
const page = 'min-height:320px;background:var(--v-color-bg);'
</script>
<template>
<div :style="page + 'display:grid;gap:16px;padding-block:16px'">
<VBanner variant="info" title="Scheduled maintenance" description="Read-only on Sunday, 02:00–03:00 UTC." closable />
<VBanner variant="success" title="You're all set" description="Your domain is verified and live." closable />
<VBanner variant="warning" title="Your trial ends in 3 days" description="Add a payment method to keep your projects." closable>
<template #action><VButton size="sm" variant="outline">Add payment</VButton></template>
</VBanner>
<VBanner variant="error" title="Sync is paused" description="We couldn't reach your Git provider." closable>
<template #action><VButton size="sm" variant="outline">Retry</VButton></template>
</VBanner>
<VBanner variant="neutral" title="New: AI summaries" description="Every thread now gets a summary." closable>
<template #action><VButton size="sm">Try it</VButton></template>
</VBanner>
</div>
</template>Sizes
sm (36px), md (44px, padrão) e lg (52px).
Ver código
<script setup lang="ts">
import { VBanner } from 'vueui-nova-kit'
const page = 'min-height:320px;background:var(--v-color-bg);'
</script>
<template>
<div :style="page + 'display:grid;gap:16px;padding-block:16px'">
<VBanner size="sm" title="Small banner" description="Compact, for dense app chrome." closable />
<VBanner size="md" title="Medium banner" description="Default height." closable />
<VBanner size="lg" title="Large banner" description="More presence for important notices." closable />
</div>
</template>States
Carregando (loading), desabilitado (disabled) e o marcador exibido depois de dispensar (dismissedText).
Ver código
<script setup lang="ts">
import { VBanner } from 'vueui-nova-kit'
const page = 'min-height:320px;background:var(--v-color-bg);'
</script>
<template>
<div :style="page + 'display:grid;gap:16px;padding-block:16px'">
<VBanner title="Publishing your changes" description="This usually takes a few seconds." loading />
<VBanner title="Disabled banner" description="Actions are unavailable." disabled closable />
<VBanner :model-value="false" dismissed-text="Banner dismissed" />
</div>
</template>Close On Escape
Com foco no banner, Esc o dispensa (closeOnEscape=true, padrão).
Ver código
<script setup lang="ts">
import { VBanner } from 'vueui-nova-kit'
</script>
<template>
<VBanner
v-model="value"
title="Scheduled maintenance"
description="The workspace will be read-only on Sunday from 02:00 to 03:00 UTC."
closable />
</template>Controlled VModel
Visibilidade controlada com v-model.
Ver código
<script setup lang="ts">
import { ref } from 'vue'
import { VBanner, VButton } from 'vueui-nova-kit'
const open = ref(true)
const page = 'min-height:320px;background:var(--v-color-bg);'
</script>
<template>
<div :style="page">
<VBanner v-model="open" closable title="Controlled banner" description="Dismiss it and bring it back with the button." />
<div style="padding:24px"><VButton v-if="!open" size="sm" variant="outline" @click="open = true">Show banner again</VButton></div>
</div>
</template>Acessibilidade
- Mensagem anunciada por role semântico e
aria-liveapropriado. - Ícone padrão é decorativo; o texto permanece sempre disponível para leitores de ecrã.
- Ações e dismiss usam elementos nativos, com Enter/Space e foco visível.
Escapefecha banners dispensáveis, sem capturar o foco.- O dismiss tem área mínima
--v-button-min-targete move o foco para o próximo elemento focável quando possível.
Estados
disabled remove a interação e reduz a opacidade. loading anuncia atividade, mantém a anatomia e impede o dismiss. closable mostra o botão de dispensa. Escape dispensa quando o banner é fechável; a transição deixa um placeholder "Banner dismissed".
Motion
| Trigger | Property | Duration | Easing |
|---|---|---|---|
| Entrada | opacity, transform | --v-motion-normal | --v-ease-out |
| Dismiss | opacity, transform | --v-motion-fast | --v-ease-in |
| Hover / press do dismiss | background, color, transform | --v-motion-fast / --v-motion-press | --v-ease-out |
prefers-reduced-motion: reduce remove transições, animações e deslocamento.
Todas as transições respeitam prefers-reduced-motion e os tokens --v-duration-*.
Props
| Prop | Tipo | Default | Descrição |
|---|---|---|---|
modelValue | boolean | null as unknown as boolean | Controls visibility when the banner is used with v-model. |
title | string | — | — |
description | string | — | — |
variant | VBannerVariant | "info" | — |
size | VBannerSize | "md" | — |
closable | boolean | false | — |
closeOnEscape | boolean | true | — |
disabled | boolean | false | — |
loading | boolean | false | — |
ariaLabel | string | — | — |
dismissLabel | string | "Dismiss banner" | — |
dismissedText | string | "Banner dismissed" | — |
Events
| Evento | Payload | Descrição |
|---|---|---|
@update:modelValue | value: boolean | — |
@close | — | — |
Slots
| Slot | Props do slot |
|---|---|
#icon | — |
#title | — |
#description | — |
#default | — |
#action | — |
Fonte: src/components/feedback/VBanner/VBanner.vue · tipos: src/components/feedback/VBanner/VBanner.types.ts