# CopyButton

Кнопка «копіювати в буфер» зі станом успіху й резервним шляхом копіювання.


Копіювання зворотне тільки тоді, коли користувач його побачив. Кнопка
міняє іконку й підпис на «Скопійовано» на дві секунди — абсолютно
позиційованим шаром, без стрибка ширини (той самий патерн, що в Button
під час loading).

## Приклад


Example (app/demos/copy-button/CopyButtonBasic.vue):

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

const lastCopied = ref('')
</script>

<template>
  <div class="flex flex-wrap items-center gap-3">
    <UiCopyButton text="npx nuxi init my-app" label="Копіювати команду" @copied="lastCopied = $event" />
    <UiCopyButton text="tatetUI" variant="outline" aria-label="Копіювати назву" />
    <p class="text-xs text-muted">В буфері: {{ lastCopied || '—' }}</p>
  </div>
</template>
```


## API

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

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

Поруч із командами встановлення, API-ключами, кодами запрошень,
посиланнями на спільний документ.

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

Не всередині іншої кнопки чи посилання (вкладена інтерактивність).

Не для «копіювання всієї сторінки» — користувач має бачити, що саме
падає в буфер.

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

Доступна назва через `ariaLabel` ОБОВ'ЯЗКОВА для іконкової версії.
Успіх показується кольором і галочкою, а в кнопки з підписом — ще й
текстом. В іконковій кнопці «Скопійовано» не вміщалось у квадрат і вилазило
за її межі, тож там лишилась галочка.

Результат озвучує жива область, що існує від самого рендера, — змінюється
лише її текст. Раніше `role="status"` вставлявся разом із текстом через
`v-if`, а таку область скрінрідери здебільшого пропускають: іконкова
кнопка копіювала мовчки.

Розміри, стан натискання й `ring-offset` — ті самі, що в
[`UiButton`](https://ui.tatet.net/docs/components/button): у тулбарі поруч із кнопкою того ж
`size` копіювання більше не стоїть нижчим.

## Деталі реалізації

navigator.clipboard недоступний на http і кидає NotAllowedError поза
фокусом документа, тому другим кроком іде резервне копіювання через
прихований textarea — той самий патерн, що в ComponentPreview.

## Event descriptions

- `copied`: Копіювання вдалося; в payload — скопійований текст.
- `failed`: Копіювання не вдалося обома шляхами.


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