Astro は何をしますか?
概要
Astroは、デフォルトでゼロJavaScriptを配信する、コンテンツ駆動型Webサイトを構築するためのWebフレームワークです。アイランドアーキテクチャによりインタラクティブなコンポーネントのみをハイドレートし、React、Vue、Svelteなど、インタラクティブ性が必要な場所で任意のUIフレームワークをサポートしながら、優れたLighthouseスコアを実現します。
使用方法
- ページを作成する際は、
src/pages/内で.astro、.md、.mdxファイルを使用したファイルベースルーティングを使用し、共有構造はsrc/layouts/に整理します。 - インタラクティブ性を追加する際は、フレームワークコンポーネントにクライアントディレクティブを使用します。ほとんどのコンポーネントは即時ハイドレーションを必要としないため、
client:loadよりもclient:visibleまたはclient:idleを優先します。 - コンテンツを管理する際は、
defineCollection()を使用して厳格なZodスキーマを持つContent Collectionsをsrc/content/に定義し、getCollection()とgetEntry()でクエリを実行します。 - レンダリングモードを選択する際は、マーケティングページやコンテンツページにはデフォルトで静的(SSG)を選択し、動的ページには
output: "server"を使用するか、ページごとにexport const prerender = falseを使用したハイブリッドレンダリングを使用します。 - 画像を最適化する際は、生の
<img>タグの代わりにastro:assetsの<Image>コンポーネントを使用して、自動フォーマット変換(WebP/AVIF)、リサイズ、遅延ロードを行います。 - ページトランジションを追加する際は、
<ViewTransitions />を使用して、クライアントサイドルーターを配信せずにSPAのようなナビゲーションを実現します。 - UIフレームワークを統合する際は、適切な統合パッケージ(
@astrojs/react、@astrojs/vue、@astrojs/svelte)をインストールし、静的なコンテンツにはAstroコンポーネントを使用し、インタラクティブ性が必要な場合にのみフレームワークコンポーネントを使用します。
サンプル
サンプル1: Content Collectionsを使ったブログ構築
ユーザーリクエスト: 「型安全なMarkdownコンテンツを持つAstroブログを作成する」
アクション:
- フロントマター(タイトル、日付、タグ、作成者)用のZodスキーマを持つブログContent Collectionを定義します。
getStaticPaths()を使用して動的ルートsrc/pages/blog/[slug].astroを作成します。- ソートを適用して
getCollection("blog")をクエリするブログインデックスページを構築します。 - SEOメタタグ、ナビゲーション、View Transitionsを備えたレイアウトを追加します。
出力: 検証済みコンテンツ、クリーンなURL、スムーズなページトランジションを備えた静的に生成されたブログ。
サンプル2: 静的サイトへのインタラクティブコンポーネントの追加
ユーザーリクエスト: 「AstroのドキュメントサイトにReact検索コンポーネントを追加する」
アクション:
@astrojs/react統合パッケージをインストールします。- 状態とイベント処理を備えたReact検索コンポーネントを作成します。
client:idleディレクティブを付けてコンポーネントをページに追加します。- Astroページのフロントマターから静的なデータをプロパティとして渡します。
出力: インタラクティブな検索アイランド部分を除いて完全に静的なドキュメントサイト。
ガイドライン
- 静的なコンテンツにはAstroコンポーネント(
.astro)を使用し、インタラクティブ性が必要な場合にのみReact/Vue/Svelteを使用します。 - ハイドレーションディレクティブは、
client:loadよりもclient:visibleまたはclient:idleをデフォルトとします。 - 厳格なZodスキーマを持つContent Collectionsを定義して、ビルド時にコンテンツのエラーを検出します。
- 自動最適化のために、生の
<img>タグの代わりにastro:assetsの<Image>を使用します。 - 共有の
<head>、ナビゲーション、フッターを持つ薄いレイアウトを維持し、ページ固有のコンテンツはページ自体に配置します。 - ハイブリッドレンダリングを使用します。マーケティングページには静的、パーソナライズされたページや動的ページにのみSSRを使用します。
- ルーターを配信せずにSPAのようなナビゲーションを実現するために、View Transitionsを有効にします。