Data Grid
Pin On Demand
Широкая сетка, где закрепить колонку решает читатель: булавка в заголовке переводит столбец в липкий режим, а смещение считается от уже закреплённых соседей.
- datagrid
- sticky-column
- pinning
- table
Превью
Использовать с AI
- 1. Скопируйте ссылку.
- 2. Напишите агенту своими словами и вставьте её в предложение.
- 3. Агент откроет ссылку и поставит компонент из registry.
размести это в шапке: https://vibeui.ru/c/datagrid-014
Продажи по филиалам
Закреплено: 1 из 2
| Город | Руководитель | План | Факт | Сделок | Отток, % | NPS |
|---|---|---|---|---|---|---|
| Казань | Юсупова | 4 200 | 4 460 | 118 | 4,1 | 62 |
| Новосибирск | Ерёмин | 3 900 | 3 510 | 96 | 6,8 | 48 |
| Ростов-на-Дону | Ковалёва | 3 100 | 3 320 | 87 | 3,4 | 71 |
| Екатеринбург | Тагиров | 4 600 | 4 180 | 131 | 5,2 | 55 |
| Калининград | Шмидт | 1 800 | 2 040 | 54 | 2,9 | 74 |
Показать полную инструкцию
То, что лежит по ссылке в развёрнутом виде. Нужна, если агент не может открыть ссылку — тогда вставьте этот текст целиком.
# Установка и размещение «datagrid-014» (Pin On Demand) из VibeUI
## 1. Сначала установка — не пропускай, не пересоздавай
Выполни эту команду до того, как писать код:
npx shadcn@latest add https://vibeui.ru/r/datagrid-014.json
Registry item: https://vibeui.ru/r/datagrid-014.json
Ставится в: components/vibeui/datagrid-014.tsx (точный путь следует алиасам components.json этого проекта).
npm-зависимости: нет.
Registry-зависимости: нет.
Ставь из реестра. Не пересоздавай по описанию, не подменяй похожим
компонентом из другой библиотеки и не переписывай под стиль проекта.
## 2. Что это
Широкая сетка, где закрепить колонку решает читатель: булавка в заголовке переводит столбец в липкий режим, а смещение считается от уже закреплённых соседей.
Сетка с закреплением колонки по требованию: булавка в заголовке переводит столбец в position:sticky. Ноль зависимостей, один файл.
## 3. Как использовать
import { Datagrid014 } from "@/components/vibeui/datagrid-014"
<Datagrid014 caption="Закрепите нужные колонки" maxPinned={3} />
Полный список пропсов — в установленном файле.
## 4. Куда поставить
Это мелкий inline-компонент. Поставь его ровно туда, куда просил
пользователь, внутрь существующей разметки. Не создавай ради него
новую страницу, секцию или обёртку. Если на этом месте уже стоит похожий
контрол — замени его, а не добавляй второй.
Куда поставить: ___
(Эту строку заполняет пользователь. Если она осталась пустой — спроси,
а не угадывай.)
## 5. Сохранить как установлено
- локальную палитру --vibeui-datagrid-014-* и не подменять её токенами вашей темы
- aria-pressed на булавке: это переключатель состояния, а не обычная кнопка действия
- собственный фон у липких ячеек — без него уезжающие строки видно насквозь
- table-layout:fixed вместе с фиксированной шириной колонки: иначе смещение left посчитать нечем
- порядок закрепления по порядку колонок, а не по порядку кликов — иначе столбцы прыгают местами
- светлую подложку сетки: на тёмной карточке каталога тёмный текст иначе пропадает
## 6. Можно менять
- подпись под шапкой через caption
- предел числа закреплённых колонок через maxPinned
- состав филиалов через rows
- акцентный цвет через accent
## 7. Правила
- Закрепление работает только слева: для правого края нужна вторая переменная смещения и right вместо left.
- Все колонки одной ширины: под разноширинные колонки считайте смещение суммой, а не умножением.
- На экране 360 px две закреплённые колонки не оставляют места — снизьте maxPinned для мобильной вёрстки.
- Не выносите CSS-переменные в globals.css: компонент обязан оставаться одним файлом.
## 8. Проверка
- рендерится без ошибок в консоли;
- выглядит так же, как превью на странице VibeUI, откуда взята ссылка;
- если нет — ты изменил что-то из раздела 5, верни как было.Для разработчика
npx shadcn@latest add https://vibeui.ru/r/datagrid-014.jsonhttps://vibeui.ru/r/datagrid-014.jsonКомпонент самодостаточен: один файл, без зависимостей, палитра в --vibeui-datagrid-014-*. Клиентский: useState хранит список закреплённых ключей, но порядок берётся из порядка колонок, а не кликов — иначе столбцы менялись бы местами под курсором. Ширина колонки фиксирована переменной --vibeui-datagrid-014-col вместе с table-layout:fixed: только так left считается формулой calc, без измерений в браузере. Липкая ячейка несёт собственный фон, таблица собрана с border-collapse:separate. Булавка — кнопка с aria-pressed и собственным aria-label, число закреплений ограничено пропом. Прокрутка живёт в контейнере с role=region, aria-label и tabindex=0.
Исходник компонента
Тот же файл, который поставит агент. Нужен, если вы предпочитаете скопировать код руками.
"use client"
import { useState } from "react"
import type { ComponentPropsWithoutRef, CSSProperties } from "react"
export type Datagrid014Row = {
id: string
city: string
manager: string
plan: number
fact: number
deals: number
churn: number
nps: number
}
export type Datagrid014Props = Omit<
ComponentPropsWithoutRef<"section">,
"children"
> & {
rows?: Datagrid014Row[]
caption?: string
maxPinned?: number
accent?: string
}
// Идея компонента: закрепление колонки — решение читателя, а не вёрстки.
// Кнопка-булавка в каждом заголовке переключает aria-pressed, а колонка
// получает position:sticky со смещением, посчитанным из ширин уже
// закреплённых соседей. Ширины фиксированы через table-layout:fixed —
// без этого смещение слева пришлось бы мерить в браузере.
const STYLES = `
:where([data-vibeui-block="datagrid-014"]){
--vibeui-datagrid-014-bg:oklch(1 0 0);
--vibeui-datagrid-014-fg:oklch(0.23 0.014 285);
--vibeui-datagrid-014-muted:oklch(0.55 0.014 285);
--vibeui-datagrid-014-border:oklch(0.92 0.006 285);
--vibeui-datagrid-014-head:oklch(0.975 0.003 285);
--vibeui-datagrid-014-accent:oklch(0.5 0.15 195);
--vibeui-datagrid-014-pinbg:oklch(0.97 0.02 195);
--vibeui-datagrid-014-shadow:oklch(0.23 0.014 285 / 12%);
--vibeui-datagrid-014-col:11rem;
--vibeui-datagrid-014-font:ui-sans-serif,system-ui,-apple-system,"Segoe UI",Roboto,"Helvetica Neue",Arial,sans-serif;
}
[data-vibeui-block="datagrid-014"]{
box-sizing:border-box;width:100%;max-width:56rem;margin:0 auto;
background:var(--vibeui-datagrid-014-bg);color:var(--vibeui-datagrid-014-fg);
border:1px solid var(--vibeui-datagrid-014-border);border-radius:0.875rem;
font-family:var(--vibeui-datagrid-014-font);overflow:hidden;
}
[data-vibeui-block="datagrid-014"] *{box-sizing:border-box}
[data-vibeui-block="datagrid-014"] [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-014-border);
}
[data-vibeui-block="datagrid-014"] [data-part="title"]{margin:0;font-size:0.875rem;font-weight:650;margin-inline-end:auto}
[data-vibeui-block="datagrid-014"] [data-part="state"]{margin:0;font-size:0.75rem;color:var(--vibeui-datagrid-014-muted)}
[data-vibeui-block="datagrid-014"] [data-part="scroll"]{overflow-x:auto}
[data-vibeui-block="datagrid-014"] [data-part="scroll"]:focus-visible{outline:2px solid var(--vibeui-datagrid-014-accent);outline-offset:-2px}
[data-vibeui-block="datagrid-014"] table{
border-collapse:separate;border-spacing:0;table-layout:fixed;
width:max-content;min-width:100%;font-size:0.8125rem;
}
[data-vibeui-block="datagrid-014"] caption{
padding:0.625rem 0.875rem;text-align:left;font-size:0.75rem;color:var(--vibeui-datagrid-014-muted);caption-side:top;
}
[data-vibeui-block="datagrid-014"] th,
[data-vibeui-block="datagrid-014"] td{
width:var(--vibeui-datagrid-014-col);padding:0.5rem 0.75rem;text-align:left;
border-bottom:1px solid var(--vibeui-datagrid-014-border);
background:var(--vibeui-datagrid-014-bg);
overflow:hidden;text-overflow:ellipsis;white-space:nowrap;
}
[data-vibeui-block="datagrid-014"] thead th{
background:var(--vibeui-datagrid-014-head);font-weight:600;vertical-align:bottom;
position:sticky;top:0;z-index:2;
}
[data-vibeui-block="datagrid-014"] [data-align="end"]{text-align:right;font-variant-numeric:tabular-nums}
/* Закреплённая колонка обязана нести свой фон: иначе уезжающие ячейки видно насквозь. */
[data-vibeui-block="datagrid-014"] [data-pinned="true"]{
position:sticky;left:var(--vibeui-datagrid-014-offset,0);z-index:3;
background:var(--vibeui-datagrid-014-pinbg);
}
[data-vibeui-block="datagrid-014"] thead [data-pinned="true"]{z-index:4}
[data-vibeui-block="datagrid-014"] [data-edge="true"]{box-shadow:6px 0 10px -8px var(--vibeui-datagrid-014-shadow)}
[data-vibeui-block="datagrid-014"] [data-part="head-inner"]{display:flex;align-items:center;gap:0.375rem;justify-content:inherit}
[data-vibeui-block="datagrid-014"] [data-align="end"] [data-part="head-inner"]{justify-content:flex-end}
[data-vibeui-block="datagrid-014"] [data-part="pin"]{
appearance:none;cursor:pointer;font:inherit;line-height:1;flex:none;
width:1.375rem;height:1.375rem;border-radius:0.375rem;
border:1px solid transparent;background:transparent;color:var(--vibeui-datagrid-014-muted);
transition:color .15s ease,border-color .15s ease;
}
[data-vibeui-block="datagrid-014"] [data-part="pin"]:hover{color:var(--vibeui-datagrid-014-accent)}
[data-vibeui-block="datagrid-014"] [data-part="pin"][aria-pressed="true"]{
color:var(--vibeui-datagrid-014-accent);border-color:var(--vibeui-datagrid-014-accent);
}
[data-vibeui-block="datagrid-014"] [data-part="pin"]:disabled{opacity:.35;cursor:not-allowed}
[data-vibeui-block="datagrid-014"] [data-part="pin"]:focus-visible{outline:2px solid var(--vibeui-datagrid-014-accent);outline-offset:2px}
[data-vibeui-block="datagrid-014"] [data-part="clear"]{
appearance:none;cursor:pointer;font:inherit;font-size:0.75rem;
padding:0.3125rem 0.625rem;border-radius:0.5rem;
border:1px solid var(--vibeui-datagrid-014-border);
background:var(--vibeui-datagrid-014-bg);color:var(--vibeui-datagrid-014-fg);
}
[data-vibeui-block="datagrid-014"] [data-part="clear"]:disabled{opacity:.45;cursor:not-allowed}
[data-vibeui-block="datagrid-014"] [data-part="clear"]:focus-visible{outline:2px solid var(--vibeui-datagrid-014-accent);outline-offset:2px}
@media (prefers-reduced-motion:reduce){[data-vibeui-block="datagrid-014"] *{animation:none!important;transition:none!important}}
`
type ColumnKey =
"city" | "manager" | "plan" | "fact" | "deals" | "churn" | "nps"
const COLUMNS: { key: ColumnKey; label: string; numeric: boolean }[] = [
{ key: "city", label: "Город", numeric: false },
{ key: "manager", label: "Руководитель", numeric: false },
{ key: "plan", label: "План", numeric: true },
{ key: "fact", label: "Факт", numeric: true },
{ key: "deals", label: "Сделок", numeric: true },
{ key: "churn", label: "Отток, %", numeric: true },
{ key: "nps", label: "NPS", numeric: true },
]
const DEFAULT_ROWS: Datagrid014Row[] = [
{
id: "r1",
city: "Казань",
manager: "Юсупова",
plan: 4200,
fact: 4460,
deals: 118,
churn: 4.1,
nps: 62,
},
{
id: "r2",
city: "Новосибирск",
manager: "Ерёмин",
plan: 3900,
fact: 3510,
deals: 96,
churn: 6.8,
nps: 48,
},
{
id: "r3",
city: "Ростов-на-Дону",
manager: "Ковалёва",
plan: 3100,
fact: 3320,
deals: 87,
churn: 3.4,
nps: 71,
},
{
id: "r4",
city: "Екатеринбург",
manager: "Тагиров",
plan: 4600,
fact: 4180,
deals: 131,
churn: 5.2,
nps: 55,
},
{
id: "r5",
city: "Калининград",
manager: "Шмидт",
plan: 1800,
fact: 2040,
deals: 54,
churn: 2.9,
nps: 74,
},
]
function display(row: Datagrid014Row, key: ColumnKey) {
if (key === "city" || key === "manager") {
return row[key]
}
if (key === "churn") {
return row.churn.toLocaleString("ru-RU", { minimumFractionDigits: 1 })
}
return row[key].toLocaleString("ru-RU")
}
/**
* Сетка, где закрепить колонку решает читатель: булавка в заголовке
* переводит столбец в position:sticky. Один файл, ноль зависимостей.
*/
export function Datagrid014({
rows = DEFAULT_ROWS,
caption = "Нажмите булавку в заголовке, чтобы закрепить колонку слева",
maxPinned = 2,
accent,
className,
style,
...props
}: Datagrid014Props) {
const [pinned, setPinned] = useState<ColumnKey[]>(["city"])
// Порядок закрепления берётся из порядка колонок, а не из порядка кликов:
// иначе закреплённые столбцы менялись бы местами прямо под курсором.
const ordered = COLUMNS.filter((column) => pinned.includes(column.key)).map(
(column) => column.key,
)
const palette = {
...(accent ? { "--vibeui-datagrid-014-accent": accent } : null),
...style,
} as CSSProperties
function offsetFor(key: ColumnKey) {
const index = ordered.indexOf(key)
return index < 0
? undefined
: ({
"--vibeui-datagrid-014-offset": `calc(var(--vibeui-datagrid-014-col) * ${index})`,
} as CSSProperties)
}
return (
<>
<style href="vibeui-datagrid-014" precedence="medium">
{STYLES}
</style>
<section
{...props}
data-vibeui-block="datagrid-014"
className={className}
style={palette}
>
<div data-part="bar">
<h3 data-part="title">Продажи по филиалам</h3>
<p data-part="state" aria-live="polite">
{ordered.length === 0
? "Закреплённых колонок нет"
: `Закреплено: ${ordered.length} из ${maxPinned}`}
</p>
<button
type="button"
data-part="clear"
disabled={ordered.length === 0}
onClick={() => setPinned([])}
>
Снять закрепление
</button>
</div>
<div
data-part="scroll"
role="region"
aria-label="Таблица филиалов, прокручивается вбок"
tabIndex={0}
>
<table>
<caption>{caption}</caption>
<thead>
<tr>
{COLUMNS.map((column) => {
const isPinned = ordered.includes(column.key)
const isEdge =
isPinned && ordered[ordered.length - 1] === column.key
return (
<th
key={column.key}
scope="col"
data-align={column.numeric ? "end" : undefined}
data-pinned={isPinned ? "true" : undefined}
data-edge={isEdge ? "true" : undefined}
style={offsetFor(column.key)}
>
<span data-part="head-inner">
{column.label}
<button
type="button"
data-part="pin"
aria-pressed={isPinned}
aria-label={
isPinned
? `Открепить колонку «${column.label}»`
: `Закрепить колонку «${column.label}» слева`
}
disabled={!isPinned && ordered.length >= maxPinned}
onClick={() =>
setPinned((current) =>
current.includes(column.key)
? current.filter((key) => key !== column.key)
: [...current, column.key],
)
}
>
{isPinned ? "◆" : "◇"}
</button>
</span>
</th>
)
})}
</tr>
</thead>
<tbody>
{rows.map((row) => (
<tr key={row.id}>
{COLUMNS.map((column) => {
const isPinned = ordered.includes(column.key)
const isEdge =
isPinned && ordered[ordered.length - 1] === column.key
const content = display(row, column.key)
return column.key === "city" ? (
<th
key={column.key}
scope="row"
data-pinned={isPinned ? "true" : undefined}
data-edge={isEdge ? "true" : undefined}
style={offsetFor(column.key)}
>
{content}
</th>
) : (
<td
key={column.key}
data-align={column.numeric ? "end" : undefined}
data-pinned={isPinned ? "true" : undefined}
data-edge={isEdge ? "true" : undefined}
style={offsetFor(column.key)}
>
{content}
</td>
)
})}
</tr>
))}
</tbody>
</table>
</div>
</section>
</>
)
}