@astrojs/ svelte
このAstroインテグレーションは、Svelte 5コンポーネントのレンダリングとクライアントサイドハイドレーションを有効にします。Svelte 3および4のサポートについては、代わりに@astrojs/svelte@5
をインストールしてください。
インストール
Section titled “インストール”Astroには、公式インテグレーションのセットアップを自動化するためのastro add
コマンドが含まれています。もしよろしければ、手動でインテグレーションをインストールできます。
@astrojs/svelte
をインストールするには、プロジェクトディレクトリから次のコマンドを実行し、プロンプトに従ってください。
npx astro add svelte
pnpm astro add svelte
yarn astro add svelte
問題が発生した場合は、GitHubで報告してください。そして、以下の手動インストール手順を試してください。
手動インストール
Section titled “手動インストール”まず、@astrojs/svelte
パッケージをインストールします。
npm install @astrojs/svelte
pnpm add @astrojs/svelte
yarn add @astrojs/svelte
ほとんどのパッケージマネージャーは、関連するピア依存関係もインストールします。Astroの起動時にCannot find package 'svelte'
(または同様の)警告が表示される場合は、SvelteとTypeScriptをインストールする必要があります。
npm install svelte typescript
pnpm add svelte typescript
yarn add svelte typescript
次に、integrations
プロパティを使用して、インテグレーションをastro.config.*
ファイルに適用します。
import { defineConfig } from 'astro/config';import svelte from '@astrojs/svelte';
export default defineConfig({ // ... integrations: [svelte()],});
そして、プロジェクトのルートディレクトリにsvelte.config.js
という新しいファイルを作成し、次のコードを追加します。
import { vitePreprocess } from '@astrojs/svelte';
export default { preprocess: vitePreprocess(),}
Astroで最初のSvelteコンポーネントを使用するには、UIフレームワークのドキュメントにアクセスしてください。以下について探求します。
- 📦 フレームワークコンポーネントがどのように読み込まれるか
- 💧 クライアントサイドハイドレーションのオプション
- 🤝 フレームワークを混在させてネストする機会
このインテグレーションは@sveltejs/vite-plugin-svelte
によって提供されています。Svelteコンパイラをカスタマイズするには、インテグレーションにオプションを指定できます。詳細については、@sveltejs/vite-plugin-svelte
のドキュメントを参照してください。
astro.config.mjs
のsvelte
インテグレーションに渡すか、svelte.config.js
でオプションを設定できます。両方が存在する場合、astro.config.mjs
のオプションがsvelte.config.js
のオプションよりも優先されます。
import { defineConfig } from 'astro/config';import svelte from '@astrojs/svelte';
export default defineConfig({ integrations: [svelte({ extensions: ['.svelte'] })],});
export default { extensions: ['.svelte'],};
Preprocessors
Section titled “Preprocessors”@astrojs/svelte@2.0.0
SvelteファイルでSCSSまたはStylusを使用している場合は、svelte.config.js
ファイルを作成して、Svelteによって前処理され、Svelte IDE拡張機能がSvelteファイルを正しく解析できます。
import { vitePreprocess } from '@astrojs/svelte';
export default { preprocess: vitePreprocess(),};
この設定ファイルは、astro add svelte
を実行すると自動的に追加されます。vitePreprocess
の詳細については、@sveltejs/vite-plugin-svelte
のドキュメントを参照してください。