# Sparkline

Мініграфік тренду без осей — лінія, заливка або стовпчики на всю ширину батька.


Графік розміром зі слово: показує форму ряду — росте, падає, скаче — без
осей, підписів і легенди. Найчастіше живе в слоті `trend` у
[`UiStatCard`](https://ui.tatet.net/docs/components/stat-card), який навмисно нічого не малює
сам.


Example (app/demos/sparkline/SparklineBasic.vue):

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

const revenue = [42, 48, 45, 53, 51, 60, 58, 66, 71, 69, 78, 84]
const churn = [2.1, 2.4, 2.2, 2.9, 3.1, 2.8, 3.4, 3.6]
const orders = [12, 18, 9, 22, 17, 25, 31]
const uptime = [99.9, 99.8, Number.NaN, Number.NaN, 99.95, 99.9, 99.97, 99.99]
</script>

<template>
  <div class="grid w-full max-w-2xl gap-4 sm:grid-cols-2">
    <div class="rounded-card border border-line bg-card p-4">
      <p class="text-sm text-muted">Виторг, лінія + заливка</p>
      <UiSparkline class="mt-3" :data="revenue" variant="area" :height="48" show-last-point />
    </div>
    <div class="rounded-card border border-line bg-card p-4">
      <p class="text-sm text-muted">Відтік — зростання погане</p>
      <UiSparkline class="mt-3" :data="churn" tone="danger" :height="48" show-last-point />
    </div>
    <div class="rounded-card border border-line bg-card p-4">
      <p class="text-sm text-muted">Замовлення за тиждень</p>
      <UiSparkline class="mt-3" :data="orders" variant="bar" tone="accent" :height="48" label="Замовлення за 7 днів: від 12 до 31" />
    </div>
    <div class="rounded-card border border-line bg-card p-4">
      <p class="text-sm text-muted">Пропуск у даних — розрив, не нуль</p>
      <UiSparkline class="mt-3" :data="uptime" tone="success" curve="linear" :height="48" />
    </div>
  </div>
</template>

```


## У плитці метрики


Example (app/demos/sparkline/SparklineStatCard.vue):

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

<template>
  <div class="grid w-full gap-4 sm:grid-cols-3">
    <UiStatCard label="Виторг" value="₴1,28 млн" value-label="1 284 300 гривень" :delta="12.4" hint="проти серпня">
      <template #trend>
        <UiSparkline :data="[42, 48, 45, 53, 51, 60, 58, 66, 71, 78, 84]" variant="area" tone="success" />
      </template>
    </UiStatCard>
    <UiStatCard label="Відтік" value="3,6 %" :delta="0.4" delta-good="down" hint="проти серпня">
      <template #trend>
        <UiSparkline :data="[2.1, 2.4, 2.2, 2.9, 3.1, 2.8, 3.4, 3.6]" tone="danger" />
      </template>
    </UiStatCard>
    <UiStatCard label="Нові клієнти" value="87" :delta="-4" delta-format="absolute" hint="проти серпня">
      <template #trend>
        <UiSparkline :data="[14, 9, 12, 16, 11, 13, 12]" variant="bar" tone="neutral" />
      </template>
    </UiStatCard>
  </div>
</template>

```


## Три рішення, які тримає компонент

**Пропуск — це розрив, а не нуль.** `NaN` у даних рве лінію. Нуль
намалював би падіння, якого не було: день без даних — не день без продажів.

**Згладжування не вигадує значень.** `curve="smooth"` — монотонна кубічна
крива (як `curveMonotoneX` у d3). Звичайний сплайн «перелітає» екстремуми:
між 10 і 10 з піком 50 посередині він малює провал нижче 10, якого в даних
немає. Монотонна крива проходить через кожну точку й ніколи не виходить за
сусідні значення.

**Стовпчики стоять на нулі.** Шкала `variant="bar"` завжди містить нуль:
стовпчик, що починається не з нуля, бреше про пропорції — 98 і 100
виглядали б як «удвічі більше». Останній стовпчик яскравіший — «де ми
зараз».

## API

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

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

- Форма ряду поруч із числом: у плитці метрики, у рядку таблиці, у
  картці клієнта.
- Коли важливий напрям і ритм, а не точні значення.

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

- Коли користувач має прочитати конкретне значення — це таблиця або
  повноцінний графік з осями й підказками.
- Для порівняння кількох рядів на одному полотні: спарклайн — один ряд.
- Тон не підбирається автоматично за напрямом, і це свідомо: зростання
  відтоку — погана новина, і «вгору = зелене» тут збрехало б. Тон обирає
  той, хто знає, що означає метрика.

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

Весь графік — одне зображення (`role="img"`) з назвою. Без `label`
компонент складає підсумок сам: «зростання: від 120 до 180, мінімум 96,
максимум 210». Числа форматуються за `uk-UA` або функцією `formatValue` —
валюту й одиниці передавайте нею, щоб підсумок звучав так само, як число
поруч.

## Портування

Геометрія живе в `app/utils/sparkline.ts` — копіюйте її разом із
компонентом. SVG тягнеться на всю ширину батька через
`preserveAspectRatio="none"`, а товщину лінії тримає
`vector-effect="non-scaling-stroke"`. Тому остання точка — HTML-крапка
поверх SVG, а не `<circle>`: коло в розтягнутому SVG стало б еліпсом.


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