Data Grid
Column Visibility
Сетка с меню видимости колонок: читатель сам собирает набор столбцов флажками, а последнюю оставшуюся колонку выключить нельзя.
- datagrid
- columns
- visibility
- table
Превью
Использовать с AI
- 1. Скопируйте ссылку.
- 2. Напишите агенту своими словами и вставьте её в предложение.
- 3. Агент откроет ссылку и поставит компонент из registry.
размести это в шапке: https://vibeui.ru/c/datagrid-013
Складские остатки
Показано колонок: 4 из 5
| Артикул | Товар | Поставщик | Остаток | Цена |
|---|---|---|---|---|
| SKU-4410 | Кресло «Тайга» | Лесной цех | 24 | 18 900 ₽ |
| SKU-4411 | Стол «Плёс» | Мебель Юга | 3 | 32 400 ₽ |
| SKU-4412 | Полка «Ветка» | Лесной цех | 61 | 5 400 ₽ |
| SKU-4413 | Комод «Пойма» | Север-Дом | 8 | 27 600 ₽ |
| SKU-4414 | Тумба «Исток» | Север-Дом | 0 | 12 300 ₽ |
Показать полную инструкцию
То, что лежит по ссылке в развёрнутом виде. Нужна, если агент не может открыть ссылку — тогда вставьте этот текст целиком.
# Установка и размещение «datagrid-013» (Column Visibility) из VibeUI
## 1. Сначала установка — не пропускай, не пересоздавай
Выполни эту команду до того, как писать код:
npx shadcn@latest add https://vibeui.ru/r/datagrid-013.json
Registry item: https://vibeui.ru/r/datagrid-013.json
Ставится в: components/vibeui/datagrid-013.tsx (точный путь следует алиасам components.json этого проекта).
npm-зависимости: нет.
Registry-зависимости: нет.
Ставь из реестра. Не пересоздавай по описанию, не подменяй похожим
компонентом из другой библиотеки и не переписывай под стиль проекта.
## 2. Что это
Сетка с меню видимости колонок: читатель сам собирает набор столбцов флажками, а последнюю оставшуюся колонку выключить нельзя.
Сетка с меню видимости колонок: набор столбцов собирается флажками, последняя колонка защищена от выключения. Ноль зависимостей, один файл.
## 3. Как использовать
import { Datagrid013 } from "@/components/vibeui/datagrid-013"
<Datagrid013
caption="Колонки настраиваются в меню"
menuLabel="Показать колонки"
/>
Полный список пропсов — в установленном файле.
## 4. Куда поставить
Это мелкий inline-компонент. Поставь его ровно туда, куда просил
пользователь, внутрь существующей разметки. Не создавай ради него
новую страницу, секцию или обёртку. Если на этом месте уже стоит похожий
контрол — замени его, а не добавляй второй.
Куда поставить: ___
(Эту строку заполняет пользователь. Если она осталась пустой — спроси,
а не угадывай.)
## 5. Сохранить как установлено
- локальную палитру --vibeui-datagrid-013-* и не подменять её токенами вашей темы
- меню как fieldset с legend и чекбоксами: список кнопок не сообщит, что это одна группа настроек
- блокировку последней видимой колонки — пустая таблица без столбцов ничего не показывает
- закрытие меню по Escape: панель поверх таблицы обязана убираться с клавиатуры
- aria-live у счётчика колонок, иначе смена набора для скринридера проходит бесследно
- светлую подложку сетки: на тёмной карточке каталога тёмный текст иначе пропадает
## 6. Можно менять
- подпись под шапкой через caption
- подпись кнопки меню через menuLabel
- состав склада через rows
- акцентный цвет через accent и ширину сетки через max-width
## 7. Правила
- Набор колонок живёт в состоянии и сбрасывается при перезагрузке — сохраняйте его сами.
- Колонка артикула вынесена из списка намеренно: это заголовок строки, без него таблица теряет опору.
- Меню не закрывается по клику мимо: добавьте обработчик на документ, если это нужно.
- Не выносите CSS-переменные в globals.css: компонент обязан оставаться одним файлом.
## 8. Проверка
- рендерится без ошибок в консоли;
- выглядит так же, как превью на странице VibeUI, откуда взята ссылка;
- если нет — ты изменил что-то из раздела 5, верни как было.Для разработчика
npx shadcn@latest add https://vibeui.ru/r/datagrid-013.jsonhttps://vibeui.ru/r/datagrid-013.jsonКомпонент самодостаточен: один файл, без зависимостей, палитра в --vibeui-datagrid-013-*. Клиентский: useState хранит список скрытых ключей колонок и состояние меню. Меню — не список ссылок, а fieldset с legend и настоящими чекбоксами: скринридер объявляет и группу, и каждое имя колонки. Чекбокс последней видимой колонки блокируется, иначе таблица схлопывается до одного столбца артикулов. Escape на корне закрывает меню — открытая панель поверх таблицы обязана закрываться с клавиатуры. Счётчик показанных колонок объявлен aria-live: смена набора иначе проходит бесследно. Прокрутка вынесена в контейнер с role=region, aria-label и tabindex=0.
Исходник компонента
Тот же файл, который поставит агент. Нужен, если вы предпочитаете скопировать код руками.
"use client"
import { useState } from "react"
import type { ComponentPropsWithoutRef, CSSProperties } from "react"
export type Datagrid013Row = {
id: string
product: string
vendor: string
stock: number
price: number
updated: string
}
export type Datagrid013Props = Omit<
ComponentPropsWithoutRef<"section">,
"children"
> & {
rows?: Datagrid013Row[]
caption?: string
menuLabel?: string
accent?: string
}
// Идея компонента: набор колонок выбирает читатель, а не разработчик.
// Меню видимости — не декоративный список, а группа настоящих чекбоксов
// в fieldset с legend: скринридер объявляет и группу, и каждое имя колонки.
// Последнюю видимую колонку выключить нельзя — таблица без колонок теряет
// смысл, поэтому её чекбокс блокируется, а не просто игнорируется.
const STYLES = `
:where([data-vibeui-block="datagrid-013"]){
--vibeui-datagrid-013-bg:oklch(1 0 0);
--vibeui-datagrid-013-fg:oklch(0.23 0.014 285);
--vibeui-datagrid-013-muted:oklch(0.55 0.014 285);
--vibeui-datagrid-013-border:oklch(0.92 0.006 285);
--vibeui-datagrid-013-head:oklch(0.975 0.003 285);
--vibeui-datagrid-013-accent:oklch(0.52 0.16 275);
--vibeui-datagrid-013-shadow:oklch(0.23 0.014 285 / 14%);
--vibeui-datagrid-013-font:ui-sans-serif,system-ui,-apple-system,"Segoe UI",Roboto,"Helvetica Neue",Arial,sans-serif;
}
[data-vibeui-block="datagrid-013"]{
box-sizing:border-box;width:100%;max-width:56rem;margin:0 auto;position:relative;
background:var(--vibeui-datagrid-013-bg);color:var(--vibeui-datagrid-013-fg);
border:1px solid var(--vibeui-datagrid-013-border);border-radius:0.875rem;
font-family:var(--vibeui-datagrid-013-font);
}
[data-vibeui-block="datagrid-013"] *{box-sizing:border-box}
[data-vibeui-block="datagrid-013"] [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-013-border);
}
[data-vibeui-block="datagrid-013"] [data-part="title"]{margin:0;font-size:0.875rem;font-weight:650;margin-inline-end:auto}
[data-vibeui-block="datagrid-013"] [data-part="count"]{margin:0;font-size:0.75rem;color:var(--vibeui-datagrid-013-muted)}
[data-vibeui-block="datagrid-013"] [data-part="menu-wrap"]{position:relative}
[data-vibeui-block="datagrid-013"] [data-part="trigger"]{
appearance:none;cursor:pointer;font:inherit;font-size:0.75rem;font-weight:550;
display:inline-flex;align-items:center;gap:0.375rem;
padding:0.375rem 0.6875rem;border-radius:0.5rem;
border:1px solid var(--vibeui-datagrid-013-border);
background:var(--vibeui-datagrid-013-bg);color:var(--vibeui-datagrid-013-fg);
}
[data-vibeui-block="datagrid-013"] [data-part="trigger"][aria-expanded="true"]{
border-color:var(--vibeui-datagrid-013-accent);color:var(--vibeui-datagrid-013-accent);
}
[data-vibeui-block="datagrid-013"] [data-part="trigger"]:focus-visible{outline:2px solid var(--vibeui-datagrid-013-accent);outline-offset:2px}
[data-vibeui-block="datagrid-013"] [data-part="trigger"]::after{content:"";width:0.375rem;height:0.375rem;border-right:1.5px solid currentColor;border-bottom:1.5px solid currentColor;transform:translateY(-1px) rotate(45deg)}
[data-vibeui-block="datagrid-013"] [data-part="menu"]{
position:absolute;inset-inline-end:0;inset-block-start:calc(100% + 0.375rem);z-index:5;
min-width:12rem;margin:0;padding:0.625rem 0.75rem 0.5rem;
border:1px solid var(--vibeui-datagrid-013-border);border-radius:0.75rem;
background:var(--vibeui-datagrid-013-bg);box-shadow:0 12px 28px var(--vibeui-datagrid-013-shadow);
}
[data-vibeui-block="datagrid-013"] [data-part="menu"] legend{
padding:0;font-size:0.6875rem;font-weight:600;letter-spacing:0.04em;text-transform:uppercase;
color:var(--vibeui-datagrid-013-muted);
}
[data-vibeui-block="datagrid-013"] [data-part="option"]{
display:flex;align-items:center;gap:0.5rem;padding:0.3125rem 0;font-size:0.8125rem;cursor:pointer;
}
[data-vibeui-block="datagrid-013"] [data-part="option"]:has(input:disabled){cursor:not-allowed;color:var(--vibeui-datagrid-013-muted)}
[data-vibeui-block="datagrid-013"] [data-part="option"] input{accent-color:var(--vibeui-datagrid-013-accent);margin:0;width:0.9375rem;height:0.9375rem}
[data-vibeui-block="datagrid-013"] [data-part="option"] input:focus-visible{outline:2px solid var(--vibeui-datagrid-013-accent);outline-offset:2px}
[data-vibeui-block="datagrid-013"] [data-part="reset"]{
appearance:none;cursor:pointer;font:inherit;font-size:0.75rem;padding:0.25rem 0;margin-top:0.25rem;
border:0;border-top:1px solid var(--vibeui-datagrid-013-border);width:100%;text-align:start;
background:transparent;color:var(--vibeui-datagrid-013-accent);
}
[data-vibeui-block="datagrid-013"] [data-part="reset"]:focus-visible{outline:2px solid var(--vibeui-datagrid-013-accent);outline-offset:2px}
[data-vibeui-block="datagrid-013"] [data-part="scroll"]{overflow-x:auto;border-radius:0 0 0.875rem 0.875rem}
[data-vibeui-block="datagrid-013"] [data-part="scroll"]:focus-visible{outline:2px solid var(--vibeui-datagrid-013-accent);outline-offset:-2px}
[data-vibeui-block="datagrid-013"] table{width:100%;border-collapse:collapse;font-size:0.8125rem}
[data-vibeui-block="datagrid-013"] caption{
padding:0.625rem 0.875rem 0;text-align:left;font-size:0.75rem;color:var(--vibeui-datagrid-013-muted);caption-side:top;
}
[data-vibeui-block="datagrid-013"] th,
[data-vibeui-block="datagrid-013"] td{
padding:0.5rem 0.875rem;text-align:left;white-space:nowrap;
border-top:1px solid var(--vibeui-datagrid-013-border);
}
[data-vibeui-block="datagrid-013"] thead th{background:var(--vibeui-datagrid-013-head);font-weight:600}
[data-vibeui-block="datagrid-013"] [data-align="end"]{text-align:right;font-variant-numeric:tabular-nums}
[data-vibeui-block="datagrid-013"] [data-part="sku"]{font-family:ui-monospace,SFMono-Regular,Menlo,Consolas,monospace;font-size:0.75rem;font-weight:500}
[data-vibeui-block="datagrid-013"] [data-low="true"]{color:oklch(0.55 0.17 28);font-weight:600}
@media (prefers-reduced-motion:reduce){[data-vibeui-block="datagrid-013"] *{animation:none!important;transition:none!important}}
`
type ColumnKey = "product" | "vendor" | "stock" | "price" | "updated"
const COLUMNS: { key: ColumnKey; label: string; numeric: boolean }[] = [
{ key: "product", label: "Товар", numeric: false },
{ key: "vendor", label: "Поставщик", numeric: false },
{ key: "stock", label: "Остаток", numeric: true },
{ key: "price", label: "Цена", numeric: true },
{ key: "updated", label: "Обновлено", numeric: false },
]
const DEFAULT_ROWS: Datagrid013Row[] = [
{
id: "SKU-4410",
product: "Кресло «Тайга»",
vendor: "Лесной цех",
stock: 24,
price: 18900,
updated: "12 марта",
},
{
id: "SKU-4411",
product: "Стол «Плёс»",
vendor: "Мебель Юга",
stock: 3,
price: 32400,
updated: "11 марта",
},
{
id: "SKU-4412",
product: "Полка «Ветка»",
vendor: "Лесной цех",
stock: 61,
price: 5400,
updated: "12 марта",
},
{
id: "SKU-4413",
product: "Комод «Пойма»",
vendor: "Север-Дом",
stock: 8,
price: 27600,
updated: "9 марта",
},
{
id: "SKU-4414",
product: "Тумба «Исток»",
vendor: "Север-Дом",
stock: 0,
price: 12300,
updated: "8 марта",
},
]
function cellValue(row: Datagrid013Row, key: ColumnKey) {
if (key === "price") {
return `${row.price.toLocaleString("ru-RU")} ₽`
}
if (key === "stock") {
return String(row.stock)
}
return row[key]
}
/**
* Сетка с меню видимости колонок: читатель сам собирает набор столбцов,
* последняя видимая колонка защищена от выключения. Один файл, ноль зависимостей.
*/
export function Datagrid013({
rows = DEFAULT_ROWS,
caption = "Набор колонок настраивается в меню «Колонки»",
menuLabel = "Колонки",
accent,
className,
style,
...props
}: Datagrid013Props) {
const [hidden, setHidden] = useState<ColumnKey[]>(["updated"])
const [open, setOpen] = useState(false)
const visible = COLUMNS.filter((column) => !hidden.includes(column.key))
const last = visible.length === 1
const palette = {
...(accent ? { "--vibeui-datagrid-013-accent": accent } : null),
...style,
} as CSSProperties
return (
<>
<style href="vibeui-datagrid-013" precedence="medium">
{STYLES}
</style>
<section
{...props}
data-vibeui-block="datagrid-013"
className={className}
style={palette}
onKeyDown={(event) => {
if (event.key === "Escape" && open) {
setOpen(false)
}
}}
>
<div data-part="bar">
<h3 data-part="title">Складские остатки</h3>
<p data-part="count" aria-live="polite">
Показано колонок: {visible.length} из {COLUMNS.length}
</p>
<div data-part="menu-wrap">
<button
type="button"
data-part="trigger"
aria-expanded={open}
onClick={() => setOpen((value) => !value)}
>
{menuLabel}
</button>
{open ? (
<fieldset data-part="menu">
<legend>Видимость колонок</legend>
{COLUMNS.map((column) => {
const shown = !hidden.includes(column.key)
return (
<label key={column.key} data-part="option">
<input
type="checkbox"
checked={shown}
disabled={shown && last}
onChange={() =>
setHidden((current) =>
current.includes(column.key)
? current.filter((key) => key !== column.key)
: [...current, column.key],
)
}
/>
{column.label}
</label>
)
})}
<button
type="button"
data-part="reset"
onClick={() => setHidden([])}
>
Показать все колонки
</button>
</fieldset>
) : null}
</div>
</div>
<div
data-part="scroll"
role="region"
aria-label="Таблица остатков, прокручивается вбок"
tabIndex={0}
>
<table>
<caption>{caption}</caption>
<thead>
<tr>
<th scope="col">Артикул</th>
{visible.map((column) => (
<th
key={column.key}
scope="col"
data-align={column.numeric ? "end" : undefined}
>
{column.label}
</th>
))}
</tr>
</thead>
<tbody>
{rows.map((row) => (
<tr key={row.id}>
<th scope="row" data-part="sku">
{row.id}
</th>
{visible.map((column) => (
<td
key={column.key}
data-align={column.numeric ? "end" : undefined}
data-low={
column.key === "stock" && row.stock < 5
? "true"
: undefined
}
>
{cellValue(row, column.key)}
</td>
))}
</tr>
))}
</tbody>
</table>
</div>
</section>
</>
)
}