# FileUpload

Зона drag&drop з валідацією й прев'ю — без власної upload-логіки.


Зона завантаження без магії: компонент валідує (тип, розмір), прев'юїть
одиночний файл і віддає `File[]` у `select`. САМ upload не робить — бібліотека
не знає вашого бекенду. Фетч, `loading` і `progress` керує споживач.

## Приклад


Example (app/demos/file-upload/FileUploadBasic.vue):

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

const log = ref<string[]>([])

function onSelect(files: File[]) {
  log.value.unshift(`select: ${files.map((f) => f.name).join(', ')}`)
}

function onError(message: string) {
  log.value.unshift(`error: ${message}`)
}

function onRemove(file: File) {
  log.value.unshift(`remove: ${file.name}`)
}
</script>

<template>
  <div class="max-w-md">
    <UiFileUpload
      accept="image/*,.pdf"
      hint="Зображення або PDF, до 10 МБ. Завантаження на сервер — на боці споживача."
      @select="onSelect"
      @error="onError"
      @remove="onRemove"
    />
    <ul v-if="log.length" class="mt-3 space-y-1 text-xs text-muted">
      <li v-for="(entry, index) in log.slice(0, 4)" :key="index">{{ entry }}</li>
    </ul>
  </div>
</template>

```


## API

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

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

Аватарки, вкладки до сторінок, імпорт файлів. Прогрес-смуга з'являється,
коли споживач передає `progress` під час запиту.

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

Не чекайте від компонента мережевих запитів — їх немає і не буде.

Для одного текстового поля «URL зображення» зона надлишкова — потрібен
Input з підказкою.

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

Зона — `role="button"` з `tabindex=0`: Enter і Space відкривають діалог,
як і клік. Невалідний файл не зникає мовчки — `error` з назвою файлу
читається через `role="alert"`. Зона пов'язана з активною помилкою або
підказкою через `aria-describedby`.

Власна зона через default slot отримує `open`, `dragActive`, `loading` і
`disabled`; викликайте `open()` зі своєї кнопки. Той самий метод доступний
через template ref компонента.

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

Локальне прев'ю — `URL.createObjectURL` без читання файлу в пам'ять;
попередній URL відкликається при новому файлі й у `onBeforeUnmount` —
без цього витік пам'яті. Видалення відкликає URL і емітить
`remove(file)`; для `multiple=true` список і далі контролює споживач.

Нативний input спорожняється одразу після кожного вибору. Браузер шле
`change` лише тоді, коли вибір **відрізняється** від попереднього, тож без
цього той самий файл удруге — повтор після невдалого upload чи повторне
додавання в `multiple` — не давав жодної події. Файли до цього моменту вже
скопійовано в масив, тож скидання нічого не забирає.


## Event descriptions

- `select`: Валідні файли після перевірки accept і maxSizeMb.
- `error`: Файл не пройшов валідацію (тип або розмір).
- `remove`: Одиночний файл видалено з локального прев'ю.


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