Feedback e status
VEmptyState
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).
<script setup lang="ts">
import { VEmptyState } 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 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
<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
<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
<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
<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
<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
<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
<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
| 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 |
|---|---|---|---|
title | string | — | — |
description | string | — | — |
action | VEmptyStateAction | — | — |
size | VEmptyStateSize | "md" | — |
variant | VEmptyStateVariant | "default" | — |
compact | boolean | false | — |
showIllustration | boolean | true | — |
disabled | boolean | false | — |
loading | boolean | false | — |
ariaLabel | string | — | — |
headingLevel | 2 | 3 | 4 | 2 | — |
Events
| Evento | Payload | Descrição |
|---|---|---|
@action | — | — |
Slots
| Slot | Props do slot |
|---|---|
#illustration | — |
#icon | — |
#title | — |
#description | — |
#action | — |
Fonte: src/components/feedback/VEmptyState/VEmptyState.vue · tipos: src/components/feedback/VEmptyState/VEmptyState.types.ts