# Switch

Перемикач із роллю switch і невидимою зоною натискання 44px.


## Приклад


Example (app/demos/switch/SwitchBasic.vue):

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

const notifications = ref(true)
const digest = ref(false)
</script>

<template>
  <div class="w-full max-w-sm space-y-3">
    <label class="flex items-center justify-between gap-4">
      <span class="text-sm text-ink">Сповіщення в браузері</span>
      <UiSwitch v-model="notifications" label="Сповіщення в браузері" />
    </label>
    <label class="flex items-center justify-between gap-4">
      <span class="text-sm text-ink">Щотижневий дайджест</span>
      <UiSwitch v-model="digest" label="Щотижневий дайджест" />
    </label>
    <label class="flex items-center justify-between gap-4 opacity-60">
      <span class="text-sm text-ink">SMS (недоступно на тарифі)</span>
      <UiSwitch :model-value="false" disabled label="SMS" />
    </label>
  </div>
</template>

```


## API

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

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

Для налаштування, що діє негайно. Якщо зміна застосується лише після
натискання «Зберегти» — це чекбокс у формі, а не перемикач.

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

Не ставте перемикач без доступної назви. Якщо поруч немає видимого тексту,
`label` обов'язковий.

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

`role="switch"` і `aria-checked`. У вихідних проєктах це був `<div>`
усередині `<button>`, де стан передавався **лише кольором** — для
скрінрідера перемикач просто не існував.

Окремої згадки вартий `presentational`. Коли перемикач стоїть усередині
кнопки-рядка меню, вкладені `<button>` у `<button>` — невалідний HTML. У
цьому режимі компонент рендериться як `<span aria-hidden>`, а роль і стан
несе зовнішня кнопка.

Сам перемикач навмисно дрібний: це індикатор, а не кнопка. Але 20×36 пальцем
не влучиш, тому на тач-пристроях навколо нього є невидима зона 44×44 —
візуальна щільність списків при цьому не страждає.


## Event descriptions

- `update:modelValue`: Новий стан перемикача.


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