Feedback e status
VProgress
Indicador de progresso linear e circular que comunica claramente o status de conclusão de uma tarefa ou processo. Usar para atividade contínua, fluxos multi-step ou resultado de ações concluídas. Anotação hero: "Clear progress at every step". Pilares: Informative (clearly communicates current status), Responsive (works across different sizes and contexts), Reassuring (builds trust with clear visual feedback).
<script setup lang="ts">
import { VProgress } 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 VProgress.types.ts; o código acompanha cada mudança.
Exemplos
Variantes, tamanhos e estados, extraídos das stories da biblioteca.
Linear
Variação Linear.
Ver código
<script setup lang="ts">
import { VProgress } from 'vueui-nova-kit'
</script>
<template>
<VProgress :value="72" />
</template>Circular
Variação Circular. Props: variant="circular".
Ver código
<script setup lang="ts">
import { VProgress } from 'vueui-nova-kit'
</script>
<template>
<VProgress variant="circular" :value="72" />
</template>Circular Small
Variação Circular pequeno. Props: variant="circular", size="sm".
Ver código
<script setup lang="ts">
import { VProgress } from 'vueui-nova-kit'
</script>
<template>
<VProgress variant="circular" size="sm" :value="72" />
</template>Circular Large
Variação Circular grande. Props: variant="circular", size="lg".
Ver código
<script setup lang="ts">
import { VProgress } from 'vueui-nova-kit'
</script>
<template>
<VProgress variant="circular" size="lg" :value="72" />
</template>Indeterminate
Variação Indeterminado. Props: state="indeterminate", label=false.
Ver código
<script setup lang="ts">
import { VProgress } from 'vueui-nova-kit'
</script>
<template>
<VProgress :value="72" state="indeterminate" :label="false" />
</template>Success
Variação Sucesso. Props: state="success".
Ver código
<script setup lang="ts">
import { VProgress } from 'vueui-nova-kit'
</script>
<template>
<VProgress :value="72" state="success" />
</template>Error
Variação Erro. Props: state="error", value=72.
Ver código
<script setup lang="ts">
import { VProgress } from 'vueui-nova-kit'
</script>
<template>
<VProgress :value="72" state="error" />
</template>Small
Variação Pequeno. Props: size="sm".
Ver código
<script setup lang="ts">
import { VProgress } from 'vueui-nova-kit'
</script>
<template>
<VProgress size="sm" :value="72" />
</template>Large
Variação Grande. Props: size="lg".
Ver código
<script setup lang="ts">
import { VProgress } from 'vueui-nova-kit'
</script>
<template>
<VProgress size="lg" :value="72" />
</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 |
|---|---|---|---|
variant | VProgressVariant | "linear" | Linear bar or circular ring display. |
size | VProgressSize | "md" | Visual density of the track and indicator. |
value | number | 0 | Completion percentage from 0 to 100. |
state | VProgressState | "determinate" | Visual and semantic progress state. |
label | string | boolean | true | Visible label text, auto percentage, or hidden when `false`. |
ariaLabel | string | — | Accessible name override for the progressbar. |
ariaValuetext | string | — | Human-readable value text for `aria-valuetext` (e.g. "21 de 38"). |
dataTestId | string | — | Root anatomy test id override. |
Events
Não emite eventos.
Slots
Sem slots.
Fonte: src/components/feedback/VProgress/VProgress.vue · tipos: src/components/feedback/VProgress/VProgress.types.ts