# Checkbox

Нативний чекбокс із mixed-станом, описом, помилкою та серіалізацією форми.


## Приклад


Example (app/demos/checkbox/CheckboxBasic.vue):

```vue
<script setup lang="ts">
import { shallowRef } from 'vue'

const newsletter = shallowRef(true)
const partial = shallowRef(true)
</script>

<template>
  <div class="grid max-w-md gap-4">
    <UiCheckbox v-model="newsletter" name="newsletter" label="Щотижневий дайджест" description="Один лист щопʼятниці без реклами." />
    <UiCheckbox v-model="partial" indeterminate label="Обрати всі проєкти" hint="Частину проєктів уже обрано." />
    <p class="text-sm text-muted">Дайджест: {{ newsletter ? 'увімкнено' : 'вимкнено' }}</p>
  </div>
</template>

```


## API

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

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

Для незалежного булевого параметра, підтвердження умови або множинного
вибору. `indeterminate` показує частково обрану групу, але значення форми
лишається булевим.

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

Не використовуйте для налаштування, яке спрацьовує одразу — для цього є
`UiSwitch`. Для одного вибору з кількох взаємовиключних варіантів беріть
`UiRadioGroup`.

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

Компонент використовує один нативний `<input type="checkbox">`, тому Space,
форми та assistive technologies працюють без емуляції. Mixed-стан передається
одночасно через DOM-властивість `indeterminate` та `aria-checked="mixed"`.

`id` і `name` розділені: перший звʼязує label, другий визначає ключ форми.

Назва прапорця — лише текст мітки (`aria-labelledby`). `<label>` обгортає і
мітку, і пояснення `description`, тож без цього пояснення потрапляло в назву
**й** в опис, і скрінрідер читав його двічі. В описі — пояснення плюс рівно
одне з помилки чи підказки: помилка перекриває підказку, а не додається до
неї.

Атрибути, що не є props (`aria-label`, `data-*`), ідуть на сам
`<input>`, а `class` і `style` — на обгортку. Прапорець без видимої мітки
(вибір рядка в таблиці) отримує назву з `aria-label` або з тексту в слоті.


## Event descriptions

- `update:modelValue`: Новий булевий стан.
- `change`: Новий стан після дії користувача.


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