Data Grid

Column Visibility

Сетка с меню видимости колонок: читатель сам собирает набор столбцов флажками, а последнюю оставшуюся колонку выключить нельзя.

  • datagrid
  • columns
  • visibility
  • table

Превью

1440pxHost theme

Использовать с AI

  1. 1. Скопируйте ссылку.
  2. 2. Напишите агенту своими словами и вставьте её в предложение.
  3. 3. Агент откроет ссылку и поставит компонент из registry.

размести это в шапке: https://vibeui.ru/c/datagrid-013

Складские остатки

Показано колонок: 4 из 5

Набор колонок настраивается в меню «Колонки»
АртикулТоварПоставщикОстатокЦена
SKU-4410Кресло «Тайга»Лесной цех2418 900 ₽
SKU-4411Стол «Плёс»Мебель Юга332 400 ₽
SKU-4412Полка «Ветка»Лесной цех615 400 ₽
SKU-4413Комод «Пойма»Север-Дом827 600 ₽
SKU-4414Тумба «Исток»Север-Дом012 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.json
https://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>
    </>
  )
}