# InlineEdit

Текст, який перетворюється на поле редагування — патерн «клікни й правь».


Редагування на місці замість «відкрий модалку → знайди поле → збережи».
Зведено з трьох незалежних реалізацій InlineEdit — рядок таблиці стає
полем за кліком, Enter — зберегти, Escape — скасувати.

## Приклад


Example (app/demos/inline-edit/InlineEditBasic.vue):

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

const author = ref('Ігор Шевченко')
const views = ref<number | null>(1284)
</script>

<template>
  <div class="grid max-w-md items-center gap-1 text-sm sm:grid-cols-[8rem_1fr] sm:gap-3">
    <span class="text-xs text-muted">Автор</span>
    <UiInlineEdit v-model="author" type="text" aria-label="Автор" />
    <span class="text-xs text-muted">Перегляди</span>
    <UiInlineEdit v-model="views" type="number" aria-label="Перегляди" />
  </div>
</template>
```


## API

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

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

Рядки таблиць і карток з поодинокими правками: автор сторінки, кількість
переглядів, назва в списку. Тип `number` валідує NaN і не емітує його.

`saveOnBlur` (типово) — зберігає по втраті фокуса: звична поведінка
таблиць. `saveOnBlur=false` — blur скасовує, зберігає лише Enter.

Незмінене значення — це скасування, а не збереження: `save` приходить лише
тоді, коли є що зберігати. Інакше таблиця, яка шле запит на `@save`,
робила б його щоразу, коли користувач просто клацнув у комірку й пішов.
Порожній рядок і `null` вважаються однаковими, як і `5` та «5» у
текстовому полі.

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

Для полів, які редагуються РАЗОМ з іншими в одній формі — там звичайний
Input і спільна кнопка «Зберегти».

Не для великих текстів: рядок у таблиці — не місце для абзаців.

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

Кнопка-рядок має `aria-label` з поточним значенням; поле — те самим
ім'ям. Escape завжди скасовує і не «протікає» в модалку навколо
(`stopPropagation`). Порожнє значення показується як `emptyText`, а не
зникає. Після Enter або Escape фокус повертається на кнопку-рядок; звичайний
blur не перехоплює фокус. Помилка пов'язана з полем через `aria-describedby`
і блокує підтвердження, доки споживач її не прибере.


## Event descriptions

- `update:modelValue`: Значення після підтвердження. Використовуйте через `v-model`.
- `edit`: Редагування почалось — поле з'явилося замість тексту.
- `save`: Зміну підтверджено (Enter, blur або клік поза полем). Лише коли значення справді змінилось.
- `cancel`: Редагування скасовано — Escape або підтвердження незміненого значення.


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