# Chip

Компактна позначка статусу з шістьма смисловими тонами.


## Тони


Example (app/demos/chip/ChipTones.vue):

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

const filters = ref(['Київ', 'Опубліковано', 'Цього тижня'])
</script>

<template>
  <div class="flex flex-col items-center gap-4">
    <div class="flex flex-wrap items-center gap-2">
      <UiChip tone="neutral">чернетка</UiChip>
      <UiChip tone="accent">на розгляді</UiChip>
      <UiChip tone="success" dot label="Опубліковано">опубліковано</UiChip>
      <UiChip tone="warning">потребує уваги</UiChip>
      <UiChip tone="danger">помилка</UiChip>
      <UiChip tone="info" size="sm">інформація</UiChip>
    </div>
    <div class="flex flex-wrap items-center gap-2">
      <UiChip
        v-for="filter in filters"
        :key="filter"
        tone="accent"
        size="sm"
        removable
        @remove="filters = filters.filter((item) => item !== filter)"
      >
        {{ filter }}
      </UiChip>
      <UiChip v-if="!filters.length" tone="neutral" size="sm" clickable @click="filters = ['Київ', 'Опубліковано', 'Цього тижня']">
        повернути фільтри
      </UiChip>
    </div>
  </div>
</template>

```


## API

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

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

Для стану сутності в списку чи таблиці: статус публікації, роль, тег.

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

Не передавайте статус лише кольором. Тон — підсилення, а не носій сенсу:
`dot` без тексту потребує `label`, інакше стан недоступний для скрінрідера
й невидимий для дальтоніка.

Довгий текст не розпирає батька: чип не ширший за контейнер, а текст
обрізається трикрапкою. Задайте тоді `title` з повним текстом.

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

Семантичний тег обирається за інтерактивністю, а не за виглядом:
`clickable` перетворює чип на `<button>`. `<div @click>` недоступний із
клавіатури й не має ролі.

`label` — доступна назва, що ЗАМІНЯЄ видимий текст для скрінрідера. У
клікабельного чипа це `aria-label` кнопки; у звичайного — прихований
текст, бо `aria-label` на `<span>` без ролі заборонений, і NVDA чи JAWS
його просто не читають. Тож не передавайте в `label` сирий код
(`published`) поруч із видимим «опубліковано» — саме код і прозвучить.

Хрестик і клікабельний чип мають на дотику невидиму зону 45px завширшки.
Заввишки вона 30px, а не 45: повна висота заходила б на наступний ряд
чипів, і палець видаляв би сусідній фільтр. Назва хрестика — «Видалити» й
поточний текст чипа, і вона стежить за ним.


## Event descriptions

- `click`: Клік. Спрацьовує лише коли задано `clickable`.
- `remove`: Натиснуто хрестик `removable` (або Delete на клікабельному чипі). Список тримає батько.


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