ルーティング
Astroはファイルベースルーティングを使用して、プロジェクトのsrc/pages/ディレクトリのファイルレイアウトを元にビルドURLを生成します。
ページ間の移動
Section titled “ページ間の移動”Astroでは、ルート間の移動に標準的なHTMLの<a>要素を使用します。フレームワーク固有の<Link>コンポーネントは提供されていません。
<p>Astroの<a href="/about/">概要</a>についてもっと読む!</p>
<!-- `base: "/docs"`が設定されている場合 --><p><a href="/docs/reference/">リファレンス</a>セクションでもっと学びましょう!</p>静的ルーティング
Section titled “静的ルーティング”src/pages/ディレクトリにある.astroページコンポーネント、MarkdownとMDXファイル(.md、.mdx)は、自動的にウェブサイトのページとなります。各ページのルートは、src/pages/ディレクトリ内における自身のパスとファイル名に対応します。
# 静的ルーティングの例src/pages/index.astro -> mysite.com/src/pages/about.astro -> mysite.com/aboutsrc/pages/about/index.astro -> mysite.com/aboutsrc/pages/about/me.astro -> mysite.com/about/mesrc/pages/posts/1.md -> mysite.com/posts/1Astroのプロジェクトでは、別途「ルーティング設定」を管理する必要はありません。src/pages/ディレクトリにファイルを配置すると、新しいルートが自動的に作成されます。静的ビルドでは、build.format (EN)設定オプションを使用してファイルの出力形式をカスタマイズできます。
動的ルーティング
Section titled “動的ルーティング”Astroページファイルのファイル名に動的ルートパラメータを指定すると、ファイルにマッチするページを複数生成できます。たとえばsrc/pages/authors/[author].astroは、ブログの各著者に対してプロフィールページを生成します。authorは、ページ内からアクセス可能なパラメータとなります。
Astroのデフォルトの静的出力モードでは、これらのページはビルド時に生成されるため、authorと対応するファイルを取得する場合、それらのリストを事前に決めておく必要があります。SSRモードでは、ルートにマッチしたリクエストに応じてページが生成されます。
静的(SSG)モード
Section titled “静的(SSG)モード”すべてのルートをビルド時に決める必要があるため、動的ルートはgetStaticPaths()をエクスポートし、そこでparamsプロパティをもつオブジェクトの配列を返す必要があります。各オブジェクトは対応するルートを生成します。
[dog].astroはファイル名に動的なdogパラメータが定義されているため、getStaticPaths()から返されるオブジェクトのparamsにはdogを含める必要があります。Astro.paramsを使用してページからこのパラメータにアクセスできます。
---export function getStaticPaths() { return [ {params: {dog: 'clifford'}}, {params: {dog: 'rover'}}, {params: {dog: 'spot'}}, ];}
const { dog } = Astro.params;---<div>いい子だ、{dog}!</div>上のコードにより、/dogs/clifford、/dogs/rover、/dogs/spotという3つのページが生成され、各ページでは対応する犬の名前が表示されます。
ファイル名には複数のパラメータを含められますが、これらをすべてgetStaticPaths()のparamsオブジェクトに含める必要があります。
---export function getStaticPaths () { return [ {params: {lang: 'en', version: 'v1'}}, {params: {lang: 'fr', version: 'v2'}}, ];}
const { lang, version } = Astro.params;---上のコードは/en-v1/infoと/fr-v2/infoを生成します。
パラメータはパス内の異なる部分に設定できます。たとえば、上と同じgetStaticPaths()をもつsrc/pages/[lang]/[version]/info.astroファイルは、/en/v1/infoと/fr/v2/infoのルートを生成します。
paramsのデコード
Section titled “paramsのデコード”getStaticPaths()関数が返すparamsはデコードされません。パラメータ値をデコードする必要がある場合は、decodeURI()を使用してください。
---export function getStaticPaths() { return [ { params: { slug: decodeURI("%5Bpage%5D") }}, // "[page]"にデコードされます ]}---getStaticPaths (EN)についてもっと詳しく見る。
レストパラメーター
Section titled “レストパラメーター”より柔軟なURLルーティングが必要な場合は、.astroファイル名にレストパラメータ([...path])を使用することで、任意の深さのファイルパスにマッチさせられます。
---export function getStaticPaths() { return [ {params: {path: 'one/two/three'}}, {params: {path: 'four'}}, {params: {path: undefined }} ]}
const { path } = Astro.params;---上のコードは/sequences/one/two/three、/sequences/four、/sequencesを生成します。(レストパラメータをundefinedに設定することで、トップレベルのページにマッチさせられます。)
レストパラメータは他の名前付きパラメータと組み合わせて使用できます。たとえば、GitHubのファイルビューアは以下の動的ルートで表現できます。
/[org]/[repo]/tree/[branch]/[...file]この例では、/withastro/astro/tree/main/docs/public/favicon.svgへのリクエストは、以下の名前付きパラメータへと分割されます。
{ org: 'withastro', repo: 'astro', branch: 'main', file: 'docs/public/favicon.svg'}複数レベルの動的ページの例
Section titled “複数レベルの動的ページの例”以下の例は、レストパラメータ([...slug])とgetStaticPaths()のprops (EN)機能を使用して、異なる深さのスラグに対してページを生成します。
---export function getStaticPaths() { const pages = [ { slug: undefined, title: "Astroストア", text: "Astroストアにようこそ!", }, { slug: "products", title: "Astroグッズ", text: "たくさんの商品があります", }, { slug: "products/astro-handbook", title: "究極のAstroハンドブック", text: "Astroについて学びたければ、この本を読む必要があります", }, ]; return pages.map(({ slug, title, text }) => { return { params: { slug }, props: { title, text }, }; });}
const { title, text } = Astro.props;---<html> <head> <title>{title}</title> </head> <body> <h1>{title}</h1> <p>{text}</p> </body></html>