c76a5f560a5ea9d56cee10de6cae0d6ba6004c44
KRI UI Registry
KRI 공통 shadcn UI Registry 프로젝트입니다. npm run build로 생성되는 dist/r 정적 JSON 파일을 IIS 또는 Nginx에 배포해서 사용합니다.
빌드 및 검증
npm ci
npm run build
npm run verify
npm run preview
배포 Registry 주소:
https://ui-registry.kric.com/r/registry.json
로컬 preview 주소 (npm run preview 실행 후):
http://localhost:4100/r/registry.json
Registry 항목
kri-chart
kri-select
kri-date-range-picker
kri-date-picker
kri-date-time-picker
kri-time-picker
kri-password
kri-auto-complete
kri-data-table
kri-loading-overlay
kri-editor
kri-layout
kri-dialog
개별 설치 예시:
npx shadcn@latest add https://ui-registry.kric.com/r/kri-chart.json
npx shadcn@latest add https://ui-registry.kric.com/r/kri-select.json
npx shadcn@latest add https://ui-registry.kric.com/r/kri-password.json
npx shadcn@latest add https://ui-registry.kric.com/r/kri-date-range-picker.json
npx shadcn@latest add https://ui-registry.kric.com/r/kri-date-picker.json
npx shadcn@latest add https://ui-registry.kric.com/r/kri-date-time-picker.json
npx shadcn@latest add https://ui-registry.kric.com/r/kri-time-picker.json
npx shadcn@latest add https://ui-registry.kric.com/r/kri-auto-complete.json
npx shadcn@latest add https://ui-registry.kric.com/r/kri-data-table.json
npx shadcn@latest add https://ui-registry.kric.com/r/kri-loading-overlay.json
npx shadcn@latest add https://ui-registry.kric.com/r/kri-editor.json
npx shadcn@latest add https://ui-registry.kric.com/r/kri-layout.json
npx shadcn@latest add https://ui-registry.kric.com/r/kri-dialog.json
KRI Chart
kri-chart는 echarts, echarts-for-react 기반 공통 차트 컴포넌트입니다. 내부적으로 BaseEChart를 사용하며, 모든 wrapper는 멀티 시리즈를 지원합니다.
제공 컴포넌트:
BaseEChart
KriLineChart
KriBarChart
KriStackedBarChart
KriPieChart
KriRadarChart
KriScatterChart
Line
import { KriLineChart } from '@/components/chart'
<KriLineChart
categories={['1월', '2월', '3월']}
series={[
{ name: '매출', data: [120, 180, 160] },
{ name: '영업이익', data: [30, 42, 38] },
]}
smooth
/>
Bar / Horizontal Bar
import { KriBarChart } from '@/components/chart'
<KriBarChart
categories={['A', 'B', 'C']}
series={[
{ name: '2025', data: [10, 20, 30] },
{ name: '2026', data: [15, 18, 35] },
]}
isHorizontal
/>
Stacked Bar
import { KriStackedBarChart } from '@/components/chart'
<KriStackedBarChart
categories={['A', 'B', 'C']}
series={[
{ name: '직접', data: [10, 20, 30] },
{ name: '간접', data: [5, 12, 18] },
]}
/>
Pie
import { KriPieChart } from '@/components/chart'
<KriPieChart
series={[
{
name: '접속 경로',
data: [
{ name: '검색', value: 45 },
{ name: '광고', value: 25 },
{ name: '직접', value: 30 },
],
},
]}
/>
Radar
import { KriRadarChart } from '@/components/chart'
<KriRadarChart
indicators={[
{ name: '품질', max: 100 },
{ name: '속도', max: 100 },
{ name: '안정성', max: 100 },
]}
series={[
{ name: '서비스 A', data: [90, 80, 85] },
{ name: '서비스 B', data: [70, 95, 78] },
]}
/>
Scatter
import { KriScatterChart } from '@/components/chart'
<KriScatterChart
series={[
{
name: '분포',
data: [
[10, 20],
[15, 35],
[25, 30],
],
},
]}
/>
공통 props:
height: 차트 wrapper 높이, 기본값CHART_HEIGHTS.DEFAULTclassName,contentClassName,chartClassName: wrapper classNamenotMerge,lazyUpdate,onEvents:echarts-for-react전달 옵션option: wrapper가 생성한 ECharts option을 덮어쓰는 override 옵션normalizeValues,decimalPlaces: 숫자 데이터 반올림 정규화 옵션
KriDialog Footer 규칙
기본값은 닫기 버튼이 있는 Footer입니다.
<KriDialog open={open} onOpenChange={setOpen} title="사용자 등록">
{/* Body */}
</KriDialog>
기본 Footer를 제거합니다.
<KriDialog
open={open}
onOpenChange={setOpen}
title="사용자 등록"
showDefaultFooter={false}
>
{/* Body */}
</KriDialog>
사용자 정의 Footer를 전달합니다. footer가 지정되면 기본 Footer보다 우선합니다.
<KriDialog
open={open}
onOpenChange={setOpen}
title="사용자 등록"
footer={
<>
<Button variant="outline" onClick={() => setOpen(false)}>취소</Button>
<Button onClick={handleSave}>저장</Button>
</>
}
>
{/* Body */}
</KriDialog>
footer={null}을 전달해도 Footer가 표시되지 않습니다.
Editor 주요 옵션
<KriEditor
mode="both"
value={html}
onChange={setHtml}
onImageUpload={async (file) => upload(file)}
smsMaxBytes={90}
lmsMaxBytes={2000}
toolbar={{ image: true, table: false, html: true }}
/>
- 편집 값은 HTML 문자열입니다.
- 이미지 업로드 함수는 URL 문자열 또는
{ url }을 반환할 수 있습니다. toolbar={false}로 toolbar 전체를 숨길 수 있습니다.- SMS/LMS 기본 제한은 각각 90/2,000바이트입니다.
Description
Languages
TypeScript
99.1%
JavaScript
0.9%