JS Design System v0.6

Data Visual

대시보드의 수치·추이·비율을 보여줍니다. KPI 카드, 가로 막대, 도넛, 스파크라인을 CSS 만으로 구성하며 색은 심각도 토큰을 그대로 씁니다.

1. Default

값 하나를 보여 주는 기본 KPI 입니다.

연결 에이전트1,247

2. KPI

라벨 · 값 · 증감. 보안 지표는 증가가 위험(.up 빨강), 감소가 좋음(.down 초록).

Critical 이벤트1,284 12% 전주 대비
차단률99.2% 0.3%p
연결 에이전트1,247/ 1,28437대 오프라인
미처리 검토524시간 내 처리

3. Bar Chart

항목별 비교. i 의 width 가 값, 색은 심각도.

유형별 탐지 최근 7일

랜섬웨어
412
악성코드
306
USB 위반
221
정책 위반
115

4. Donut + Legend

구성 비율. conic-gradient 로 그리고 중앙 값은 data-label.

심각도 분포

Critical 190 High 285 Medium 316 Low 263

5. Sparkline

카드 안 소형 추이. 강조 막대는 .hi.

일별 탐지412

Props

HTML 에서는 클래스와 속성으로, React(@jiran/ds-react)에서는 같은 이름의 prop(variant · size …)으로 변형·상태를 지정합니다.

Prop / ClassType · ValuesDefaultDescription
.kpidiv—.label + .value(small 단위) + .delta(.up/.down). .critical/.high 로 값 색
.kpi-gridcontainer—auto-fit 180px
.chart .rowrow—.lbl + .bar(i width%) + .num. bar 톤 critical|high|medium|low
.donutdiv—conic-gradient 배경, data-label 중앙 값, role=img aria-label
.chart-legenddiv—i 색 + 라벨 + b 값
.chart-cardcontainer—차트를 담는 카드. Card 와 같은 Surface·radius/lg·shadow/1 이고 padding 20 24 · gap 16 입니다. React ChartCard
.sparklinediv—i height% 막대, .hi 강조

Usage

React: @jiran/ds-react 패키지를 설치하고 style.css 를 한 번 import 하면 위 React 탭 코드를 그대로 쓸 수 있습니다(React Package). HTML: assets/style.css 를 연결하고(일부만 필요하면 아래 컴포넌트 CSS 복사), 동작이 필요하면 assets/ds.js 를 함께 넣습니다 — 이 페이지의 프리뷰가 그 스크립트로 동작합니다. 색은 전부 토큰(var(--accent) 등)을 참조하므로 --accent-* 만 제품 컬러로 바꾸면 됩니다.

React @jiran/ds-react

npm i @jiran/ds-react

// main.tsx — 앱 진입점에서 한 번
import "@jiran/ds-react/style.css";

// 컴포넌트
import { Kpi, KpiGrid, ChartCard, BarChart, Donut, DonutRow, ChartLegend, Sparkline } from "@jiran/ds-react";

HTML

<!-- 1) 토큰 + 전체 컴포넌트 스타일 한 번에 연결 -->
<link rel="stylesheet" href="assets/style.css">
<!-- 동작(드롭다운·탭·달력·표 정렬/선택·토스트 등) — 순수 JS 한 파일. React 제품은 불필요 -->
<script src="assets/ds.js" defer></script>

<!-- 2) 또는 아래 "Component CSS" 만 프로젝트 CSS 에 붙이고,
        :root 토큰은 Foundations › Design Token 에서 복사 -->

Component CSS .kpi, .kpi-grid, .chart, .chart-card, .donut, .donut-row, .chart-legend, .sparkline

/* JS Design System v0.6 · .kpi, .kpi-grid, .chart, .chart-card, .donut, .donut-row, .chart-legend, .sparkline · 토큰(var(--*))은 assets/style.css :root 참고 */
.kpi{background:var(--bg-surface);border-radius:var(--radius-lg);box-shadow:var(--shadow-1);padding:20px 24px;min-width:180px;display:flex;flex-direction:column;gap:4px}
.kpi .label{font-size:12px;color:var(--text-tertiary);font-weight:500}
.kpi .value{font-size:32px;font-weight:700;letter-spacing:-.02em;line-height:1.2;white-space:nowrap}
.kpi .value small{font-size:16px;font-weight:500;color:var(--text-tertiary);margin-left:2px}
.kpi .delta{font-size:12px;font-weight:600;color:var(--text-secondary)}
.kpi .delta svg{width:12px;height:12px;vertical-align:-1px}
.kpi .delta.up{color:var(--danger-text)}
.kpi .delta.down{color:var(--success-text)}
.kpi.critical .value{color:var(--sev-critical-text)}
.kpi.high .value{color:var(--sev-high-text)}
.kpi-grid{display:grid;grid-template-columns:repeat(auto-fit,minmax(180px,1fr));gap:16px;width:100%}
.chart{display:flex;flex-direction:column;gap:10px;width:100%;font-size:12px}
.chart .row{display:grid;grid-template-columns:120px 1fr 56px;align-items:center;gap:12px}
.chart .row .lbl{color:var(--text-secondary);white-space:nowrap;overflow:hidden;text-overflow:ellipsis}
.chart .bar{height:12px;border-radius:var(--radius-full);background:var(--bg-panel);overflow:hidden}
.chart .bar i{display:block;height:100%;background:var(--accent-graphic);border-radius:var(--radius-full)}
.chart .bar.critical i{background:var(--sev-critical)}
.chart .bar.high i{background:var(--sev-high)}
.chart .bar.medium i{background:var(--sev-medium)}
.chart .bar.low i{background:var(--sev-low)}
.chart .num{text-align:right;color:var(--text-secondary)}
.chart-card{background:var(--bg-surface);border-radius:var(--radius-lg);box-shadow:var(--shadow-1);padding:20px 24px;display:flex;flex-direction:column;gap:16px;width:100%}
.chart-card .chart-title{font-size:16px;font-weight:600;margin:0;display:flex;justify-content:space-between;align-items:center}
.donut{width:120px;height:120px;border-radius:50%;display:grid;place-items:center;flex:none;background:conic-gradient(var(--sev-critical) 0 18%,var(--sev-high) 18% 45%,var(--sev-medium) 45% 75%,var(--sev-low) 75% 100%)}
.donut::after{content:attr(data-label);width:80px;height:80px;border-radius:50%;background:var(--bg-surface);display:grid;place-items:center;font-weight:700;font-size:16px;}
.donut-row{display:flex;align-items:center;gap:24px}
.chart-legend{display:flex;flex-wrap:wrap;gap:8px 20px;font-size:12px;color:var(--text-secondary)}
.chart-legend span{display:inline-flex;align-items:center;gap:6px}
.chart-legend i{width:10px;height:10px;border-radius:2px;background:var(--interaction-inactive);flex:none}
.chart-legend b{color:var(--text-primary);}
.sparkline{display:flex;align-items:flex-end;gap:3px;height:32px}
.sparkline i{display:block;width:6px;background:var(--accent-300);border-radius:2px}
.sparkline i.hi{background:var(--accent-graphic)}