Chart
값의 흐름은 꺾은선, 항목끼리의 크기는 세로 막대로 보이는 그래프입니다. 계열마다 이름과 색을 config로 정하고, 포인터를 얹은 칸의 값을 툴팁이 한 번에 보입니다.
🚩 Playground
그래프 종류와 툴팁·범례·계열 색, x 축 라벨 간격을 조합하여 실제 동작에서 확인합니다. 포인터를 얹거나 그래프에 focus 를 두고 화살표 키를 누르면 툴팁이 섭니다. Bar 에서 Emphasis 를 누르면 고른 칸에 테두리가 섭니다.
Appearance
Content
Elements
Behavior
Anatomy
그래프는 그릇 안에서 격자와 두 축 위에 계열을 그립니다. 범례와 툴팁은 고를 수 있는 요소입니다.
Basic anatomy
- 1.Chart container (div)
- 2.Grid
- 3.X axis
- 4.Y axis
- 5.Series — Line · Bar
Extended anatomy
- 6.Legend(Optional)
- 7.Legend item (button)(Optional)
- 8.Tooltip(Optional)
- 9.Tooltip label(Optional)
- 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
- Chart container
- Grid
- X axis
- Y axis
- Series — 꺾은선의 선 또는 막대
Extended anatomy는 선택 요소를 표시한다.
- Legend (Optional)
- Legend item (Optional) — 프리셋 안에서는 누를 수 있는 단추다
- Tooltip (Optional) — 포인터를 얹거나 그래프에 focus를 두고 화살표 키를 누를 때 선다
- Tooltip label (Optional)
- 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 축 값이 든 keyunit: y 축 눈금과 툴팁 값 뒤에 붙는 단위. 주지 않으면 붙이지 않는다height: 그래프 높이(px), 기본값320. 범례를 포함한 높이다legend:false | true, 기본값truelegendPosition:top | bottom, 기본값bottomtickRotateThreshold: x 축 값이 이보다 많으면 라벨을 -45° 기울인다. 기본값20. 라벨 길이가 아니라 칸의 개수를 본다tooltipTitleKey: 툴팁 제목이 든 key. 주지 않으면 x 축 값이 제목이다tooltipVariant:card | table, 기본값tablevalueFormatter: 툴팁 값 글자를 만드는 함수(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, 기본값falsehideIndicator:false | true, 기본값falsevalueFormatter: 값 글자를 만드는 함수. 단위를 붙이는 자리다labelFormatter·formatter·labelKey·nameKey·labelClassName은 shadcn과 같다. 값이 없는 줄(null)은 그리지 않는다
ChartLegendContent
hideIcon:false | true, 기본값falsenameKey: 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-primary3px이고 선의 바깥 절반이 바탕 위에 선다. 그래서 계열 색이 무엇이든 보인다(바탕과 Light 19.79:1, Dark 17.16:1). 같은 중립을 막대 안쪽에만 그리면 안 된다 — 짙은 계열 색 위에서 1.19:1까지 떨어진다(Darkoe-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로 그렸을 때 같은 격자가 Darkbackground-canvas-primary위에서 바탕과 채널 차 54로 무겁고 Darkbackground-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-primary3px이다. 선은 막대의 테두리 선 위에 가운데를 맞춰 그려지므로 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-primary1px 경계와shadow-lg를 두른다. 머리줄은bg-oe-background-bold-primary에text-oe-foreground-inverse14px Semibold, 줄은text-oe-label(13px)에text-oe-foreground-primary, 줄 사이는oe-border-secondary1px, 값 칸은 왼쪽에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는 2pxoe-focus-ring링이다. - 계열 색은
ChartStyle이[data-chart=<id>]에--color-<key>변수로 쓰고, Dark는.dark아래에서 다시 쓴다.;·{·}·<·>가 든 색 값은 쓰지 않는다. - 의존은
recharts3.10과, Recharts가 React 19의 요소를 알아보게 하는react-is19다.@ooee/ui를 가져다 쓰는 저장소는 그래프를 직접 짜지 않는 한recharts를 따로 들이지 않는다.
현재 정의하지 않은 항목
- 열두째 계열의 색. 범주 색은 아홉이고 기본 색은 그 앞의 brand·중립 둘을 더해 열하나다. 그보다 많은 계열에 쓸 색을 더 두지 않는다 — 열을 같은 조건으로 찾으면 가장 가까운 쌍이 변별 문턱 0.0200에 닿고 열하나는 조건을 넘기는 조합이 없었다(
2026-10-07실측). 그 자리는 색이 아니라 다른 축이다. 모양·무늬로 가르는 범례와, 한 그래프를 둘로 나누는 규칙은 아직 정의하지 않았다. - 원·도넛, 가로 막대, 쌓은 막대, 영역 그래프, 꺾은선과 막대를 겹친 그래프.
- 두 y 축. 단위가 다른 두 값을 한 그래프에 겹치면 두 축의 눈금 비율이 임의로 정해져 교차점이 뜻 없이 생긴다. 지금은 그래프 둘로 나눈다.
- 금액 서식(원 단위 값을 만·억으로 줄여 읽기), 비율 줄, 막대 위 값 글자, y 최댓값 제한. 원본에 있었지만 리포트가 쓰지 않았다.
- 불러오는 중과 값이 하나도 없는 그래프의 표시. 원본 리포트는 그래프 자리에 「차트 비활성」을 두었다. 프리셋은 계열이 하나도 없으면 축만 그리고 범례와 툴팁을 세우지 않는다.
- 막대 그래프에서 「값 없음」과 「0」을 가르는 것.
- 오른 칸과 내린 칸을 막대마다 증감 색으로 가르는 그래프. 칸마다 꼴을 바꾸는 길은
emphasis가 열었지만 색을 바꾸는 prop은 두지 않았다 — 오른 칸을oe-up-*으로 칠하는 것이 맞는지는 「계열 색과 칸 색이 한 막대에서 부딪칠 때 무엇이 이기는가」를 먼저 정해야 답할 수 있고, 그 규칙이 아직 없다. - 꺾은선에서 한 점을 세우는 것. 선은 이어지는 흐름이라 한 점만 색이나 테두리를 바꾸면 선이 끊겨 보인다. 점을 키우는 쪽이 맞아 보이는데 그러면
activeDot과 부딪치므로 따로 정할 일이다. - 그래프 아래에 같은 값을 표로 보이는 대안.
- 점이 나타날 때의 움직임.