이 사이트는 shadcn-svelte 공식 문서의 한국어 번역입니다.
6.9k

설치

Next

의존성을 설치하고 앱 구조를 설정하는 방법입니다.

가이드

임포트

React용 원본 shadcn/ui는 전체 컴포넌트를 단일 파일에 작성할 수 있지만, 이 포트에서는 컴포넌트가 여러 파일로 분리되어 있습니다. Svelte는 단일 파일에 여러 컴포넌트를 정의하는 것을 지원하지 않기 때문에, CLI를 활용하여 컴포넌트를 추가하는 것이 최적의 방법입니다.

CLI는 컴포넌트마다 폴더를 생성하며, 때로는 단일 Svelte 파일만 포함하고, 때로는 여러 파일을 포함합니다. 각 폴더 내에는 컴포넌트를 내보내는 index.ts 파일이 있어 단일 파일에서 임포트할 수 있습니다.

예를 들어, Accordion 컴포넌트는 네 개의 .svelte 파일로 분리되어 있습니다:

  • accordion.svelte
  • accordion-content.svelte
  • accordion-item.svelte
  • accordion-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
  • 원격 또는 기존 컴포넌트 간편하게 검색