コンテンツにスキップ
svelte-zukan
Esc
↑↓移動↵開く⌘Jプレビュー
このページの内容

クイックスタート

svelte-zukan は素の Vite + Svelte でも SvelteKit 3 以上でも動きます。Vite 8 以上、Svelte 5.57.1 以上、Node 22.17 以上が必要です。Vite 専用のフック(configureServer、hotUpdate、buildApp)を使うため、Vite 以外のバンドラーでは動きません。

AI のコーディングエージェントを使っているなら、npx skills add oekazuma/svelte-zukan でエージェントスキルを入れて、svelte-zukan の導入を頼めます。エージェントはこのページの手順に沿って、プロジェクトに合ったオプションを選び、カタログファイルと説明を書きます。

インストール

npm install -D svelte-zukan
pnpm add -D svelte-zukan
yarn add -D svelte-zukan

プラグインを追加する

zukan() は sveltekit() や svelte() より前に置きます。

// vite.config.ts
import { sveltekit } from '@sveltejs/kit/vite';
import { defineConfig } from 'vite';
import { zukan } from 'svelte-zukan/vite';

export default defineConfig({ plugins: [zukan(), sveltekit()] });
// vite.config.ts
import { svelte } from '@sveltejs/vite-plugin-svelte';
import { defineConfig } from 'vite';
import { zukan } from 'svelte-zukan/vite';

export default defineConfig({ plugins: [zukan(), svelte()] });

カタログファイルを書く

コンポーネントの隣に <Name>.zukan.svelte を置き、例ごとに <Section> で囲みます。

<!-- src/lib/Button/Button.zukan.svelte -->
<script lang="ts">
  import { Section } from 'svelte-zukan';
  import Button from './Button.svelte';
</script>

<Section title="Basic">
  <Button>Click me</Button>
</Section>

<Section title="Disabled">
  <Button disabled>Disabled</Button>
</Section>

カタログを開く

dev サーバーを起動して /__zukan/ を開きます。起動時にターミナルへ出る URL 一覧にも、カタログの URL が載ります。

Vite の base や SvelteKit の paths.base を設定しているときは、カタログはその下に移ります。base: '/app/' でも paths.base: '/app' でも /app/__zukan/ です。

トップページには、すべてのコンポーネントが小さなプレビュー付きで並びます。詳細ページには、各セクションのプレビューと、幅・背景・計測・アクセシビリティ検査のツールバー、各セクションのコード、コンポーネントの props が並びます。どれもカタログの使い方でキーボードショートカットとあわせて説明しています。

次のステップ