# Input

Текстове поле з лейблом, підказкою та станом помилки.


Поле бере класи з `uiFieldStyles` — спільного контракту, на якому тримаються
всі поля бібліотеки. Завдяки цьому `UiInput`, `UiTextarea` і `UiSelect`
лишаються однаковими без копіювання довгих рядків класів.

## Приклад


Example (app/demos/input/InputBasic.vue):

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

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

<template>
  <div class="w-full max-w-sm">
    <UiInput v-model="email" label="Робоча пошта" type="email" placeholder="you@company.com" />
  </div>
</template>

```


## Стани


Example (app/demos/input/InputStates.vue):

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

const withHint = ref('')
const withError = ref('не-пошта')
const disabled = ref('Недоступно для змін')
</script>

<template>
  <div class="w-full max-w-sm space-y-4">
    <UiInput v-model="withHint" label="Псевдонім" hint="Від 3 до 20 символів." />
    <UiInput v-model="withError" label="Пошта" error="Схоже, це не адреса пошти." />
    <UiInput v-model="disabled" label="Тариф" disabled />
  </div>
</template>

```


## Очищення та пароль

`clearable` додає хрестик, коли поле не порожнє; `passwordToggle` — око
для `type="password"`. Обидві кнопки живуть усередині поля, тож відступ
тексту рахується автоматично і не наїжджає на них.


Example (app/demos/input/InputActions.vue):

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

const query = ref('tatetUI')
const password = ref('correct-horse-battery')
</script>

<template>
  <div class="w-full max-w-sm space-y-4">
    <UiInput v-model="query" type="search" label="Пошук" placeholder="Назва компонента…" clearable>
      <template #leading>
        <svg class="h-4 w-4" viewBox="0 0 24 24" fill="none" aria-hidden="true">
          <circle cx="11" cy="11" r="7" stroke="currentColor" stroke-width="2" />
          <path d="M20 20l-3.5-3.5" stroke="currentColor" stroke-width="2" stroke-linecap="round" />
        </svg>
      </template>
    </UiInput>
    <UiInput
      v-model="password"
      type="password"
      label="Пароль"
      autocomplete="current-password"
      password-toggle
      clearable
    />
  </div>
</template>

```


## Префікс, суфікс і лічильник

`prefix` і `suffix` — текст, приклеєний до поля ззовні: `https://`, `+380`,
`грн`. Саме ззовні, а не в слотах `leading`/`trailing`: слот резервує місце
під іконку, і довший текст наїжджав би на введене значення. Префікс і
суфікс входять у доступну назву поля — «Ціна, грн» пояснює, що вводити.

`maxLength` передається як нативний `maxlength`, а з `showCount` під полем
з'являється лічильник — так само, як в `UiTextarea`.


Example (app/demos/input/InputAddons.vue):

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

const site = ref('tatet.ua')
const price = ref('1250')
const bio = ref('Дизайн-системи і доступність')
</script>

<template>
  <div class="w-full max-w-sm space-y-4">
    <!-- inputmode — не props: він доходить до самого <input>, як і будь-який
         інший нативний атрибут. -->
    <UiInput v-model="site" label="Сайт" prefix="https://" inputmode="url" spellcheck="false" />
    <UiInput v-model="price" label="Ціна" suffix="грн" inputmode="decimal" />
    <UiInput
      v-model="bio"
      label="Коротко про себе"
      hint="Видно в профілі"
      :max-length="60"
      show-count
    />
  </div>
</template>

```


## Атрибути

Усе, що не є props, іде на сам `<input>`: `aria-label`, `inputmode`,
`maxlength`, `autofocus`, `enterkeyhint`, `data-*`, слухачі на кшталт
`@paste`. `class` і `style` лишаються на обгортці разом із лейблом — вони
потрібні для відступів і місця в сітці форми. Раніше на обгортку йшло все,
і поле без видимого лейбла з `aria-label` лишалося без доступної назви.

## API

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

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

Для будь-якого однорядкового введення. Для багаторядкового — `UiTextarea`.

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

Не ставте поле без `label`. `placeholder` замість лейбла зникає при першому
ж символі, і користувач більше не бачить, що саме він заповнює.

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

Окремого булевого прапорця помилки немає навмисно: стан вмикає сама
наявність тексту в `error`. Так неможливо отримати червоне поле без
пояснення чому.

`aria-describedby` вказує рівно на один активний опис. Якби туди потрапляли
і підказка, і помилка одночасно, скрінрідер зачитав би інструкцію, яку
користувач щойно порушив, раніше за причину відмови.

Мобільні розміри довші за десктопні (`h-12` → `md:h-9`, 45px за кореня
15px): нижче 44px палець промахується, а текст 16px не дає iOS Safari
зумувати сторінку при фокусі. Саме 16px у пікселях (`text-[16px]`), а не
`text-base`: корінь документа 15px, і `1rem` давав 15px — iOS зумував
кожне поле, хоча документація обіцяла протилежне.

Кнопки очищення й показу пароля — 26px на око, але мають невидиму зону
дотику 45×45 (спільний `clearButtonClass` з `uiFieldStyles`).

## Портування

Разом із компонентом копіюйте `uiFieldStyles.ts` — без нього поле лишиться
без стилів.


## Event descriptions

- `update:modelValue`: Зміна значення. Для `type="number"` порожнє поле віддає `null`, а не `NaN`.
- `focus`: Поле отримало фокус.
- `blur`: Поле втратило фокус.
- `clear`: Натиснуто кнопку очищення (`clearable`). Значення вже скинуто через `update:modelValue`.


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