260127_01_ENH: 커스텀 컴포넌트들 1차 완성 및 일부페이지에 SampleData 적용

This commit is contained in:
2026-01-27 16:59:24 +09:00
parent 76c2626507
commit 8bfa8fa7c4
33 changed files with 3035 additions and 35 deletions

View File

@@ -0,0 +1,248 @@
"use client";
import { useMemo } from "react";
import type React from "react";
import { cn } from "@/lib/utils";
import type { DataColumn, SignDisplayMode, SignStyle } from "../types";
type Props<T extends Record<string, unknown>> = {
columns: DataColumn<T>[];
rows: T[];
className?: string;
wrapperClassName?: string;
signStyle?: SignStyle<T>;
};
const parseSignedNumber = (raw: unknown): number | null => {
if (raw === null || raw === undefined) return null;
if (typeof raw === "number") return Number.isFinite(raw) ? raw : null;
if (typeof raw === "string") {
const s = raw
.trim()
.replaceAll(",", "")
.replaceAll("−", "-") // 유니코드 마이너스
.replaceAll("%", "");
if (s === "" || s === "-") return null;
const n = Number(s);
return Number.isFinite(n) ? n : null;
}
return null;
};
const defaultFmt = (v: number) =>
Number.isInteger(v) ? String(v) : v.toLocaleString();
const signText = (
v: number,
display: SignDisplayMode,
showPlus: boolean,
arrowWithNumber: boolean,
fmt: (n: number) => string,
zeroText: string
) => {
if (display === "arrow") {
if (v > 0) return arrowWithNumber ? `▲ ${fmt(Math.abs(v))}` : "▲";
if (v < 0) return arrowWithNumber ? `▼ ${fmt(Math.abs(v))}` : "▼";
return zeroText;
}
// number
if (v > 0) return showPlus ? `+${fmt(v)}` : fmt(v);
if (v < 0) return fmt(v); // 음수는 기본적으로 - 포함
return zeroText;
};
const DataTable = <T extends Record<string, unknown>>({
columns,
rows,
className,
wrapperClassName,
signStyle,
}: Props<T>) => {
const hasGroup = columns.some((c) => !!c.group) || columns.some((c) => c.headRowSpan === 2);
// group header(1행): rowspan=2 컬럼(th) + group label(colspan)
const groupCells = useMemo(() => {
type GroupCell =
| { kind: "rowspan"; label: string; colSpan: 1; rowSpan: 2; className?: string }
| { kind: "group"; label: string; colSpan: number; rowSpan: 1; className?: string }
| { kind: "blank"; label: string; colSpan: 1; rowSpan: 1; className?: string };
if (!hasGroup) return [] as GroupCell[];
const res: GroupCell[] = [];
let i = 0;
while (i < columns.length) {
const c = columns[i];
if (c.headRowSpan === 2) {
res.push({ kind: "rowspan", label: c.header, colSpan: 1, rowSpan: 2, className: c.headerClassName });
i++;
continue;
}
const g = c.group;
if (!g) {
// group 미지정: 1칸짜리 blank group 셀
res.push({ kind: "blank", label: "", colSpan: 1, rowSpan: 1, className: c.headerClassName });
i++;
continue;
}
// 같은 group 연속 구간 colSpan
let span = 1;
let j = i + 1;
while (j < columns.length && columns[j].headRowSpan !== 2 && columns[j].group === g) {
span++;
j++;
}
res.push({ kind: "group", label: g, colSpan: span, rowSpan: 1, className: c.headerClassName });
i = j;
}
return res;
}, [columns, hasGroup]);
const {
rowSelector,
keys,
paint = "text",
display = "number",
showPlus = true,
arrowWithNumber = false,
zeroText = "-",
valueFormatter,
positiveTextClassName = "text-primary font-semibold",
negativeTextClassName = "text-info font-semibold",
zeroTextClassName = "text-gray-600",
positiveCellBg = "hsl(var(--primary) / 0.08)",
negativeCellBg = "hsl(var(--info) / 0.08)",
zeroCellBg = "hsl(var(--lg-gray-200) / 0.6)",
} = signStyle ?? ({} as SignStyle<T>);
const fmt = valueFormatter ?? defaultFmt;
const isSignRow = (row: T, rowIndex: number) =>
!!signStyle && !!rowSelector?.(row, rowIndex);
const isTargetKey = (k: keyof T) => {
if (!signStyle) return false;
if (keys && keys.length) return keys.includes(k);
// keys 미지정이면 numeric 컬럼 전체
const col = columns.find((c) => c.key === k);
return !!col?.numeric;
};
const signClass = (v: number) => {
if (v > 0) return positiveTextClassName;
if (v < 0) return negativeTextClassName;
return zeroTextClassName;
};
const signBg = (v: number) => {
if (v > 0) return positiveCellBg;
if (v < 0) return negativeCellBg;
return zeroCellBg;
};
return (
<div className={cn("w-full overflow-x-auto", wrapperClassName)}>
<table className={cn("lg-table", className)}>
<thead>
{hasGroup && (
<tr className="lg-table__group">
{groupCells.map((g, idx) => (
<th
key={`${g.kind}-${g.label}-${idx}`}
colSpan={g.colSpan}
rowSpan={g.rowSpan}
className={g.className}
>
{g.label}
</th>
))}
</tr>
)}
<tr className={hasGroup ? "lg-table__subhead" : undefined}>
{columns
.filter((c) => c.headRowSpan !== 2)
.map((c) => (
<th key={String(c.key)} style={{ width: c.width }} className={c.headerClassName}>
{c.header}
</th>
))}
</tr>
</thead>
<tbody>
{rows.map((row, rIdx) => {
const signRow = isSignRow(row, rIdx);
return (
<tr key={rIdx}>
{columns.map((c) => {
const raw = row[c.key];
const align = c.align ?? (c.numeric ? "right" : "center");
// headRowSpan=2 컬럼은 thead 2행에서 제외되므로, tbody는 항상 렌더
// sign row + target column이면 색상/표기 적용
const applySign = signRow && isTargetKey(c.key) && !c.rowHead;
if (applySign) {
const n = parseSignedNumber(raw);
const displayText =
n === null ? "-" : signText(n, display, showPlus, arrowWithNumber, fmt, zeroText);
const style: React.CSSProperties =
paint === "cell"
? { textAlign: align, background: signBg(n ?? 0) }
: { textAlign: align };
return (
<td key={String(c.key)} style={style} className={c.cellClassName}>
<span className={cn(n === null ? "text-gray-500" : signClass(n))}>
{displayText}
</span>
</td>
);
}
// 일반 셀
const content = c.render
? c.render(row)
: raw === null || raw === undefined
? ""
: typeof raw === "string" || typeof raw === "number"
? raw
: String(raw);
if (c.rowHead) {
return (
<th
key={String(c.key)}
className={cn("lg-table__rowhead", c.cellClassName)}
style={{ textAlign: align }}
>
{content}
</th>
);
}
return (
<td key={String(c.key)} style={{ textAlign: align }} className={c.cellClassName}>
{content}
</td>
);
})}
</tr>
);
})}
</tbody>
</table>
</div>
);
}
export default DataTable;

View File

@@ -0,0 +1,162 @@
"use client";
import { useMemo } from "react";
import { cn } from "@/lib/utils";
import {GaugeColumn} from "../types";
type Props<T extends Record<string, unknown>> = {
columns: GaugeColumn<T>[];
rows: T[];
className?: string;
wrapperClassName?: string;
/** value가 0~100이 아니라 0~1이면 scale=100 */
scale?: number; // 기본 1
/** 색상(기본: primary 채움 + gray 트랙) */
fillColor?: string; // ex) "hsl(var(--primary) / 0.9)"
trackColor?: string; // ex) "hsl(var(--lg-gray-200) / 0.9)"
/** 셀 높이 */
cellHeight?: number; // 기본 26
/** 숫자 표시 여부/포맷 */
showValue?: boolean; // 기본 true
valueFormatter?: (v: number) => string;
};
const num = (v: unknown) => {
if (typeof v === "number" && Number.isFinite(v)) return v;
if (typeof v === "string") {
const n = Number(v.replaceAll(",", "").replaceAll("%", "").trim());
return Number.isFinite(n) ? n : null;
}
return null;
};
const GaugeTable = <T extends Record<string, unknown>>({
columns,
rows,
className,
wrapperClassName,
scale = 1,
fillColor = "hsl(var(--primary) / 0.85)",
trackColor = "hsl(var(--lg-gray-200) / 0.85)",
cellHeight = 26,
showValue = true,
valueFormatter,
}: Props<T>) => {
const hasGroup = columns.some((c) => !!c.group);
const groupCells = useMemo(() => {
if (!hasGroup) return [];
const res: { label: string; span: number }[] = [];
let i = 0;
while (i < columns.length) {
const g = columns[i].group ?? "";
let span = 1;
let j = i + 1;
while (j < columns.length && (columns[j].group ?? "") === g) {
span++;
j++;
}
res.push({ label: g, span });
i = j;
}
return res;
}, [columns, hasGroup]);
const fmt = valueFormatter ?? ((v: number) => String(Math.round(v)));
return (
<div className={cn("w-full overflow-x-auto", wrapperClassName)}>
<table className={cn("lg-table", className)}>
<thead>
{hasGroup && (
<tr className="lg-table__group">
{groupCells.map((g, idx) => (
<th key={`${g.label}-${idx}`} colSpan={g.span}>
{g.label}
</th>
))}
</tr>
)}
<tr className={hasGroup ? "lg-table__subhead" : undefined}>
{columns.map((c) => (
<th key={String(c.key)} style={{ width: c.width }}>
{c.header}
</th>
))}
</tr>
</thead>
<tbody>
{rows.map((row, rIdx) => (
<tr key={rIdx}>
{columns.map((c) => {
const align = c.align ?? (c.rowHead ? "left" : "center");
if (c.rowHead) {
const raw = row[c.key];
const label = c.renderLabel
? c.renderLabel(row)
: raw === null || raw === undefined
? ""
: typeof raw === "string" || typeof raw === "number"
? raw
: String(raw);
return (
<th
key={String(c.key)}
className="lg-table__rowhead"
style={{ textAlign: align }}
>
{label}
</th>
);
}
const raw = row[c.key];
const v = num(raw);
const max = c.max ?? 100;
const ratio = v === null ? 0 : Math.max(0, Math.min(1, (v * scale) / max));
const pct = ratio * 100;
return (
<td key={String(c.key)} style={{ textAlign: align }}>
<div
className="relative overflow-hidden rounded-md"
style={{
height: cellHeight,
background: trackColor,
border: "1px solid hsl(var(--border))",
}}
>
<div
className="absolute inset-y-0 left-0"
style={{
width: `${pct}%`,
background: fillColor,
}}
/>
{showValue && (
<div
className="relative z-10 flex h-full items-center justify-center content-text-sm"
style={{ color: "hsl(var(--lg-gray-900))" }}
>
{v === null ? "-" : fmt(v)}
</div>
)}
</div>
</td>
);
})}
</tr>
))}
</tbody>
</table>
</div>
);
}
export default GaugeTable;