Feedback e status

VBanner

Componentev-model6 exemplos12 propsA2UI · Banner

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.

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

Uso

Exemplo
<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
vue
<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
vue
<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
vue
<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
vue
<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
vue
<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
vue
<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-live apropriado.
  • Í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.
  • Escape fecha banners dispensáveis, sem capturar o foco.
  • O dismiss tem área mínima --v-button-min-target e 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

TriggerPropertyDurationEasing
Entradaopacity, transform--v-motion-normal--v-ease-out
Dismissopacity, transform--v-motion-fast--v-ease-in
Hover / press do dismissbackground, 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

PropTipoDefaultDescrição
modelValuebooleannull as unknown as booleanControls visibility when the banner is used with v-model.
titlestring——
descriptionstring——
variantVBannerVariant"info"—
sizeVBannerSize"md"—
closablebooleanfalse—
closeOnEscapebooleantrue—
disabledbooleanfalse—
loadingbooleanfalse—
ariaLabelstring——
dismissLabelstring"Dismiss banner"—
dismissedTextstring"Banner dismissed"—

Events

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

Slots

SlotProps do slot
#icon—
#title—
#description—
#default—
#action—

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