Feedback e status

VProgress

Componente9 exemplos8 propsA2UI · Progress

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).

Importação
<script setup lang="ts">
import { VProgress } 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 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
vue
<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
vue
<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
vue
<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
vue
<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
vue
<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
vue
<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
vue
<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
vue
<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
vue
<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

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
variantVProgressVariant"linear"Linear bar or circular ring display.
sizeVProgressSize"md"Visual density of the track and indicator.
valuenumber0Completion percentage from 0 to 100.
stateVProgressState"determinate"Visual and semantic progress state.
labelstring | booleantrueVisible label text, auto percentage, or hidden when `false`.
ariaLabelstring—Accessible name override for the progressbar.
ariaValuetextstring—Human-readable value text for `aria-valuetext` (e.g. "21 de 38").
dataTestIdstring—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