Next.js ページとルーティング

Next.js はファイルシステムルーティングを使用します。つまり、アプリ内のページはファイルシステムの構造によって自動的に決定され、各ファイルとフォルダーが1つのルートに対応します。従来の React ルーティングのように各パスを明示的に設定する必要がないため、開発プロセスがより直感的で簡単になります。

  • ページとルートの関係:Next.js では、各ページは app/ または pages/ ディレクトリ内のファイルから自動的に1つのルートにマッピングされ、各ファイルのパスとファイル名がそのページの URL を決定します。

  • 基本的なページ構造:Next.js では、ページとは app/ または pages/ ディレクトリ内の任意の .tsx または .js ファイルのことです。各ページファイルは自動的にアプリの1つのルートになります。

Next.js のルーティングシステムは非常に柔軟で、静的ページ、動的ルート、ネストされたルートをサポートしているため、開発者は複雑なアプリケーション構造を簡単に実装できます。

  • ファイルシステムルーティング:ページとルートはapp/ 或 pages/ディレクトリ内のファイル構造によって自動的にマッピングされます。
  • 動的ルート:角括弧([ ])を使用して動的ルートを作成し、URL内の動的パラメータを処理できます。
  • ネストされたルート:サブディレクトリを使用してネストされたルートを作成し、多階層のルート構造を実現できます。
  • ルートナビゲーション:使用するnext/linkコンポーネントでページ間のナビゲーションを実現します。

Next.js 13 は新しい app ディレクトリを導入しました。これは従来の pages ディレクトリと共存し、より柔軟なルートとレイアウトの構成方法を提供します。

プロジェクトのディレクトリ構造が次のようになっているとします:

app/
├── page.tsx             # 对应根路径 /
├── about/
│   └── page.tsx         # 对应 /about
├── [slug]/
│   └── page.tsx         # 对应动态路径,如 /[slug]
  • page.tsxファイル:各ページには1つのpage.tsxファイルがあり、そのファイルがそのルートに対応するコンポーネントの内容になります。
  • 動的ルート:ページパスに動的パラメータがある場合は、角括弧([ ])を使用して動的ルートを定義できます。例えば[slug]は、そのパスが任意の値を受け入れてslugパラメータとして扱うことを示します。

デフォルトのページとルート

Next.js は、app/ または pages/ フォルダ内のファイルに対してルートを自動的に作成します。

以下は一般的なルートの例です:

  • app/page.tsxの対応先は/パスです。
  • app/about/page.tsxの対応先は/aboutパスです。
  • app/[slug]/page.tsxの対応先は/[slug]、任意の URL パスに一致します。例えば/post/1 或 /product/xyz。

動的ルート

動的ルートを使用すると、URL内の異なる部分に基づいてページを動的にレンダリングできます。

Next.js では、角括弧付きのフォルダまたはファイルを作成することで動的ルートを実現できます。

例えば、異なる記事 ID に基づいて異なるコンテンツをレンダリングしたい場合は、次のようにします:

app/
├── [id]/
│   └── page.tsx        # 动态路由,匹配任何 `/[id]` 的路径

[id]は動的ルートのプレースホルダーであり、URL内の任意のidパラメータにマッチします。

動的ルートパラメータの取得

Next.js では、useParams フックを使用して動的ルートパラメータにアクセスできます。例:

例

'use client';

import { useParams } from 'next/navigation';

export default function Post() {
  const params = useParams();
  const { id } = params;  // 動的ルートパラメータ `id` を取得

  return <div>Post ID: {id}</div>;
}

ユーザーが /post/123 にアクセスすると、id が自動的に 123 に設定され、ページに表示されます。

ネストされたルート

Next.js はネストされたルートもサポートしています。つまり、特定のルートの下に子ルートを作成します。例:

app/
├── about/
│   ├── page.tsx          # /about 路由页面
│   ├── team/
│   │   └── page.tsx      # /about/team 子路由页面
│   └── contact/
│       └── page.tsx      # /about/contact 子路由页面

この方法により、アプリケーションは階層構造を持ちながら、URLパスの可読性を保つことができます。

カスタムルートルール

ルートの動作をカスタマイズしたい場合は、next.config.js ファイルを使用して設定できます。ただし、一般的なルートの要件のほとんどは、Next.js がすぐに使える機能として提供しているため、追加の設定は不要です。

特別なページとルート機能

  • _app.jsと_document.js:Next.js では、_app.jsはアプリケーションのルートコンポーネントであり、すべてのページに共通のレイアウトと状態を提供できます。_document.js主に HTML ドキュメントの構造を変更するために使用されます(例:headとbodyタグ)。
  • _error.js:エラーページをカスタマイズして、404 やその他の種類のエラーを処理できます。

例

静的ページの作成

簡単な静的ページの作成を例として、about/page.tsx ファイルを作成します。内容は次のとおりです:

例

export default function AboutPage() {
  return <h1>About Us</h1>;
}

/about パスにアクセスすると、Next.js が自動的にそのページをレンダリングします。

動的ルートの使用

記事 ID に基づいてページをレンダリングしたい場合、app/[id]/page.tsx ファイルを作成します。内容は次のとおりです:

例

import { useParams } from 'next/navigation';

export default function PostPage() {
  const { id } = useParams();

  return <h1>Post ID: {id}</h1>;
}

/123 にアクセスすると、Post ID: 123 と表示されます。

ルートナビゲーション

Next.js は next/link が提供するコンポーネントを使用してルートナビゲーションを行います。ページにリンクを追加して、他のページに移動できます。

例

import Link from 'next/link';

export default function HomePage() {
  return (
    <div>
      <h1>Welcome to Next.js!</h1>
      <Link href="/about">About Us</Link>
    </div>
  );
}

<Link />コンポーネントは、ページ間のナビゲーションに使用され、シングルページアプリケーション(SPA)の体験を維持します。

その他の拡張