# Rating

Оцінка зірками — інтерактивна для відгуку й readonly з дробовим заповненням для картки товару.


Два режими в одному компоненті. Інтерактивний — група радіокнопок для
форми відгуку. `readonly` — одне зображення з назвою «Оцінка 4,3 з 5, 128
відгуків», де зірки заповнюються дробово.


Example (app/demos/rating/RatingBasic.vue):

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

const quality = shallowRef<number | null>(4)
const delivery = shallowRef<number | null>(null)
</script>

<template>
  <div class="flex w-full max-w-md flex-col gap-6">
    <UiRating
      v-model="quality"
      label="Якість товару"
      :labels="['Жахливо', 'Погано', 'Нормально', 'Добре', 'Чудово']"
      size="lg"
    />
    <UiRating
      v-model="delivery"
      label="Швидкість доставки"
      required
      :clearable="false"
      :error="delivery ? undefined : 'Оцініть доставку, щоб надіслати відгук'"
    />
    <p class="text-sm text-muted">
      Якість: {{ quality ?? '—' }}, доставка: {{ delivery ?? '—' }}.
      Повторний клік по обраній зірці знімає оцінку.
    </p>
  </div>
</template>

```


## Показ у картці товару


Example (app/demos/rating/RatingReadonly.vue):

```vue
<script setup lang="ts">
import UiRating from '~/components/ui/UiRating.vue'

const products = [
  { name: 'Ваза «Теракота»', src: '/demo/vase-terracotta.svg', price: '₴1 450', rating: 4.8, reviews: 128 },
  { name: 'Чашка «Вершки»', src: '/demo/mug-cream.svg', price: '₴390', rating: 4.3, reviews: 57 },
  { name: 'Миска «Шавлія»', src: '/demo/bowl-sage.svg', price: '₴620', rating: 3.6, reviews: 21 },
]
</script>

<template>
  <ul class="grid w-full gap-4 sm:grid-cols-3">
    <li v-for="product in products" :key="product.name" class="overflow-hidden rounded-card border border-line bg-card">
      <img :src="product.src" :alt="product.name" class="aspect-[4/3] w-full object-cover" />
      <div class="space-y-1.5 p-3">
        <p class="text-sm font-medium text-ink">{{ product.name }}</p>
        <UiRating :model-value="product.rating" readonly size="sm" show-value :count="product.reviews" />
        <p class="text-base font-semibold tabular-nums text-ink">{{ product.price }}</p>
      </div>
    </li>
  </ul>
</template>

```


## Колір зірки — окремий токен

Зірка оцінки — не попередження, тож не `warning`, а власна роль `--rating`
у `tokens.css`. Так бренд може взяти свій відтінок (помаранчевий
маркетплейсу), не зачепивши статуси. Світлий `#d97706` дає 3.19:1 на білому
— вище порогу 3:1 для графічних елементів (WCAG 1.4.11).

## API

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

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

- Відгук на товар, доставку, підтримку — оцінка за шкалою з 3–10 рівнів.
- Середня оцінка з кількістю відгуків у картці чи списку (`readonly`).

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

- Для «так/ні» — це перемикач чи дві кнопки, а не зірка.
- Для шкали з підписаними, не впорядкованими варіантами — `UiRadioGroup`.
- Для NPS 0–10 — там важливі числа, а не зірки.

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

Інтерактивний режим — справжні `<input type="radio">` зі спільним `name`:
форма серіалізує оцінку сама, а скрінрідер оголошує «4 з 5: Добре,
радіокнопка, позначено». Одна зупинка Tab на групу — обрана зірка, без
оцінки — перша.

Стрілки власні, а не нативні: нативна група радіо зациклюється (→ на
п'ятій зірці ставила б «1») і не вміє зняти оцінку. Тут → на останній
просто стоїть, ← на першій знімає оцінку (якщо `clearable`), а Delete
знімає з будь-якої. Повторний клік вказівником по обраній зірці теж знімає
оцінку — але не Space: клік клавіатурою приходить із `target` = input, і
його компонент не рахує.

На дотику ціль кожної зірки — 44px незалежно від `size`: зірки не
накладаються зонами, як було б із невидимим `::after` у щільному ряду.
Попередній перегляд під курсором вимкнено для дотику — інакше палець
лишав би «тінь» після того, як оцінку вже поставлено.


## Event descriptions

- `update:modelValue`: Нова оцінка або `null`, коли оцінку знято. Використовуйте через `v-model`.
- `change`: Оцінку змінено діями користувача — кліком чи клавішами.


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