Feedback e status

VEmptyState

Componente7 exemplos11 propsA2UI · EmptyState

Estado vazio amigável para quando não há nada para mostrar: transforma momentos vazios em próximos passos úteis com ilustração, título, descrição e ação. Cobre cenários comuns (sem projetos, sem resultados, sem ficheiros, sem notificações, onboarding de criação).

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

const action = { label: 'Create project', icon: 'plus' }
</script>

<template>
  <VEmptyState
    title="No projects yet"
    description="Get started by creating your first project."
    :action="action" />
</template>

No Results

Variação Sem Results. Props: variant="results".

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

const action = { label: 'Create project', icon: 'plus' }
</script>

<template>
  <VEmptyState
    variant="results"
    title="No projects yet"
    description="Get started by creating your first project."
    :action="action" />
</template>

Compact

Variação Compact. Props: compact=true.

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

const action = { label: 'Create project', icon: 'plus' }
</script>

<template>
  <VEmptyState
    title="No projects yet"
    description="Get started by creating your first project."
    :action="action"
    compact />
</template>

No Illustration

Variação Sem Illustration. Props: showIllustration=false, title="Sem ilustração".

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

const action = { label: 'Create project', icon: 'plus' }
</script>

<template>
  <VEmptyState
    title="Sem ilustração"
    description="Get started by creating your first project."
    :action="action"
    :show-illustration="false" />
</template>

Heading Level4

Variação Heading Level4. Props: headingLevel=4, title="Título como h4".

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

const action = { label: 'Create project', icon: 'plus' }
</script>

<template>
  <VEmptyState
    title="Título como h4"
    description="Get started by creating your first project."
    :action="action"
    :heading-level="4" />
</template>

Loading

Variação Carregando. Props: loading=true.

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

const action = { label: 'Create project', icon: 'plus' }
</script>

<template>
  <VEmptyState
    title="No projects yet"
    description="Get started by creating your first project."
    :action="action"
    loading />
</template>

Disabled

Variação Desabilitado. Props: disabled=true.

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

const action = { label: 'Create project', icon: 'plus' }
</script>

<template>
  <VEmptyState
    title="No projects yet"
    description="Get started by creating your first project."
    :action="action"
    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
titlestring——
descriptionstring——
actionVEmptyStateAction——
sizeVEmptyStateSize"md"—
variantVEmptyStateVariant"default"—
compactbooleanfalse—
showIllustrationbooleantrue—
disabledbooleanfalse—
loadingbooleanfalse—
ariaLabelstring——
headingLevel2 | 3 | 42—

Events

EventoPayloadDescrição
@action——

Slots

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

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