# ProgressRing

Круговий прогрес для щільних місць — від 24px у рядку до великого кільця на дашборді.


Та сама шкала, що в `UiProgress`, — `modelValue`, `max`, `tone`,
невизначений стан через `null` — але в колі. Смуга потребує ширини; кільце
вміщається там, де ширини немає: у рядку таблиці, у картці поруч із
цифрою, на аватарі кроку онбордингу.


Example (app/demos/progress-ring/ProgressRingBasic.vue):

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

const value = shallowRef(68)
</script>

<template>
  <div class="flex w-full max-w-lg flex-col gap-6">
    <div class="flex flex-wrap items-end gap-6">
      <UiProgressRing :model-value="value" :size="96" show-value label="Заповнення профілю" />
      <UiProgressRing :model-value="value" :size="64" show-value tone="success" label="Виконано задач" />
      <UiProgressRing :model-value="92" :size="48" tone="warning" label="Квота сховища" show-value />
      <UiProgressRing :size="32" label="Обробка файлу" />
      <UiProgressRing :model-value="3" :max="5" :size="56" label="Кроки онбордингу">
        <span class="text-xs">3/5</span>
      </UiProgressRing>
    </div>

    <!-- Компактне кільце в рядку: число поруч, а не всередині. -->
    <div class="flex items-center gap-3 rounded-card border border-line bg-card px-4 py-3">
      <UiProgressRing :model-value="value" :size="24" :thickness="3" label="Використано контексту" />
      <span class="text-sm text-ink">Використано контексту</span>
      <span class="ml-auto text-sm tabular-nums text-muted">{{ value }}%</span>
    </div>

    <UiSlider v-model="value" label="Значення" :min="0" :max="100" show-value />
  </div>
</template>

```


## API

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

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

- Прогрес одного об'єкта в щільному місці: заповнення профілю, квота,
  використаний контекст, крок онбордингу («3/5» у центрі через слот).
- Ключова частка на дашборді, коли саме кільце — головна графіка картки.

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

- Для порівняння кількох величин. Кільця погано порівнюються на око —
  п'ять смуг одна під одною читаються швидше за п'ять кілець поруч.
- Для завантаження без відомої частки довше кількох секунд — див.
  розділ про вибір індикатора на сторінці [Spinner](https://ui.tatet.net/docs/components/spinner).

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

`role="progressbar"` з `aria-valuemin/max/now` і назвою з `label`. У
невизначеному стані `aria-valuenow` немає зовсім — саме так специфікація
відрізняє «невідомо скільки» від «нуль».

Відсоток у центрі (`showValue`) має `aria-hidden`: значення вже несе
`aria-valuenow`, і дубль прозвучав би двічі. Центр показується лише від
діаметра 40px — менше число в кільце читабельним не вміщається.

Геометрія рахується в пікселях самого кільця, а не у фіксованому
`viewBox`: товщина — справжні пікселі за будь-якого діаметра, тож 3px на
24px і 3px на 96px виглядають однаково. Під `prefers-reduced-motion`
невизначене кільце не застигає «на чверті» (що читалося б як 25 %), а стає
повним і напівпрозорим — той самий прийом, що в `UiProgress`.


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