260209_01_ENH: 테이블에 단위 텍스트 추가, 하단 설명 추가

This commit is contained in:
2026-02-09 16:28:29 +09:00
parent b7282bd07d
commit 6e6120f205
21 changed files with 249 additions and 173 deletions

View File

@@ -5,18 +5,20 @@ import { cn, parseNumber } from "@/lib/utils";
import type { ChartData, SignStyle, TopChartTableRow } from "../types";
import SectionTitle from "../SectionTitle";
import { CHART_HEIGHTS, TABLE_DIMENSIONS } from "@/const/chartConst";
import {UNIT_TEXT} from "@/const/lgConst";
import {isCagrRow} from "@/lib/lg-dashboard";
type BaseProps = {
export type TopChartTableProps = {
title?: string;
categories: string[];
rows: TopChartTableRow[];
/** 테이블 상단(헤더 1행) 콜스팬 셀 내부에 렌더될 차트 */
chart?:
| React.ReactNode
| ((ctx: {
/** 테이블 컬럼(=x축) 기준으로 구성된 ChartData */
chartData: ChartData;
tableCategories: string[];
tableRows: TopChartTableRow[];
}) => React.ReactNode);
| React.ReactNode
| ((ctx: {
/** 테이블 컬럼(=x축) 기준으로 구성된 ChartData */
chartData: ChartData;
}) => React.ReactNode);
/** chart 셀 높이(px) */
chartHeight?: number;
/** 가로 스크롤 min-width */
@@ -25,31 +27,9 @@ type BaseProps = {
wrapperClassName?: string;
/** +/-/0 색상/표기 옵션(선택) */
signStyle?: SignStyle<TopChartTableRow>;
fillCAGR?: boolean;
unitText?: string;
};
/**
* 1) (신규) HTML 형태: columns=categories, rows=TopChartTableRow
*/
type HtmlModeProps = BaseProps & {
categories: string[];
rows: TopChartTableRow[];
};
/**
* 2) (호환) 기존 형태: ChartData 기반으로 rows/columns 자동 생성
* - rows = data.categories
* - cols = data.series.name
*/
type ChartDataModeProps = BaseProps & {
data: ChartData;
/** 좌측 rowhead 컬럼 헤더 */
categoryHeader?: string;
/** 값 표기 포맷터 */
valueFormatter?: (v: number) => string;
};
export type TopChartTableProps = HtmlModeProps | ChartDataModeProps;
// toNumber는 utils.ts의 parseNumber로 통합됨
function formatSignedNumber(n: number, zeroText: string, showPlus: boolean) {
@@ -68,12 +48,16 @@ function toCellValue(v: unknown): CellValue {
export default function TopChartTable(props: TopChartTableProps) {
const {
title,
rows,
categories,
chart,
chartHeight = CHART_HEIGHTS.DEFAULT,
minWidthPx = TABLE_DIMENSIONS.MIN_WIDTH.STANDARD,
tableClassName,
wrapperClassName,
signStyle,
fillCAGR = false,
unitText = UNIT_TEXT
} = props;
const display = signStyle?.display ?? "number";
@@ -83,63 +67,40 @@ export default function TopChartTable(props: TopChartTableProps) {
const negCls = signStyle?.negativeTextClassName ?? "lg-num-neg";
const zeroText = signStyle?.zeroText ?? "-";
const { categories, rows, rowHeadHeader, valueFormatter } = useMemo(() => {
if ("data" in props) {
const d = props.data;
const tableRows: TopChartTableRow[] = d.categories.map((cat, i) => ({
label: String(cat ?? ""),
values: d.series.map((s) => toCellValue(s.data[i] ?? null)),
}));
return {
categories: d.series.map((s) => s.name),
rows: tableRows,
rowHeadHeader: props.categoryHeader ?? "",
valueFormatter: props.valueFormatter,
};
}
return {
categories: props.categories,
rows: props.rows,
rowHeadHeader: "",
valueFormatter: undefined,
};
}, [props]);
// 테이블 컬럼(=categories)을 x축으로 사용하는 chartData를 항상 제공
const chartData: ChartData = useMemo(
() => ({
categories,
series: rows.map((r) => ({
name: r.label,
data: r.values.map((v) => parseNumber(v) ?? null),
})),
}),
[categories, rows]
() => ({
categories,
series: rows.map((r) => ({
name: r.label,
data: r.values.map((v) => parseNumber(v) ?? null),
})),
}),
[categories, rows]
);
const chartNode = useMemo(() => {
if (!chart) return null;
return typeof chart === "function" ? chart({ chartData, tableCategories: categories, tableRows: rows }) : chart;
return typeof chart === "function" ? chart({ chartData }) : chart;
}, [chart, chartData, categories, rows]);
return (
<div className={cn("w-full", wrapperClassName)}>
{title && (
<SectionTitle title={title} />
)}
<div className={cn("w-full", wrapperClassName)}>
<div className="mb-2 flex items-center justify-between">
{title ? <SectionTitle title={title} /> : <div />}
{unitText ? <div className="text-gray-500 text-xs font-semibold">{unitText}</div> : null}
</div>
<div className="overflow-x-auto">
<table
className={cn("lg-table", tableClassName)}
style={{ minWidth: `${minWidthPx}px` }}
>
<thead>
<div className="overflow-x-auto">
<table
className={cn("lg-table", tableClassName)}
style={{ minWidth: `${minWidthPx}px` }}
>
<thead>
<tr>
{/* 좌상단: rowhead 헤더(필요 시 표시). HTML과 동일하게 2행 rowspan */}
<th rowSpan={2} className="lg-table__sep-r w-15" style={{ whiteSpace: "nowrap" }}>
{rowHeadHeader}
</th>
<td colSpan={categories.length} style={{ padding: 0, height: chartNode ? chartHeight : 0 }}>
{chartNode ? <div style={{ width: "100%", height: "100%" }}>{chartNode}</div> : null}
@@ -148,61 +109,65 @@ export default function TopChartTable(props: TopChartTableProps) {
<tr className="lg-table__subhead">
{categories.map((c) => (
<th key={c} className={"content-text-xs"}>{c}</th>
<th key={c} className={"content-text-xs"}>{c}</th>
))}
</tr>
</thead>
</thead>
<tbody>
<tbody>
{rows.map((r, ri) => {
const isSignRow = !!(signStyle?.rowSelector && signStyle.rowSelector(r, ri));
const cagrRow = isCagrRow(r.label as string ?? "");
const total = parseNumber(r.total);
return (
<tr key={`${r.label}-${ri}`}>
<th scope="row" className="lg-table__rowhead lg-table__sep-r content-text-sm">
{r.label}
</th>
<tr key={`${r.label}-${ri}`}>
<th scope="row" className="lg-table__rowhead lg-table__sep-r content-text-sm">
{r.label}
</th>
{categories.map((_, ci) => {
const raw = r.values?.[ci];
const n = parseNumber(raw);
{categories.map((_, ci) => {
const raw = r.values?.[ci];
const n = parseNumber(raw);
// 일반 행
if (!isSignRow) {
// 일반 행
if (!isSignRow) {
if (n === null) return <td key={ci}>-</td>;
const isFill = fillCAGR && cagrRow && total && n > total + 5;
const txt = n.toLocaleString();
return <td key={ci} className={cn(isFill? "bg-red-200" :"")}>{txt}</td>;
}
// sign row
if (n === null) return <td key={ci}>-</td>;
const txt = valueFormatter ? valueFormatter(n) : n.toLocaleString();
return <td key={ci}>{txt}</td>;
}
if (n === 0) return <td key={ci}>{zeroText}</td>;
// sign row
if (n === null) return <td key={ci}>-</td>;
if (n === 0) return <td key={ci}>{zeroText}</td>;
const cls = n > 0 ? posCls : negCls;
const cls = n > 0 ? posCls : negCls;
if (display === "arrow") {
const arrow = n > 0 ? "▲" : "▼";
const num = Math.abs(n);
return (
<td key={ci} className={cls}>
{arrow}
{arrowWithNumber ? ` ${num}` : ""}
</td>
);
}
if (display === "arrow") {
const arrow = n > 0 ? "▲" : "▼";
const num = Math.abs(n);
return (
<td key={ci} className={cls}>
{arrow}
{arrowWithNumber ? ` ${num}` : ""}
</td>
<td key={ci} className={cls}>
{formatSignedNumber(n, zeroText, showPlus)}
</td>
);
}
return (
<td key={ci} className={cls}>
{formatSignedNumber(n, zeroText, showPlus)}
</td>
);
})}
</tr>
})}
</tr>
);
})}
</tbody>
</table>
</tbody>
</table>
</div>
</div>
</div>
);
}
}