Playground로 바로 이동
Components

Chart

값의 흐름은 꺾은선, 항목끼리의 크기는 세로 막대로 보이는 그래프입니다. 계열마다 이름과 색을 config로 정하고, 포인터를 얹은 칸의 값을 툴팁이 한 번에 보입니다.

명세 문서 보기

🚩 Playground

그래프 종류와 툴팁·범례·계열 색, x 축 라벨 간격을 조합하여 실제 동작에서 확인합니다. 포인터를 얹거나 그래프에 focus 를 두고 화살표 키를 누르면 툴팁이 섭니다. Bar 에서 Emphasis 를 누르면 고른 칸에 테두리가 섭니다.

Appearance

Type
Emphasis
Tooltip variant

Content

Series
Color
Missing value

Elements

Legend
Legend position

Behavior

Connect nulls

Anatomy

그래프는 그릇 안에서 격자와 두 축 위에 계열을 그립니다. 범례와 툴팁은 고를 수 있는 요소입니다.

  1. 1.Chart container (div)
  2. 2.Grid
  3. 3.X axis
  4. 4.Y axis
  5. 5.Series — Line · Bar
  1. 6.Legend(Optional)
  2. 7.Legend item (button)(Optional)
  3. 8.Tooltip(Optional)
  4. 9.Tooltip label(Optional)
  5. 10.Tooltip item(Optional)

Structure map

Chart container (div)
├─ Chart style (style) — 계열 색 변수
└─ Surface (svg)
   ├─ Grid
   ├─ X axis
   ├─ Y axis
   ├─ Series — Line · Bar
   ├─ Cursor (Optional)
   ├─ Legend (div) (Optional)
   │  └─ Legend item (Optional)
   └─ Tooltip (div) (Optional)
      ├─ Tooltip label (Optional)
      └─ Tooltip item (Optional)

명세 문서

docs/system/components/chart.md

Chart

packages/ui/src/chart.tsx

값의 흐름을 꺾은선으로, 항목끼리의 크기를 세로 막대로 보이고, 계열마다 이름과 색을 정하는 config와 축·격자·툴팁·범례의 표현을 소유한다.

역할과 경계

  • Chart는 숫자 계열을 그림으로 보인다. 꼴은 둘이다. 꺾은선(LineChart)은 이어지는 축 위에서 값이 어떻게 흘러가는지(달마다 매출, 요일마다 유동인구), 세로 막대(BarChart)는 이름 붙은 항목끼리 크기가 어떻게 다른지(연령대별 비중, 시설 종류별 개수)를 보인다.
  • shadcn/ui의 chart에서 시작했다. 그리는 일은 Recharts 3이 하고, Chart는 계열마다 이름과 색을 적는 ChartConfig와 그것을 읽는 그릇·툴팁·범례를 갖는다. ChartContainer 안에 Recharts의 그래프를 직접 짜 넣을 수 있고(shadcn과 같은 방식), 자주 쓰는 두 꼴은 프리셋 LineChart·BarChart가 한 줄로 낸다.
  • 두 프리셋은 billboard.js로 그리던 원본 그래프의 모양을 그대로 낸다. 상권 리포트가 원본(fc-system zone-map)의 그래프 열세 개를 옮겨 오는 자리에서 쓰기 위해 만들었고, 점·막대 폭·축 눈금·여백·격자·툴팁 꼴을 원본 코드의 값으로 맞췄다. 맞춘 것과 못 맞춘 것은 아래 「billboard에서 옮긴 모양」이 갖는다.
  • 값 하나하나를 읽어야 하는 자리는 Chart가 아니다. 줄과 칸으로 값을 견주는 자리는 table.md가 담당한다. 그래프는 흐름과 차이를 한눈에 보이는 대신 정확한 값은 툴팁을 열어야 읽힌다.
  • 숫자 하나를 크게 보이는 지표 카드, 원·도넛, 가로 막대, 쌓은 막대, 두 y 축은 Chart가 다루지 않는다(아래 「현재 정의하지 않은 항목」).
  • Chart는 자료를 가공하지 않는다. 단위 환산·반올림·계열을 고르는 일은 쓰는 화면이 한다. 프리셋이 손대는 것은 둘뿐이다 — 값이 하나도 없는 계열을 그리지 않는 것, 막대의 빈 칸을 0으로 그리는 것.

Anatomy

  1. Chart container
  2. Grid
  3. X axis
  4. Y axis
  5. Series — 꺾은선의 선 또는 막대

Extended anatomy는 선택 요소를 표시한다.

  1. Legend (Optional)
  2. Legend item (Optional) — 프리셋 안에서는 누를 수 있는 단추다
  3. Tooltip (Optional) — 포인터를 얹거나 그래프에 focus를 두고 화살표 키를 누를 때 선다
  4. Tooltip label (Optional)
  5. Tooltip item (Optional)

이름은 shadcn과 Recharts를 따른다. HTML로 그리는 요소만 data-slot을 갖고, 축·격자·계열은 Recharts가 SVG로 그리며 자기 class(recharts-xAxis 등)를 갖는다.

이름 요소 data-slot
ChartContainer · LineChart · BarChart <div> chart (프리셋은 data-chart-type에 line·bar를 함께 남긴다)
ChartStyle <style> 없음 — 계열 색 변수를 쓴다
ChartLegendContent <div> chart-legend
범례 한 칸 <div>, 프리셋 안에서는 <button> chart-legend-item
ChartTooltipContent <div> chart-tooltip (data-variant에 card·table)
툴팁 제목 <div> chart-tooltip-label
툴팁 한 줄 <div> chart-tooltip-item

ChartTooltip과 ChartLegend는 Recharts의 Tooltip·Legend를 그대로 내보낸 이름이다. 무엇을 그릴지는 content로 받은 ChartTooltipContent·ChartLegendContent가 정한다.

Properties

LineChart · BarChart

  • data: 한 줄이 x 축의 한 칸인 배열. 계열 값은 config의 key로 읽는다
  • config: 계열마다 이름과 색(ChartConfig). key의 순서가 그리는 순서이고 범례 순서다
  • xKey: x 축 값이 든 key
  • unit: y 축 눈금과 툴팁 값 뒤에 붙는 단위. 주지 않으면 붙이지 않는다
  • height: 그래프 높이(px), 기본값 320. 범례를 포함한 높이다
  • legend: false | true, 기본값 true
  • legendPosition: top | bottom, 기본값 bottom
  • tickRotateThreshold: x 축 값이 이보다 많으면 라벨을 -45° 기울인다. 기본값 20. 라벨 길이가 아니라 칸의 개수를 본다
  • tooltipTitleKey: 툴팁 제목이 든 key. 주지 않으면 x 축 값이 제목이다
  • tooltipVariant: card | table, 기본값 table
  • valueFormatter: 툴팁 값 글자를 만드는 함수 (value, key) => ReactNode. 주지 않으면 천 단위 쉼표와 unit을 붙인다
  • yTicks: y 축 눈금을 직접 정한다. 주지 않으면 원본과 같은 계산으로 정한다(아래 Specification)
  • title: 화면 읽기 도구가 읽는 그래프 이름. SVG의 <title>이 된다

LineChart

  • tickEvery: x 축 라벨을 몇 칸마다 하나씩 둘지. 기본값 1. 끝에서부터 센다 — 가장 최근 칸의 라벨이 늘 남는다
  • connectNulls: false | true, 기본값 false. 거짓이면 값이 없는 칸(null)에서 선이 끊긴다

BarChart

  • tooltipLabel: 계열이 하나일 때 툴팁 줄 이름. 계열이 둘 이상이면 계열 이름을 쓴다
  • emphasis: none | max | min, 기본값 none. 세울 칸을 규칙으로 고른다. 아래 「한 칸을 세우기」
  • emphasizedCell: 세울 칸을 직접 고르는 함수 (row, index) => boolean. 주면 emphasis보다 앞선다

ChartContainer

  • config: 계열마다 이름과 색
  • initialDimension: 크기를 재기 전에 그릴 크기, 기본값 { width: 320, height: 200 }
  • 크기는 그릇이 정한다. 기본은 16:9(aspect-video)이고, 높이를 정할 자리는 className으로 aspect-auto와 높이를 준다

ChartTooltipContent

  • ChartTooltipContent.variant: card | table, 기본값 card. card는 shadcn의 둥근 상자, table은 진한 머리줄 아래 계열마다 한 줄이 서는 표다
  • order: series | asc | desc, 기본값 series. 툴팁 줄의 순서다. series는 그래프에 그린 순서, asc·desc는 값의 크기 순이다
  • indicator: line | dot | dashed, 기본값 dot. card에서 계열 표지의 꼴이다. table의 표지는 늘 10px 정사각형이다
  • hideLabel: false | true, 기본값 false
  • hideIndicator: false | true, 기본값 false
  • valueFormatter: 값 글자를 만드는 함수. 단위를 붙이는 자리다
  • labelFormatter·formatter·labelKey·nameKey·labelClassName은 shadcn과 같다. 값이 없는 줄(null)은 그리지 않는다

ChartLegendContent

  • hideIcon: false | true, 기본값 false
  • nameKey: config에서 이름을 찾을 key
  • 프리셋 안의 범례는 단추다. 누르면 그 계열을 감추고(aria-pressed가 거짓이 된다) 다시 누르면 보인다. 포인터나 focus를 얹으면 나머지 계열이 물러난다. ChartContainer에 직접 짠 그래프의 범례는 단추가 아니다 — 감추는 일을 그래프가 받아 주지 않기 때문이다

ChartConfig

type ChartConfig = Record<string, {
  label?: ReactNode
  icon?: ComponentType
} & ({ color?: string } | { theme: { light: string; dark: string } })>
  • key는 CSS 변수 이름(--color-<key>)이 된다. 영문 식별자로 쓴다. 그래프 안에서는 var(--color-<key>)로 색을 읽는다
  • color에는 토큰 변수(var(--color-oe-…))와 hex를 모두 줄 수 있다. 테마마다 다른 색은 theme에 둘 다 준다
  • 색을 주지 않은 계열은 CHART_DEFAULT_COLORS를 config 순서대로 받는다(아래 「계열 색 정하기」)

Guidelines

꺾은선과 막대 고르기

  • x 축이 이어지는 값이면 꺾은선이다. 달·요일·시각처럼 칸 사이에 순서와 간격이 있어 선이 칸을 이어도 뜻이 서는 자리다.
  • x 축이 이름 붙은 항목이면 세로 막대다. 연령대·성별·시설 종류처럼 칸끼리 이어지지 않는 자리에서 선을 그으면 없는 흐름을 그리게 된다.
  • 막대는 길이로 값을 읽히므로 바닥이 0이 아니면 차이가 부풀어 보인다. 프리셋은 원본의 계산을 따라 가장 작은 값이 0보다 크면 바닥을 그 아래 단위로 올린다. 차이를 부풀리지 않아야 하는 자리는 yTicks로 0부터 준다.

계열 색 정하기

  • 색을 주지 않으면 oe 토큰을 순서대로 쓴다. 첫째는 oe-brand-background-bold-primary, 둘째는 견줄 대상을 말하는 중립 oe-foreground-tertiary다. 「선택한 곳 대 구 전체」처럼 둘째 계열이 기준선 노릇을 하는 그래프가 많다.
  • 셋째 계열부터는 범주 색을 차례로 받는다. oe-categorical-1 … oe-categorical-9이며 기본 색은 모두 열하나다. 상태 색(warning·danger·success·info)과 증감 색(up·down)은 뜻이 묶여 있어 「셋째 계열」로 빌려 쓰지 않는다 — 셋째 계열은 위험도 상승도 아니다. 범주 색은 뜻이 없고 차례만 있는 유일한 역할이며, 쓸 토큰이 없어 상태 색을 빌리거나 hex를 박던 자리를 이것이 닫는다(tokens.md의 「범주 색 token」).
  • 계열이 열하나를 넘으면 색을 더 두지 않는다. 그래프를 나누거나 색 말고 다른 축(모양·무늬·라벨)으로 가른다. 범주 색이 아홉에서 멈춘 까닭이 그것이다 — 열째를 더하면 가장 가까운 쌍이 변별 문턱에 닿아 8px 범례 점에서 갈리지 않는다(foundations/color.md의 범주 색). 색 없이 열두째 계열을 두면 개발 중에 console.error로 알리고 중립 회색을 쓴다.
  • 값이 오른 것과 내린 것을 색으로 말하는 자리는 증감 토큰을 쓴다. oe-up-*과 oe-down-*이며, 국내 관례를 따라 상승이 붉은 계열·하락이 파란 계열이다(서양과 뒤집혀 있다). 상태 색을 여기에 빌려 쓰지 않는다 — 매출이 는 것은 success가 아니고 준 것은 danger가 아니다. 지표 카드의 증감률 글자가 그 자리이며(foundations/color.md의 up·down), 계열 색으로는 쓰지 않는다. 한 계열이 어떤 칸에서는 오르고 어떤 칸에서는 내리므로 선 하나에 방향 색을 줄 수 없다. 오르내림을 막대마다 색으로 가르는 그래프는 아직 정의하지 않았다(아래 「현재 정의하지 않은 항목」).
  • 색은 계열을 따라가고 순서를 따라가지 않는다. 기본 색은 config의 자리로 정해지므로, 값이 없는 계열이 빠지거나 범례로 계열을 감춰도 남은 계열의 색이 밀리지 않는다.
  • hex는 원본 화면을 옮기는 자리에서 쓴다. hex는 테마를 따르지 않으므로 Dark에서도 보여야 하는 색은 theme에 두 값을 준다.
  • 글자는 계열 색으로 칠하지 않는다. 범례 글자와 툴팁 값은 글자색 토큰을 쓰고, 계열은 옆의 10px 칸이 가리킨다.

한 칸을 세우기

  • 세운 칸은 색을 바꾸지 않고 테두리를 두른다. 색을 바꾸지 않는 까닭은 둘이다. 하나, 이 저장소에서 빨강은 danger이고 가장 높은 값은 위험하지 않다 — 위 「계열 색 정하기」가 적는 「상태 색은 빌려 쓰지 않는다」가 여기에도 그대로 적용된다. 둘, 계열이 파란 그래프에 빨간 막대가 하나 서면 그 빨강이 무슨 뜻인지 읽는 사람이 되묻게 된다.
  • 나머지를 가라앉히지 않는 까닭은 재어서 안 것이다(2026-10-07 실측). 나머지를 옅게 하면 그 막대의 값이 길이로 읽히지 않는다. oe-categorical-2는 Light에서 바탕과의 대비가 제 색으로도 3.60:1뿐이어서 불투명도를 90%로만 내려도 2.86:1로 필수 UI 기준 3:1 아래로 떨어지고, 그 90%는 세운 칸과 Dark에서 ΔEok 0.0182로 변별 문턱 아래여서 강조로 보이지도 않는다. 두 조건을 함께 넘기는 불투명도가 없다.
  • 테두리는 oe-border-bold-primary 3px이고 선의 바깥 절반이 바탕 위에 선다. 그래서 계열 색이 무엇이든 보인다(바탕과 Light 19.79:1, Dark 17.16:1). 같은 중립을 막대 안쪽에만 그리면 안 된다 — 짙은 계열 색 위에서 1.19:1까지 떨어진다(Dark oe-categorical-2).
  • 계열이 여럿이면 한 칸의 합으로 잰다. 강조는 칸의 일이지 계열의 일이 아니므로 「어느 칸이 가장 큰가」를 답해야 한다. 계열마다 따로 세우면 세운 칸이 여럿 생겨 무엇을 보라는 것인지 흐려진다. 계열이 하나면 합이 곧 그 값이다.
  • 지금 보이는 계열만 센다. 범례로 계열을 감추면 세운 칸도 따라 옮긴다. 안 그러면 화면에서 가장 높지 않은 막대에 테두리가 남는다.
  • 같은 값이 여럿이면 모두 세운다. 임의로 하나를 고르지 않는다.
  • 범례와 툴팁은 바뀌지 않는다. 강조는 칸의 일이고 범례와 툴팁은 계열을 말한다.
  • 칸을 세우는 그래프는 title을 갖는다. 테두리는 색이 아닌 채널이라 색약에서도 보이지만 낭독기에는 보이지 않으므로, 세운 칸을 그래프 이름에 적어 알린다 — title이 월 매출이면 월 매출 — 가장 높은 칸은 2월이 된다. title이 없으면 적을 자리가 없다.

값이 없는 칸 다루기

  • 꺾은선에서 값이 없는 칸은 null로 둔다. 선이 그 칸에서 끊겨 「값이 없다」가 보인다. 0으로 채우면 값이 0으로 떨어진 것으로 읽힌다.
  • 값이 하나도 없는 계열은 그리지 않는다. 범례에도 툴팁에도 서지 않는다. 옛 자료에 없는 계열이 빈 이름으로 범례에 남지 않게 하려는 것이다.
  • 막대에서 값이 없는 칸은 0으로 그린다(원본과 같다). 툴팁도 0을 말한다. 「값이 없음」과 「0」을 갈라야 하는 막대 그래프는 아직 정의하지 않았다.

x 축 라벨 줄이기

  • 칸이 많아 라벨이 붙으면 tickEvery로 라벨을 줄인다. 열세 달이면 2가 원본의 값이다.
  • 끝에서부터 센다. 가장 최근 칸의 라벨이 늘 남으므로 「마지막 달이 언제인가」가 라벨에서 바로 읽힌다.
  • 라벨이 길어 겹치는 막대 그래프는 tickRotateThreshold를 낮춰 기울인다. 라벨 길이가 아니라 칸의 개수를 보므로 짧은 목록에 긴 라벨이 서는 자리(시설 종류 일곱)는 값을 낮게 준다.

그래프에 이름 붙이기

  • 그래프는 이름을 갖는다. 프리셋은 title을 SVG의 <title>로 둔다. 화면에 보이는 제목이 있으면 같은 글을 그대로 준다.
  • 그래프는 포인터만으로 읽히지 않는다. focus를 두고 좌우 화살표 키로 칸을 옮기면 툴팁이 따라온다(Recharts의 accessibilityLayer). 그때 그래프 둘레에 oe-focus-ring 테두리가 선다.
  • 색만으로 계열을 가르지 않는다. 계열이 둘 이상이면 범례를 둔다 — 범례의 이름이 계열을 가르고, 툴팁도 줄마다 이름을 적는다.

원본 그래프 옮기기

원본 @repo/ui의 LineChart·BarChart(billboard.js)는 칸 이름 배열과 계열 배열(["이름", 값, …])을 받았다. 프리셋은 한 줄이 한 칸인 배열을 받으므로 한 번 옮겨 담는다.

import { BarChart, LineChart, type ChartConfig } from "@ooee/ui"

// 원본: categoriesKeys + columns([name, ...values][]) → 한 줄이 한 칸인 배열
function rowsFromColumns(categories: string[], columns: (string | number | null)[][], keys: string[]) {
  return categories.map((category, index) => ({
    category,
    ...Object.fromEntries(columns.map((column, i) => [keys[i], column[index + 1] ?? null])),
  }))
}

// 「월평균 매출 추이」 — 원본: colors={{ 선택영역: "#14A5FF" }} unitTitle="만원" xAxisRotateCount={10}
// tooltipTitleKeys={…YYYY.MM} 와 CSS 로 2개월 간격
const salesConfig = {
  selected: { label: "선택영역", color: "#14A5FF" },
  gu: { label: guLabel, color: "#8B5CF6" },
} satisfies ChartConfig

<LineChart
  data={rows /* { month: "25.04", fullMonth: "2025.04", selected: 10192, gu: null } … */}
  config={salesConfig}
  xKey="month"
  tooltipTitleKey="fullMonth"
  unit="만원"
  tickEvery={2}
  tickRotateThreshold={10}
  title="월평균 매출 추이"
/>

// 「연령별 매출 비중」 — 원본: tooltipTitle="매출 비중" unitTitle="%" legendShow={false}
<BarChart
  data={ageRows /* { band: "20대", ratio: 18.4 } … */}
  config={{ ratio: { label: "매출 비중", color: "#60A5FA" } }}
  xKey="band"
  unit="%"
  tooltipLabel="매출 비중"
  legend={false}
  tickRotateThreshold={10}
  title="연령별 매출 비중"
/>
  • 원본에서 값이 없는 계열을 빼던 일(hasValue)은 프리셋이 한다. 계열을 빼지 않고 그대로 넘긴다.
  • 원본이 CSS로 덮던 것(라벨 2개월 간격, 점을 평소 감추기, 범례 위치)은 프리셋의 기본값이거나 Property다. Recharts는 billboard의 class(.bb-*)를 쓰지 않으므로 원본의 덮는 CSS는 옮기지 않는다.
  • 원본의 문서 모드 높이 200은 height={200}이다.

billboard에서 옮긴 모양

원본은 fc-system의 @repo/ui LineChart·BarChart(billboard.js 3.18)와 그것을 쓰는 zone-map 리포트(ReportPanel의 덮는 CSS, detailReportCharts)다. 값은 그 코드에서 읽었다.

맞춘 것

자리 원본 프리셋
선 2px, 곧은 선(line) 2px, type="linear"
점 흰 속·계열 색 2px 테두리 r4, 평소 투명이고 포인터를 얹은 칸만 보임. 포커스 때 1.75배 평소 없음. 얹은 칸에 r7·테두리 3.5px(1.75배 값), 속은 oe-background-primary
값이 없는 칸 꺾은선은 끊김, 막대는 0 같음
값이 없는 계열 화면이 빼고 넘김 프리셋이 뺌
계열 색 config로 계열마다 hex config.color에 hex 또는 토큰
막대 폭 칸 폭의 0.5, 최대 64px, 묶음 안 간격 0 barCategoryGap="25%", maxBarSize={64}, barGap={0}
막대 호버 얹은 칸의 막대가 fill-opacity: 0.75 activeBar의 fillOpacity: 0.75
격자 꺾은선 가로만, 막대 가로·세로. 점선 3 3 같음
y 축 눈금 꺾은선 1·2·5·10 배수 다섯 칸(위로 10% 여유), 막대 1·2·10·50 단위 다섯 칸 같은 계산(시험이 원본 값과 견준다)
y 축 여백 꺾은선 위 20 · 아래 20(0에서 시작)/10, 막대 위 40 · 아래 0 같음
y 축 글자 반올림한 정수 + 쉼표 + 단위 같음
x 축 모든 칸에 라벨, 칸 수가 기준을 넘으면 -45°(기본 20) interval={0}, tickRotateThreshold(기본 20)
x 라벨 간격 CSS로 끝에서부터 2칸마다 tickEvery, 끝에서부터
툴팁 내용 칸의 모든 계열을 한 상자에. 제목은 tooltipTitleKeys 또는 칸 이름, 값은 쉼표 + 단위, 값이 없는 줄은 뺌 같음(tooltipTitleKey·unit)
툴팁 순서 꺾은선은 값이 작은 계열부터, 막대는 계열 순서 order="asc" · order="series"
툴팁 줄 이름(막대) 계열 하나면 tooltipTitle, 둘 이상이면 계열 이름 tooltipLabel
툴팁 꼴 진한 머리줄 아래 계열마다 한 줄, 색 칸·이름·점선 왼쪽 경계의 오른쪽 맞춤 값 tooltipVariant="table"
툴팁 자리 얹은 칸의 가운데에서 오른쪽으로 20px, 포인터 높이에서 위로 5px, 넘치면 왼쪽 offset={{ x: 20, y: -5 }}, 넘치면 왼쪽
호버 커서 얹은 칸을 지나는 세로선(막대는 점선) 같음
범례 아래 가운데, 10px 정사각형 칸 + 이름. 얹으면 나머지 계열 30%, 누르면 감추기(칸 15%) 같음
처음 그릴 때 움직임 없음 isAnimationActive={false}
그래프 글자 14px · 500 프리셋 text-sm font-medium
높이 320(문서 모드 200), 범례 포함 height 기본 320
폭 부모 폭에 맞춰 다시 그림 ResponsiveContainer

못 맞춘 것

자리 원본 프리셋 까닭
색 값 축 선·글자 검정, 격자 #aaa(꺾은선)·#CBCFD5(막대), 툴팁 머리줄 #333 같은 역할의 oe 토큰 — 축 oe-border-bold-primary·oe-foreground-primary, 격자 oe-border-overlay-subtle, 머리줄 oe-background-bold-primary 정식 자산은 직접 색을 쓰지 않는다. 격자는 두 원본 색이 한 토큰으로 모이고, 고정 단계가 아니라 alpha라 어느 바탕에서나 같은 무게로 선다
기본 계열 색 열일곱 hex(#60A5FA·#8B5CF6·#14B8A6…) 토큰 열하나(brand·중립·범주 색 아홉) 원본의 열일곱을 그대로 옮기지 않았다. 색이 늘수록 서로 갈리기 어려워지므로 색약까지 재어 넘기는 수에서 멈췄다. 원본 화면을 옮기는 자리는 config.color에 hex를 준다
점이 나타나는 움직임 0.15초에 걸쳐 나타남 곧바로 나타남 Recharts가 얹을 때 점을 새로 붙여 CSS 전이가 걸리지 않는다
툴팁이 아래로 넘칠 때 툴팁 높이 + 30px 위로 포인터 위로 붙음 Recharts의 자리 계산을 따른다
툴팁 상자 각진 표, 불투명도 0.9, 오른쪽 아래 그림자 각진 표, 불투명, shadow-lg 그림자는 저장소의 팝업 그림자를 쓴다
y 축 폭 눈금 글자에 맞춰 잼 눈금 글자에 맞춰 잼(width="auto"), 몇 px 다를 수 있음 글자 재는 법이 다르다
범례 자리 축 아래로 떨어진 것을 CSS로 28px 끌어올림 축 글자 바로 아래 12px 자리를 끌어올릴 필요가 없게 처음부터 붙여 둔다
축 눈금 계산의 끝자리 막대 눈금이 반올림으로 겹치면 같은 자리에 두 번 하나만 같은 글자가 겹쳐 그려질 뿐이라 보이는 것은 같다
키보드 없음 좌우 화살표로 칸을 옮기며 툴팁, focus 테두리 quality.md의 keyboard navigation을 따른 보탬이다
원본에만 있는 옵션 두 y 축(y2Keys), 금액 서식(isPrice — 만·억), 비율 줄(ratioColumns), 막대 위 값 글자, 가로 막대(isRotated), y 최댓값 제한(yAxisMaxLimit) 없음 리포트가 쓰지 않는다. 아래 「현재 정의하지 않은 항목」

Specification

  • 그릇의 기본 글자는 12px(text-xs)이고 두 프리셋은 14px·500(text-sm font-medium)이다. 원본 화면의 그래프 글자가 14px·500이었다.
  • 색은 원본에서 그 자리가 맡던 역할을 따라 토큰으로 옮겼다. 축 선과 눈금은 stroke-oe-border-bold-primary, 축 글자는 fill-oe-foreground-primary, 커서는 stroke-oe-border-primary다. 격자와 커서는 Recharts의 기본값(#ccc)이 붙은 것만 덮어, 쓰는 쪽이 준 색은 그대로 둔다.
  • 격자·폴라 격자·기준선은 alpha stroke-oe-border-overlay-subtle로 긋는다. 고정 중립이 아닌 까닭은 그래프가 서는 바탕이 하나가 아니기 때문이다. oe-border-primary로 그렸을 때 같은 격자가 Dark background-canvas-primary 위에서 바탕과 채널 차 54로 무겁고 Dark background-secondary 위에서는 26으로 옅어 두 배 넘게 흔들렸다. alpha는 어느 바탕에서나 그 차를 Light 20, Dark 26~29로 묶는다(2026-10-07 실측). 커서는 격자가 아니다. 포인터가 가리키는 칸을 말하는 선이라 격자보다 진해야 하므로 oe-border-primary에 남는다.
  • 축 글자는 글자 class(.recharts-cartesian-axis-tick-value)로 찾는다. Recharts 3.10은 글자를 눈금 밖의 따로 선 층에 그려서, shadcn의 선택자(.recharts-cartesian-axis-tick text)가 글자에 닿지 않는다.
  • 꺾은선은 2px 곧은 선이다. 점은 평소 그리지 않고, 포인터를 얹은 칸에서 반지름 7px·테두리 3.5px의 점이 선다. 속은 oe-background-primary, 테두리는 계열 색이다.
  • 막대는 한 칸의 절반을 쓰고(양옆 25%), 막대 하나는 64px을 넘지 않으며, 한 칸 안의 막대끼리는 띄우지 않는다. 모서리는 각지다. 얹은 칸의 막대는 불투명도 0.75가 된다.
  • 세운 칸의 테두리는 stroke-oe-border-bold-primary 3px이다. 선은 막대의 테두리 선 위에 가운데를 맞춰 그려지므로 1.5px이 막대 안, 1.5px이 바탕 위에 선다. 바깥 절반이 바탕 위에 서는 것이 이 값을 고른 까닭이다. emphasis가 none이면 Cell을 하나도 두지 않아 전과 같은 사각형이 그려진다.
  • 꺾은선의 y 축 눈금은 가장 큰 값 위로 폭의 10%를 띄운 뒤 다섯 칸이 1·2·5·10의 배수로 떨어지게 한 칸을 고르고, 마지막 칸이 필요 없으면 넷으로 줄인다. 막대의 y 축은 0 이상인 값만 보고 위아래로 폭의 10%(적어도 1)를 띄운 뒤 폭이 4·10·50을 넘는지에 따라 1·2·10·50 단위로 끊고, 그 사이를 넷으로 나눠 반올림한다.
  • y 축 안쪽 여백은 꺾은선이 위 20px·아래 20px(0에서 시작할 때)·10px, 막대가 위 40px·아래 0이다.
  • 툴팁은 얹은 칸의 가운데에서 오른쪽으로 20px, 포인터에서 위로 5px에 선다. 오른쪽이 넘치면 왼쪽으로 넘어가고, 움직이지 않고 곧바로 옮겨 간다.
  • table 툴팁은 각진 상자에 oe-border-primary 1px 경계와 shadow-lg를 두른다. 머리줄은 bg-oe-background-bold-primary에 text-oe-foreground-inverse 14px Semibold, 줄은 text-oe-label(13px)에 text-oe-foreground-primary, 줄 사이는 oe-border-secondary 1px, 값 칸은 왼쪽에 oe-border-primary 점선을 두고 오른쪽에 붙이며 tabular-nums다. 표지는 10px 정사각형이다.
  • card 툴팁은 shadcn의 꼴이다. rounded-lg, oe-border-secondary 경계, bg-oe-background-primary, shadow-lg, 12px이며 이름은 text-oe-foreground-secondary, 값은 text-oe-foreground-primary에 tabular-nums다.
  • 툴팁 줄은 크기 토큰 text-oe-label과 글자색 text-oe-foreground-primary를 함께 갖는다. 둘이 같은 text-oe-로 시작해도 cn()이 갈라 두는 것은 packages/ui/src/utils.ts가 크기 토큰을 등록해 두었기 때문이다. 크기 토큰을 더하면 그 등록도 함께 고친다.
  • 범례는 칸 사이 16px, 축 쪽으로 12px 띄운다. 칸은 10px 정사각형이다. 감춘 계열의 칸은 불투명도 0.15, 범례에 포인터나 focus가 얹힌 동안 나머지 계열은 0.3이다.
  • 그래프에 키보드 focus가 있으면 SVG 둘레에 2px oe-focus-ring 테두리가 2px 떨어져 선다. 범례 단추의 focus는 2px oe-focus-ring 링이다.
  • 계열 색은 ChartStyle이 [data-chart=<id>]에 --color-<key> 변수로 쓰고, Dark는 .dark 아래에서 다시 쓴다. ;·{·}·<·>가 든 색 값은 쓰지 않는다.
  • 의존은 recharts 3.10과, Recharts가 React 19의 요소를 알아보게 하는 react-is 19다. @ooee/ui를 가져다 쓰는 저장소는 그래프를 직접 짜지 않는 한 recharts를 따로 들이지 않는다.

현재 정의하지 않은 항목

  • 열두째 계열의 색. 범주 색은 아홉이고 기본 색은 그 앞의 brand·중립 둘을 더해 열하나다. 그보다 많은 계열에 쓸 색을 더 두지 않는다 — 열을 같은 조건으로 찾으면 가장 가까운 쌍이 변별 문턱 0.0200에 닿고 열하나는 조건을 넘기는 조합이 없었다(2026-10-07 실측). 그 자리는 색이 아니라 다른 축이다. 모양·무늬로 가르는 범례와, 한 그래프를 둘로 나누는 규칙은 아직 정의하지 않았다.
  • 원·도넛, 가로 막대, 쌓은 막대, 영역 그래프, 꺾은선과 막대를 겹친 그래프.
  • 두 y 축. 단위가 다른 두 값을 한 그래프에 겹치면 두 축의 눈금 비율이 임의로 정해져 교차점이 뜻 없이 생긴다. 지금은 그래프 둘로 나눈다.
  • 금액 서식(원 단위 값을 만·억으로 줄여 읽기), 비율 줄, 막대 위 값 글자, y 최댓값 제한. 원본에 있었지만 리포트가 쓰지 않았다.
  • 불러오는 중과 값이 하나도 없는 그래프의 표시. 원본 리포트는 그래프 자리에 「차트 비활성」을 두었다. 프리셋은 계열이 하나도 없으면 축만 그리고 범례와 툴팁을 세우지 않는다.
  • 막대 그래프에서 「값 없음」과 「0」을 가르는 것.
  • 오른 칸과 내린 칸을 막대마다 증감 색으로 가르는 그래프. 칸마다 꼴을 바꾸는 길은 emphasis가 열었지만 색을 바꾸는 prop은 두지 않았다 — 오른 칸을 oe-up-*으로 칠하는 것이 맞는지는 「계열 색과 칸 색이 한 막대에서 부딪칠 때 무엇이 이기는가」를 먼저 정해야 답할 수 있고, 그 규칙이 아직 없다.
  • 꺾은선에서 한 점을 세우는 것. 선은 이어지는 흐름이라 한 점만 색이나 테두리를 바꾸면 선이 끊겨 보인다. 점을 키우는 쪽이 맞아 보이는데 그러면 activeDot과 부딪치므로 따로 정할 일이다.
  • 그래프 아래에 같은 값을 표로 보이는 대안.
  • 점이 나타날 때의 움직임.