# Separator

Роздільник із підписом або без — і правило, коли він потрібен скрінрідеру, а коли ні.


Лінія між блоками. Уся складність тут не у вигляді, а в одному питанні:
чи має скрінрідер знати про цю межу.


Example (app/demos/separator/SeparatorBasic.vue):

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

<template>
  <div class="w-full max-w-md space-y-1">
    <p class="text-sm text-ink">Основні дані клієнта</p>
    <!-- Декоративний: межу вже видно з розкладки, тож для скрінрідера
         роздільника не існує. -->
    <UiSeparator />
    <p class="text-sm text-ink">Контакти</p>

    <!-- Смисловий: підпис сам робить роздільник смисловим. -->
    <UiSeparator label="Архів" />
    <p class="text-sm text-muted">Угоди, закриті понад рік тому</p>

    <!-- Підпис біля краю — заголовок групи, а не пауза посередині. -->
    <UiSeparator label="Цього тижня" label-position="start" />
    <p class="text-sm text-muted">3 нові угоди</p>

    <div class="flex h-10 items-center gap-1 pt-4">
      <span class="text-sm text-ink">Редагувати</span>
      <UiSeparator orientation="vertical" spacing="sm" />
      <span class="text-sm text-ink">Дублювати</span>
      <UiSeparator orientation="vertical" spacing="sm" />
      <span class="text-sm text-danger">Видалити</span>
    </div>

    <!-- Вертикальний підписаний: «або» між двома способами входу поруч. -->
    <div class="flex items-stretch pt-4">
      <p class="flex-1 rounded-control bg-subtle p-3 text-center text-sm text-ink">Увійти через Google</p>
      <UiSeparator label="або" orientation="vertical" spacing="sm" />
      <p class="flex-1 rounded-control bg-subtle p-3 text-center text-sm text-ink">Email і пароль</p>
    </div>
  </div>
</template>

```


## Декоративний чи смисловий

Правило коротке, а ціна помилки різна в обидва боки.

**Декоративний** (`decorative: true`, типово) — межу вже виражає розмітка
навколо: рядки списку, секції картки, групи тулбара. Лінія лише малює те,
що й так зрозуміло зі структури. Такий роздільник отримує `aria-hidden` і
для скрінрідера не існує. Інакше довгий список перетворюється на «роздільник,
пункт, роздільник, пункт» — сто зайвих оголошень на екран.

**Смисловий** (`decorative: false`) — межа існує ЛИШЕ як ця лінія. Дві
незв'язані групи пунктів меню, «або» між способами входу. Тут потрібен
`role="separator"`, інакше межа зникає для тих, хто її не бачить.

Підпис (`label`) робить роздільник смисловим автоматично: лінія, яка щось
говорить, за визначенням несе зміст. `decorative` при ньому ігнорується.

## Позиція підпису

`labelPosition` задає довжину ліній, а не вирівнювання: з боку позиції
лінія стає коротким відрізком. Раніше обидві лінії були `flex-1`, і
`justify-start`/`justify-end` не мали чого розподіляти — підпис стояв по
центру за будь-якої позиції.

Вертикальний підписаний роздільник — колонка: лінії згори й знизу, підпис
посередині. Це «або» між двома способами входу поруч; батько має бути
flex-рядком, як і для непідписаної вертикальної лінії.

## API

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

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

- Між секціями картки або панелі, де відступу замало.
- Між групами дій у тулбарі чи меню.
- Як підписану межу: «або», «Архів», «Показати ще».
- Вертикально — між дрібними діями в одному рядку.

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

- Замість відступу. Якщо блоки й так читаються окремо, лінія лише додає шуму.
- Між рядками таблиці — для цього є межі самої таблиці.
- Як межу картки: це `border` картки, а не окремий елемент.
- Вертикально поза flex-рядком: `self-stretch` нема від чого відштовхнутись,
  і лінія схлопнеться в нуль.

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

Текст підпису має `aria-hidden`, а ім'я береться з `aria-label`. Так треба:
роль `separator` не обчислює назву з вмісту, і без `aria-label` роздільник
лишився б безіменним, а видимий текст прозвучав би окремо від нього.

`aria-orientation` виставляється лише для смислового варіанту — у
декоративного немає ролі, до якої його можна прикласти.


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