설치
의존성을 설치하고 앱 구조를 설정하는 방법입니다.
가이드
임포트
React용 원본 shadcn/ui는 전체 컴포넌트를 단일 파일에 작성할 수 있지만, 이 포트에서는 컴포넌트가 여러 파일로 분리되어 있습니다. Svelte는 단일 파일에 여러 컴포넌트를 정의하는 것을 지원하지 않기 때문에, CLI를 활용하여 컴포넌트를 추가하는 것이 최적의 방법입니다.
CLI는 각 컴포넌트마다 폴더를 생성하며, 때로는 단일 Svelte 파일만 포함하고, 때로는 여러 파일을 포함합니다. 각 폴더 내에는 컴포넌트를 내보내는 index.ts 파일이 있어 단일 파일에서 임포트할 수 있습니다.
예를 들어, Accordion 컴포넌트는 네 개의 .svelte 파일로 분리되어 있습니다:
accordion.svelteaccordion-content.svelteaccordion-item.svelteaccordion-trigger.svelte
이들은 다음과 같이 accordion/index.ts 파일에서 임포트할 수 있습니다:
import * as Accordion from '$lib/components/ui/accordion"
// or
import {
Accordion,
AccordionContent,
AccordionItem,
AccordionTrigger
} from "$lib/components/ui/accordion" 어떤 임포트 방식을 사용하든, 컴포넌트는 Rollup에 의해 트리 셰이킹되므로 사용하지 않는 컴포넌트가 앱에 번들되는 것을 걱정할 필요가 없습니다.
VSCode 확장
@selemondev가 제작한 shadcn-svelte VSCode 확장을 Visual Studio Code에 설치하면 Shadcn Svelte 컴포넌트를 프로젝트에 쉽게 추가할 수 있습니다.
이 확장은 다양한 기능을 제공합니다:
- shadcn-svelte CLI 초기화 기능
- 프로젝트에 컴포넌트 추가
- IDE에서 직접 특정 컴포넌트의 문서 페이지로 이동
- 빠른 컴포넌트 임포트 및 마크업을 위한 편리한 스니펫
JetBrains IDE 확장
@WarningImHack3r가 제작한 shadcn/ui Components Manager JetBrains 확장을 JetBrains IDE(IntelliJ IDEA, WebStorm 등)에 설치하면 프로젝트 내에서 shadcn 컴포넌트를 쉽게 관리할 수 있습니다.
이 확장은 다음을 포함한 다양한 기능을 제공합니다:
- 프로젝트 내 shadcn/ui 컴포넌트 자동 감지
- 클릭 한 번으로 컴포넌트 추가, 제거 및 업데이트
- 모든 shadcn/ui 구현 지원: Svelte, React, Vue, Solid
- 원격 또는 기존 컴포넌트 간편하게 검색