Files
front-ui-registry/README.md

2.7 KiB

KRI UI Registry

사내 shadcn UI Registry 소스 프로젝트입니다. 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

로컬 프리뷰 주소 (npm run preview 실행 시):

http://localhost:4100/r/registry.json

Registry 항목

kri-select
kri-date-range-picker
kri-date-picker
kri-date-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-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-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

기본값은 닫기 버튼이 있는 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}로 툴바 전체를 감출 수 있습니다.
  • SMS/LMS 기본 제한은 각각 90/2,000바이트입니다.