Tables

Aligned Numerals

Числовая таблица, где запятые стоят в одну вертикаль: каждая ячейка — сетка из знака, целой и дробной части, а минус висит слева и не сдвигает цифры.

  • table
  • numbers
  • alignment
  • finance

Превью

1440pxHost theme

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

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

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

Движение денег за месяц, тыс. ₽
СтатьяПланФактОтклонение
Подписки1 240,501 310,2569,75
Разовые продажи420,00388,4031,60
Партнёрские выплаты96,30128,7532,45
Возвраты18,007,5010,50
Прочее64,2064,200,00
Итого1 610,401 626,6016,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.json
https://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>
    </>
  )
}