Tables
Aligned Numerals
Числовая таблица, где запятые стоят в одну вертикаль: каждая ячейка — сетка из знака, целой и дробной части, а минус висит слева и не сдвигает цифры.
- table
- numbers
- alignment
- finance
Превью
Использовать с AI
- 1. Скопируйте ссылку.
- 2. Напишите агенту своими словами и вставьте её в предложение.
- 3. Агент откроет ссылку и поставит компонент из registry.
размести это в шапке: https://vibeui.ru/c/table-016
| Статья | План | Факт | Отклонение |
|---|---|---|---|
| Подписки | 1 240,50 | 1 310,25 | 69,75 |
| Разовые продажи | 420,00 | 388,40 | −31,60 |
| Партнёрские выплаты | −96,30 | −128,75 | −32,45 |
| Возвраты | −18,00 | −7,50 | 10,50 |
| Прочее | 64,20 | 64,20 | 0,00 |
| Итого | 1 610,40 | 1 626,60 | 16,20 |
Показать полную инструкцию
То, что лежит по ссылке в развёрнутом виде. Нужна, если агент не может открыть ссылку — тогда вставьте этот текст целиком.
# Установка и размещение «table-016» (Aligned Numerals) из VibeUI
## 1. Сначала установка — не пропускай, не пересоздавай
Выполни эту команду до того, как писать код:
npx shadcn@latest add https://vibeui.ru/r/table-016.json
Registry item: https://vibeui.ru/r/table-016.json
Ставится в: components/vibeui/table-016.tsx (точный путь следует алиасам components.json этого проекта).
npm-зависимости: нет.
Registry-зависимости: нет.
Ставь из реестра. Не пересоздавай по описанию, не подменяй похожим
компонентом из другой библиотеки и не переписывай под стиль проекта.
## 2. Что это
Числовая таблица, где запятые стоят в одну вертикаль: каждая ячейка — сетка из знака, целой и дробной части, а минус висит слева и не сдвигает цифры.
Таблица чисел с выравниванием по разряду, висящим минусом и итоговой строкой. Ноль зависимостей, один файл, клиентского JS нет.
## 3. Как использовать
import { Table016 } from "@/components/vibeui/table-016"
<Table016
caption="Движение денег за месяц, тыс. ₽"
decimals={2}
/>
Полный список пропсов — в установленном файле.
## 4. Куда поставить
Это мелкий inline-компонент. Поставь его ровно туда, куда просил
пользователь, внутрь существующей разметки. Не создавай ради него
новую страницу, секцию или обёртку. Если на этом месте уже стоит похожий
контрол — замени его, а не добавляй второй.
Куда поставить: ___
(Эту строку заполняет пользователь. Если она осталась пустой — спроси,
а не угадывай.)
## 5. Сохранить как установлено
- локальную палитру --vibeui-table-016-* и не подменять её токенами вашей темы
- разбиение числа на три ячейки grid: без него запятые расходятся и колонку невозможно сравнивать взглядом
- знак «−» вместо дефиса: дефис уже и в озвучке читается как перенос
- font-variant-numeric:tabular-nums: пропорциональные цифры ломают любое выравнивание по разряду
- то, что отрицательность несёт знак, а не цвет: при дальтонизме красный столбец неотличим
- собственную светлую подложку: на тёмной карточке каталога тёмный текст пропадает
## 6. Можно менять
- названия колонок через columns
- статьи и числа через rows
- число знаков после запятой через decimals
- подпись таблицы через caption
## 7. Правила
- Числа хранятся как number и форматируются при рендере: строку компонент выровнять не сможет.
- Ширина колонки знака задана в ch — при смене шрифта её стоит перепроверить.
- Итог считается по колонке простым сложением: взвешенные средние сюда не подставить.
- Не выносите CSS-переменные в globals.css: компонент обязан остаться одним файлом.
## 8. Проверка
- рендерится без ошибок в консоли;
- выглядит так же, как превью на странице VibeUI, откуда взята ссылка;
- если нет — ты изменил что-то из раздела 5, верни как было.Для разработчика
npx shadcn@latest add https://vibeui.ru/r/table-016.jsonhttps://vibeui.ru/r/table-016.jsonКомпонент самодостаточен: один файл, без зависимостей, палитра в переменных --vibeui-table-016-*. Серверный: суммы считаются при рендере, состояния нет. Число разбивается функцией split() на знак, целую и дробную часть, а разметка кладёт их в grid из трёх колонок 0.75ch / 1fr / auto — границы колонок общие для всех строк, поэтому запятые выстраиваются, а висящий минус не сдвигает разряды. Минус — типографский знак «−» (U+2212), а не дефис: он и шире, и читается как минус. Отрицательное значение подкрашено, но смысл несёт сам знак, а не цвет. Разряды разделены узким неразрывным пробелом, шрифт — tabular-nums.
Исходник компонента
Тот же файл, который поставит агент. Нужен, если вы предпочитаете скопировать код руками.
import type { ComponentPropsWithoutRef, CSSProperties } from "react"
export type Table016Row = {
title: string
values: number[]
}
export type Table016Props = Omit<
ComponentPropsWithoutRef<"div">,
"children"
> & {
columns?: string[]
rows?: Table016Row[]
/** Сколько знаков после запятой печатать во всех ячейках. */
decimals?: number
caption?: string
accent?: string
}
// Идея компонента: числа выстроены по разряду. Каждая ячейка — маленькая
// сетка из трёх колонок: знак, целая часть, дробная. Целые части упираются
// в одну границу, запятые стоят в одну линию, а минус висит слева и не
// сдвигает цифры. Минус — знак «−», а не дефис, и он читается вслух:
// цветом отрицательное значение не размечают.
const STYLES = `
:where([data-vibeui-block="table-016"]){
--vibeui-table-016-bg:oklch(1 0 0);
--vibeui-table-016-fg:oklch(0.24 0.014 265);
--vibeui-table-016-muted:oklch(0.56 0.014 265);
--vibeui-table-016-border:oklch(0.92 0.006 265);
--vibeui-table-016-head:oklch(0.975 0.003 265);
--vibeui-table-016-accent:oklch(0.55 0.2 262);
--vibeui-table-016-minus:oklch(0.53 0.19 27);
--vibeui-table-016-font:ui-sans-serif,system-ui,-apple-system,"Segoe UI",Roboto,"Helvetica Neue",Arial,sans-serif;
}
[data-vibeui-block="table-016"]{
width:100%;box-sizing:border-box;
font-family:var(--vibeui-table-016-font);color:var(--vibeui-table-016-fg);
}
[data-vibeui-block="table-016"] [data-part="shell"]{
background:var(--vibeui-table-016-bg);
border:1px solid var(--vibeui-table-016-border);border-radius:1rem;overflow:hidden;
}
[data-vibeui-block="table-016"] [data-part="scroll"]{overflow-x:auto}
[data-vibeui-block="table-016"] [data-part="scroll"]:focus-visible{
outline:2px solid var(--vibeui-table-016-accent);outline-offset:-2px;
}
[data-vibeui-block="table-016"] table{width:100%;border-collapse:collapse;font-size:0.8125rem;min-width:26rem}
[data-vibeui-block="table-016"] caption{
padding:0.875rem 1rem 0.5rem;text-align:left;font-size:0.9375rem;font-weight:650;
}
[data-vibeui-block="table-016"] th,
[data-vibeui-block="table-016"] td{
padding:0.4375rem 0.875rem;text-align:left;
border-top:1px solid var(--vibeui-table-016-border);
}
[data-vibeui-block="table-016"] thead th{
background:var(--vibeui-table-016-head);font-weight:600;white-space:nowrap;text-align:right;
}
[data-vibeui-block="table-016"] thead th:first-child{text-align:left}
[data-vibeui-block="table-016"] tbody th,
[data-vibeui-block="table-016"] tfoot th{font-weight:500;white-space:nowrap}
[data-vibeui-block="table-016"] tfoot th,
[data-vibeui-block="table-016"] tfoot td{font-weight:700;background:var(--vibeui-table-016-head)}
/* Ячейка числа: знак | целая часть | дробная. Границы колонок общие для
всех строк, поэтому запятые встают в одну вертикаль. */
[data-vibeui-block="table-016"] [data-part="num"]{
display:grid;grid-template-columns:0.75ch 1fr auto;align-items:baseline;
font-variant-numeric:tabular-nums;
}
[data-vibeui-block="table-016"] [data-part="sign"]{text-align:left}
[data-vibeui-block="table-016"] [data-part="whole"]{text-align:right}
[data-vibeui-block="table-016"] [data-part="fraction"]{text-align:left}
[data-vibeui-block="table-016"] [data-sign="neg"]{color:var(--vibeui-table-016-minus)}
@media (prefers-reduced-motion:reduce){[data-vibeui-block="table-016"] *{animation:none!important;transition:none!important}}
`
const DEFAULT_COLUMNS = ["План", "Факт", "Отклонение"]
const DEFAULT_ROWS: Table016Row[] = [
{ title: "Подписки", values: [1240.5, 1310.25, 69.75] },
{ title: "Разовые продажи", values: [420, 388.4, -31.6] },
{ title: "Партнёрские выплаты", values: [-96.3, -128.75, -32.45] },
{ title: "Возвраты", values: [-18, -7.5, 10.5] },
{ title: "Прочее", values: [64.2, 64.2, 0] },
]
const MINUS = "−"
/** Разбиваем число на знак, целую и дробную часть: их печатает разметка. */
function split(value: number, decimals: number) {
const fixed = Math.abs(value).toFixed(decimals)
const [whole, fraction = ""] = fixed.split(".")
return {
sign: value < 0 ? MINUS : "",
whole: whole.replace(/\B(?=(\d{3})+(?!\d))/g, " "),
fraction: fraction ? `,${fraction}` : "",
}
}
/**
* Числовая таблица с выравниванием по разряду и висящим минусом.
* Один файл, ноль зависимостей, собственная палитра.
*/
export function Table016({
columns = DEFAULT_COLUMNS,
rows = DEFAULT_ROWS,
decimals = 2,
caption = "Движение денег за месяц, тыс. ₽",
accent,
className,
style,
...props
}: Table016Props) {
const palette = {
...(accent ? { "--vibeui-table-016-accent": accent } : null),
...style,
} as CSSProperties
const totals = columns.map((_, index) =>
rows.reduce((sum, row) => sum + (row.values[index] ?? 0), 0),
)
const renderNumber = (value: number) => {
const parts = split(value, decimals)
return (
<span data-part="num" data-sign={value < 0 ? "neg" : undefined}>
<span data-part="sign">{parts.sign}</span>
<span data-part="whole">{parts.whole}</span>
<span data-part="fraction">{parts.fraction}</span>
</span>
)
}
return (
<>
<style href="vibeui-table-016" precedence="medium">
{STYLES}
</style>
<div
{...props}
data-vibeui-block="table-016"
className={className}
style={palette}
>
<div data-part="shell">
<div
data-part="scroll"
role="region"
aria-label={caption}
tabIndex={0}
>
<table>
<caption>{caption}</caption>
<thead>
<tr>
<th scope="col">Статья</th>
{columns.map((column) => (
<th key={column} scope="col">
{column}
</th>
))}
</tr>
</thead>
<tbody>
{rows.map((row) => (
<tr key={row.title}>
<th scope="row">{row.title}</th>
{columns.map((column, index) => (
<td key={column}>
{renderNumber(row.values[index] ?? 0)}
</td>
))}
</tr>
))}
</tbody>
<tfoot>
<tr>
<th scope="row">Итого</th>
{totals.map((total, index) => (
<td key={columns[index]}>{renderNumber(total)}</td>
))}
</tr>
</tfoot>
</table>
</div>
</div>
</div>
</>
)
}