113 lines
2.4 KiB
Markdown
113 lines
2.4 KiB
Markdown
# KRI UI Registry
|
|
|
|
사내 shadcn UI Registry 소스 프로젝트입니다. `dist/r`의 정적 JSON을 IIS 또는 Nginx에 배포합니다.
|
|
|
|
## 빌드 및 검증
|
|
|
|
```powershell
|
|
npm ci
|
|
npm run build
|
|
npm run verify
|
|
npm run preview
|
|
```
|
|
|
|
배포된 Registry 주소:
|
|
|
|
```text
|
|
https://ui-registry.kric.com/r/registry.json
|
|
```
|
|
|
|
로컬 프리뷰 주소 (`npm run preview` 실행 시):
|
|
|
|
```text
|
|
http://localhost:4100/r/registry.json
|
|
```
|
|
|
|
## Registry 항목
|
|
|
|
```text
|
|
kri-select
|
|
kri-date-range-picker
|
|
kri-password
|
|
kri-auto-complete
|
|
kri-data-table
|
|
kri-loading-overlay
|
|
kri-editor
|
|
kri-layout
|
|
kri-dialog
|
|
```
|
|
|
|
전체 설치 예시:
|
|
|
|
```powershell
|
|
npx shadcn@latest add https://ui-registry.kric.com/r/kri-password.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
|
|
```
|
|
|
|
## KriDialog Footer 규칙
|
|
|
|
기본값은 `닫기` 버튼이 있는 Footer입니다.
|
|
|
|
```tsx
|
|
<KriDialog open={open} onOpenChange={setOpen} title="사용자 등록">
|
|
{/* Body */}
|
|
</KriDialog>
|
|
```
|
|
|
|
기본 Footer를 제거합니다.
|
|
|
|
```tsx
|
|
<KriDialog
|
|
open={open}
|
|
onOpenChange={setOpen}
|
|
title="사용자 등록"
|
|
showDefaultFooter={false}
|
|
>
|
|
{/* Body */}
|
|
</KriDialog>
|
|
```
|
|
|
|
사용자 정의 Footer를 전달합니다. `footer`가 지정되면 기본 Footer보다 우선합니다.
|
|
|
|
```tsx
|
|
<KriDialog
|
|
open={open}
|
|
onOpenChange={setOpen}
|
|
title="사용자 등록"
|
|
footer={
|
|
<>
|
|
<Button variant="outline" onClick={() => setOpen(false)}>취소</Button>
|
|
<Button onClick={handleSave}>저장</Button>
|
|
</>
|
|
}
|
|
>
|
|
{/* Body */}
|
|
</KriDialog>
|
|
```
|
|
|
|
`footer={null}`을 전달해도 Footer가 표시되지 않습니다.
|
|
|
|
## Editor 주요 옵션
|
|
|
|
```tsx
|
|
<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}`로 툴바 전체를 감출 수 있습니다.
|
|
- SMS/LMS 기본 제한은 각각 90/2,000바이트입니다.
|