Data Grid
Inline Cell Edit
Сетка с правкой значения прямо в ячейке: Enter подтверждает, Escape возвращает прежнее, а изменённые ячейки помечены до нажатия «Сохранить».
- datagrid
- inline-edit
- form
- table
Превью
Использовать с AI
- 1. Скопируйте ссылку.
- 2. Напишите агенту своими словами и вставьте её в предложение.
- 3. Агент откроет ссылку и поставит компонент из registry.
размести это в шапке: https://vibeui.ru/c/datagrid-005
Прайс-лист
Цена и остаток редактируются
| Артикул | Позиция | Цена, ₽ | Остаток |
|---|---|---|---|
| FUR-1042 | |||
| LGT-0318 | |||
| FUR-1188 | |||
| STG-0455 | |||
| TXT-0902 |
Показать полную инструкцию
То, что лежит по ссылке в развёрнутом виде. Нужна, если агент не может открыть ссылку — тогда вставьте этот текст целиком.
# Установка и размещение «datagrid-005» (Inline Cell Edit) из VibeUI
## 1. Сначала установка — не пропускай, не пересоздавай
Выполни эту команду до того, как писать код:
npx shadcn@latest add https://vibeui.ru/r/datagrid-005.json
Registry item: https://vibeui.ru/r/datagrid-005.json
Ставится в: components/vibeui/datagrid-005.tsx (точный путь следует алиасам components.json этого проекта).
npm-зависимости: нет.
Registry-зависимости: нет.
Ставь из реестра. Не пересоздавай по описанию, не подменяй похожим
компонентом из другой библиотеки и не переписывай под стиль проекта.
## 2. Что это
Сетка с правкой значения прямо в ячейке: Enter подтверждает, Escape возвращает прежнее, а изменённые ячейки помечены до нажатия «Сохранить».
Сетка с правкой ячейки на месте: клавиатура, отмена по Escape и видимые пометки несохранённых изменений. Ноль зависимостей, один файл.
## 3. Как использовать
import { Datagrid005 } from "@/components/vibeui/datagrid-005"
<Datagrid005
caption="Нажмите на ячейку или дойдите до неё табом"
hint="Цена и остаток редактируются"
/>
Полный список пропсов — в установленном файле.
## 4. Куда поставить
Это мелкий inline-компонент. Поставь его ровно туда, куда просил
пользователь, внутрь существующей разметки. Не создавай ради него
новую страницу, секцию или обёртку. Если на этом месте уже стоит похожий
контрол — замени его, а не добавляй второй.
Куда поставить: ___
(Эту строку заполняет пользователь. Если она осталась пустой — спроси,
а не угадывай.)
## 5. Сохранить как установлено
- локальную палитру --vibeui-datagrid-005-* и не подменять её токенами вашей темы
- ячейку-кнопку в покое: правка обязана открываться с клавиатуры, div с onClick этого не даёт
- пару Enter и Escape — без отмены правка на месте превращается в ловушку
- пометку изменённых ячеек до сохранения: иначе непонятно, что именно уедет на сервер
- aria-label у поля ввода с названием колонки и строки — одинокое поле в таблице ничего не сообщает
- светлую подложку сетки: на тёмной карточке каталога тёмный текст иначе пропадает
## 6. Можно менять
- подпись под шапкой через caption
- поясняющую строку в панели через hint
- состав прайса через rows
- акцентный цвет через accent
## 7. Правила
- Компонент ничего не отправляет: «Сохранить» переносит правки в состояние, запрос вешайте сами.
- Пустое значение не принимается — это защита от случайного стирания, а не валидация полей.
- Потеря фокуса сохраняет значение: если нужна отмена по клику мимо, поменяйте обработчик onBlur.
- Не выносите CSS-переменные в globals.css: компонент обязан оставаться одним файлом.
## 8. Проверка
- рендерится без ошибок в консоли;
- выглядит так же, как превью на странице VibeUI, откуда взята ссылка;
- если нет — ты изменил что-то из раздела 5, верни как было.Для разработчика
npx shadcn@latest add https://vibeui.ru/r/datagrid-005.jsonhttps://vibeui.ru/r/datagrid-005.jsonКомпонент самодостаточен: один файл, без зависимостей, палитра в --vibeui-datagrid-005-*. Клиентский: базовые строки лежат в одном состоянии, правки — накладкой в другом, поэтому «Отменить» возвращает всё одним действием, а «Сохранить» переносит накладку в базу. Ячейка в покое — кнопка на всю ширину: только так правка открывается с клавиатуры, div с onClick этого не даёт. Поле ввода получает фокус при появлении и несёт aria-label с названием колонки и строки. Enter подтверждает, Escape отменяет, потеря фокуса сохраняет. Изменённые ячейки помечены заливкой и точкой, а счётчик несохранённого объявлен aria-live.
Исходник компонента
Тот же файл, который поставит агент. Нужен, если вы предпочитаете скопировать код руками.
"use client"
import { useState } from "react"
import type { ComponentPropsWithoutRef, CSSProperties } from "react"
export type Datagrid005Row = {
id: string
name: string
sku: string
price: number
stock: number
}
export type Datagrid005Props = Omit<
ComponentPropsWithoutRef<"section">,
"children"
> & {
rows?: Datagrid005Row[]
caption?: string
hint?: string
accent?: string
}
type Field = "name" | "price" | "stock"
// Идея компонента: правка значения прямо в ячейке. Ячейка в покое — кнопка,
// а не div с onClick: только так правка открывается с клавиатуры. Enter
// подтверждает, Escape возвращает прежнее значение, потерянный фокус
// сохраняет. Изменённые ячейки помечены до нажатия «Сохранить», поэтому
// видно, что именно уедет на сервер.
const STYLES = `
:where([data-vibeui-block="datagrid-005"]){
--vibeui-datagrid-005-bg:oklch(1 0 0);
--vibeui-datagrid-005-fg:oklch(0.23 0.014 60);
--vibeui-datagrid-005-muted:oklch(0.55 0.014 60);
--vibeui-datagrid-005-border:oklch(0.92 0.006 60);
--vibeui-datagrid-005-head:oklch(0.975 0.004 60);
--vibeui-datagrid-005-accent:oklch(0.58 0.15 55);
--vibeui-datagrid-005-dirty:oklch(0.58 0.15 55 / 12%);
--vibeui-datagrid-005-font:ui-sans-serif,system-ui,-apple-system,"Segoe UI",Roboto,"Helvetica Neue",Arial,sans-serif;
}
[data-vibeui-block="datagrid-005"]{
box-sizing:border-box;width:100%;max-width:52rem;margin:0 auto;
background:var(--vibeui-datagrid-005-bg);color:var(--vibeui-datagrid-005-fg);
border:1px solid var(--vibeui-datagrid-005-border);border-radius:0.875rem;
font-family:var(--vibeui-datagrid-005-font);overflow:hidden;
}
[data-vibeui-block="datagrid-005"] *{box-sizing:border-box}
[data-vibeui-block="datagrid-005"] [data-part="bar"]{
display:flex;flex-wrap:wrap;align-items:center;gap:0.5rem;
padding:0.75rem 0.875rem;border-bottom:1px solid var(--vibeui-datagrid-005-border);
}
[data-vibeui-block="datagrid-005"] [data-part="bar-text"]{margin-inline-end:auto}
[data-vibeui-block="datagrid-005"] [data-part="title"]{margin:0;font-size:0.875rem;font-weight:650}
[data-vibeui-block="datagrid-005"] [data-part="hint"]{
margin:0;font-size:0.75rem;color:var(--vibeui-datagrid-005-muted);
}
[data-vibeui-block="datagrid-005"] [data-part="status"]{
margin:0;font-size:0.75rem;font-weight:600;color:var(--vibeui-datagrid-005-accent);
}
[data-vibeui-block="datagrid-005"] [data-part="bar"] button{
appearance:none;cursor:pointer;font:inherit;font-size:0.75rem;font-weight:550;
padding:0.375rem 0.75rem;border-radius:0.5rem;
border:1px solid var(--vibeui-datagrid-005-border);
background:var(--vibeui-datagrid-005-bg);color:var(--vibeui-datagrid-005-fg);
}
[data-vibeui-block="datagrid-005"] [data-part="bar"] button[data-tone="primary"]{
border-color:transparent;background:var(--vibeui-datagrid-005-accent);color:oklch(1 0 0);
}
[data-vibeui-block="datagrid-005"] [data-part="bar"] button:disabled{opacity:.45;cursor:not-allowed}
[data-vibeui-block="datagrid-005"] [data-part="bar"] button:focus-visible{outline:2px solid var(--vibeui-datagrid-005-accent);outline-offset:2px}
[data-vibeui-block="datagrid-005"] [data-part="scroll"]{overflow-x:auto}
[data-vibeui-block="datagrid-005"] [data-part="scroll"]:focus-visible{outline:2px solid var(--vibeui-datagrid-005-accent);outline-offset:-2px}
[data-vibeui-block="datagrid-005"] table{width:100%;border-collapse:collapse;font-size:0.8125rem}
[data-vibeui-block="datagrid-005"] caption{
padding:0 0.875rem 0.625rem;text-align:left;
font-size:0.75rem;color:var(--vibeui-datagrid-005-muted);
}
[data-vibeui-block="datagrid-005"] th,
[data-vibeui-block="datagrid-005"] td{
text-align:left;white-space:nowrap;padding:0;
border-top:1px solid var(--vibeui-datagrid-005-border);
}
[data-vibeui-block="datagrid-005"] thead th{
padding:0.5rem 0.875rem;background:var(--vibeui-datagrid-005-head);font-weight:600;
}
[data-vibeui-block="datagrid-005"] [data-part="static"]{
display:block;padding:0.4375rem 0.875rem;color:var(--vibeui-datagrid-005-muted);
font-family:ui-monospace,SFMono-Regular,Menlo,Consolas,monospace;font-size:0.75rem;
}
/* Ячейка в покое — кнопка на всю ширину: правка обязана открываться
с клавиатуры, а не только двойным щелчком. */
[data-vibeui-block="datagrid-005"] [data-part="cell"]{
display:flex;align-items:center;gap:0.375rem;width:100%;
appearance:none;border:0;background:none;cursor:text;font:inherit;
padding:0.4375rem 0.875rem;color:inherit;text-align:left;
border-radius:0;transition:background-color .14s ease;
}
[data-vibeui-block="datagrid-005"] td[data-align="end"] [data-part="cell"]{justify-content:flex-end}
[data-vibeui-block="datagrid-005"] [data-part="cell"]:hover{background:var(--vibeui-datagrid-005-head)}
[data-vibeui-block="datagrid-005"] [data-part="cell"]:focus-visible{outline:2px solid var(--vibeui-datagrid-005-accent);outline-offset:-2px}
[data-vibeui-block="datagrid-005"] [data-part="pen"]{
color:var(--vibeui-datagrid-005-muted);font-size:0.6875rem;opacity:0;
}
[data-vibeui-block="datagrid-005"] [data-part="cell"]:hover [data-part="pen"],
[data-vibeui-block="datagrid-005"] [data-part="cell"]:focus-visible [data-part="pen"]{opacity:1}
[data-vibeui-block="datagrid-005"] td[data-dirty="true"]{background:var(--vibeui-datagrid-005-dirty)}
[data-vibeui-block="datagrid-005"] [data-part="dot"]{
width:0.375rem;height:0.375rem;border-radius:999px;
background:var(--vibeui-datagrid-005-accent);flex:none;
}
[data-vibeui-block="datagrid-005"] input{
width:100%;font:inherit;font-size:0.8125rem;color:inherit;
padding:0.375rem 0.8125rem;margin:0;
border:2px solid var(--vibeui-datagrid-005-accent);border-radius:0.375rem;
background:var(--vibeui-datagrid-005-bg);
}
[data-vibeui-block="datagrid-005"] td[data-align="end"] input{text-align:right}
[data-vibeui-block="datagrid-005"] input:focus{outline:none}
[data-vibeui-block="datagrid-005"] [data-align="end"]{text-align:right;font-variant-numeric:tabular-nums}
@media (prefers-reduced-motion:reduce){[data-vibeui-block="datagrid-005"] *{animation:none!important;transition:none!important}}
`
const DEFAULT_ROWS: Datagrid005Row[] = [
{ id: "p1", name: "Кресло Ostro", sku: "FUR-1042", price: 18900, stock: 42 },
{ id: "p2", name: "Лампа Pillar", sku: "LGT-0318", price: 6400, stock: 7 },
{ id: "p3", name: "Стол Grano", sku: "FUR-1188", price: 32500, stock: 15 },
{ id: "p4", name: "Полка Rift", sku: "STG-0455", price: 11200, stock: 23 },
{ id: "p5", name: "Ковёр Dune", sku: "TXT-0902", price: 24700, stock: 4 },
]
const COLUMNS: { key: Field; title: string; numeric?: boolean }[] = [
{ key: "name", title: "Позиция" },
{ key: "price", title: "Цена, ₽", numeric: true },
{ key: "stock", title: "Остаток", numeric: true },
]
function show(field: Field, raw: string) {
if (field === "price") {
const value = Number(raw)
return Number.isFinite(value) ? value.toLocaleString("ru-RU") : raw
}
return raw
}
/**
* Сетка с правкой ячейки на месте: Enter подтверждает, Escape отменяет,
* изменённые ячейки помечены до сохранения. Один файл, ноль зависимостей.
*/
export function Datagrid005({
rows = DEFAULT_ROWS,
caption = "Нажмите на ячейку или дойдите до неё табом и нажмите Enter",
hint = "Цена и остаток редактируются",
accent,
className,
style,
...props
}: Datagrid005Props) {
const [base, setBase] = useState(rows)
const [edits, setEdits] = useState<Record<string, string>>({})
const [editing, setEditing] = useState<string | null>(null)
const [draft, setDraft] = useState("")
const original = (row: Datagrid005Row, field: Field) => String(row[field])
const current = (row: Datagrid005Row, field: Field) =>
edits[`${row.id}.${field}`] ?? original(row, field)
const dirty = Object.entries(edits).filter(([key, value]) => {
const [id, field] = key.split(".") as [string, Field]
const row = base.find((entry) => entry.id === id)
return row ? value !== original(row, field) : false
})
const open = (row: Datagrid005Row, field: Field) => {
setEditing(`${row.id}.${field}`)
setDraft(current(row, field))
}
const commit = () => {
if (!editing) return
const trimmed = draft.trim()
if (trimmed !== "") {
setEdits((all) => ({ ...all, [editing]: trimmed }))
}
setEditing(null)
}
const save = () => {
setBase((all) =>
all.map((row) => {
const next = { ...row }
for (const column of COLUMNS) {
const field = column.key
const value = edits[`${row.id}.${field}`]
if (value === undefined) continue
if (field === "name") next.name = value
else next[field] = Number(value) || 0
}
return next
}),
)
setEdits({})
setEditing(null)
}
const palette = {
...(accent ? { "--vibeui-datagrid-005-accent": accent } : null),
...style,
} as CSSProperties
return (
<>
<style href="vibeui-datagrid-005" precedence="medium">
{STYLES}
</style>
<section
{...props}
data-vibeui-block="datagrid-005"
className={className}
style={palette}
>
<div data-part="bar">
<div data-part="bar-text">
<h3 data-part="title">Прайс-лист</h3>
{dirty.length > 0 ? (
<p data-part="status" aria-live="polite">
Не сохранено: {dirty.length}
</p>
) : (
<p data-part="hint">{hint}</p>
)}
</div>
<button
type="button"
disabled={dirty.length === 0}
onClick={() => {
setEdits({})
setEditing(null)
}}
>
Отменить
</button>
<button
type="button"
data-tone="primary"
disabled={dirty.length === 0}
onClick={save}
>
Сохранить
</button>
</div>
<div
data-part="scroll"
role="region"
aria-label="Таблица прайс-листа, прокручивается вбок"
tabIndex={0}
>
<table>
<caption>{caption}</caption>
<thead>
<tr>
<th scope="col">Артикул</th>
{COLUMNS.map((column) => (
<th
key={column.key}
scope="col"
data-align={column.numeric ? "end" : undefined}
>
{column.title}
</th>
))}
</tr>
</thead>
<tbody>
{base.map((row) => (
<tr key={row.id}>
<th scope="row">
<span data-part="static">{row.sku}</span>
</th>
{COLUMNS.map((column) => {
const key = `${row.id}.${column.key}`
const value = current(row, column.key)
const changed = value !== original(row, column.key)
return (
<td
key={column.key}
data-align={column.numeric ? "end" : undefined}
data-dirty={changed}
>
{editing === key ? (
<input
autoFocus
value={draft}
inputMode={column.numeric ? "numeric" : "text"}
aria-label={`${column.title}, ${row.name}`}
onChange={(event) => setDraft(event.target.value)}
onBlur={commit}
onKeyDown={(event) => {
if (event.key === "Enter") {
event.preventDefault()
commit()
}
if (event.key === "Escape") {
event.preventDefault()
setEditing(null)
}
}}
/>
) : (
<button
type="button"
data-part="cell"
aria-label={`Изменить: ${column.title}, ${row.name}, сейчас ${value}`}
onClick={() => open(row, column.key)}
>
{changed ? (
<span data-part="dot" aria-hidden="true" />
) : null}
{show(column.key, value)}
<span data-part="pen" aria-hidden="true">
✎
</span>
</button>
)}
</td>
)
})}
</tr>
))}
</tbody>
</table>
</div>
</section>
</>
)
}