# Progress

Смуга прогресу з визначеним і невизначеним станами.


## Приклад


Example (app/demos/progress/ProgressBasic.vue):

```vue
<script setup lang="ts">
import { ref } from 'vue'
import UiProgress from '~/components/ui/UiProgress.vue'

const value = ref(64)
</script>

<template>
  <div class="flex max-w-sm flex-col gap-4">
    <UiProgress :model-value="value" show-value label="Завантаження файлів" />
    <UiProgress :model-value="value" size="md" />
    <UiProgress label="Обробка запиту…" />
    <UiProgress :model-value="92" tone="warning" label="Квота сховища" show-value />
    <UiProgress :model-value="100" tone="success" label="Резервну копію створено" show-value />
    <p class="text-xs text-muted">Значення: {{ value }} — рухайте повзунком нижче.</p>
    <input v-model.number="value" type="range" min="0" max="100" class="max-w-sm" />
  </div>
</template>
```


## API

[Props, events, slots, exposed API (JSON)](https://ui.tatet.net/api/component-meta/UiProgress)

## Коли використовувати

Коли процес має ВИМІРЮВАНИЙ хід: завантаження, імпорт, батч-операції.
`modelValue: null` — для стану «щось відбувається, скільки — невідомо».

## Коли НЕ використовувати

Для очікування відповіді сервера в кнопці є `loading` у Button — смуга
поруч із кнопкою дублює стан і додає шум.

Невизначений стан не залишайте надовго: через ~5 с користувач перестає
вірити, що щось відбувається. Покажіть текст або дозвольте скасувати.

## Доступність

`role="progressbar"` з `aria-valuemin/max/now`. Під `prefers-reduced-motion`
невизначена смуга не застигає за межами контейнера, а стає статичною
напівпрозорою смугою.

Тон `accent` фарбує смугу токеном `--accent`, а не `--accent-solid`. Смуга —
графічний об'єкт, і від доріжки вона мусить відрізнятися на 3:1 (WCAG
1.4.11). У темній темі `accent-solid` на доріжці давав 2.6:1 — заповнену
частину ледве видно; `accent` тримає 5.3:1 в обох темах.

[Source files, dependencies and ZIP](https://ui.tatet.net/registry/components/progress.json)
