Next.jsで学ぶReact講座 90日コース | Next.js基礎 - Day 43:Loading UI

React Next.jsで学ぶReact講座90日コース
スポンサーリンク
スポンサーリンク

Day 43:Loading UIを実装して、待ち時間の見え方を改善する

Day 43では、Next.js App RouterのLoading UIを学びます。今日は、loading.tsxとSuspenseを使って、「データを待っている間に何を表示するか」を設計し、実際にローディング画面を実装します。Next.jsでは、同じフォルダーにloading.tsxを置くと、そのルートセグメントに対する即時ローディングUIを作れます。また、loading.tsxは内部的にSuspenseの仕組みを使って動きます。 (🔗 nextjs.org)

初心者がまず理解すべき大事な点は、loading.tsxはページ全体寄りのローディング、Suspenseは部品ごとの細かいローディングに向いている、ということです。Next.js公式も、loading.jsはルートセグメント全体のストリーミングに便利であり、実行時データや未キャッシュデータの近くでは<Suspense>を使うことが推奨されると説明しています。 (🔗 nextjs.org)

Day 43で学ぶこと

  • `loading.tsx`が何をする特別なファイルなのかを理解します。
  • `Suspense`が何をする仕組みなのかを理解します。
  • ページ全体のローディングと、部品単位のローディングの違いを理解します。
  • 実際に`loading.tsx`を作って、ページ遷移時のローディング画面を実装します。
  • `Suspense`で一部の部品だけ先に待たせる書き方を学びます。

まず理解したいこと

ローディングUIは、単に「くるくる回る表示」を出すことではありません。利用者に対して、今ちゃんと動いている、少し待てば表示される、画面が止まったわけではないと伝えるための大切な仕組みです。

Next.jsでは、ページ移動やデータ取得の待ち時間を改善する方法として、主に次の2つがあります。

  • `loading.tsx`を置いて、そのルートセグメント全体のローディングを表示する方法です。
  • “で特定のコンポーネントだけを囲み、その部分だけローディング表示を出す方法です。

この2つは似ていますが、使いどころが違います。

loading.tsxとは

loading.tsxは、Next.js App Routerの特別なファイルです。同じフォルダーに置くと、そのルートセグメントに対して意味のあるローディングUIを作れます。新しい画面の内容が準備できるまで、先にローディング表示を見せ、その後で本来の内容へ自動的に切り替わります。 (🔗 nextjs.org)

最小例は次の通りです。

// 読み込み中に表示するローディングUIです
export default function Loading() {
  // 軽量な表示を返します
  return <p>Loading...</p>;
}
TSX

loading.tsxは、引数を受け取りません。また、既定ではServer Componentですが、必要なら"use client"を付けてClient Componentとしても使えます。 (🔗 nextjs.org)

Suspenseとは

SuspenseはReactの仕組みで、まだ準備できていないUIの代わりにfallbackを表示するための境界です。childrenが待機中ならfallbackを表示し、準備ができたら本来のUIへ切り替えます。 (🔗 react.dev)

基本形は次の通りです。

import { Suspense } from "react";

// Suspenseで囲んだ中身が待機中ならfallbackを表示します
<Suspense fallback={<p>読み込み中です...</p>}>
  <SomeAsyncComponent />
</Suspense>
TSX

React公式では、fallbackには軽量なプレースホルダー、スピナー、スケルトンなどを置くのが一般的だと説明されています。 (🔗 react.dev)

loading.tsxとSuspenseの関係

ここは非常に重要です。Next.jsのloading.tsxは、裏側でSuspenseを使っています。公式ドキュメントでは、loading.jsは同じセグメントのlayout.jsの中にネストされ、page.jsとその配下を自動的に<Suspense>境界で包むと説明されています。 (🔗 nextjs.org)

つまり、理解としては次のようになります。

  • `loading.tsx`は、Next.jsが用意してくれる「自動のSuspense」です。
  • `Suspense`は、自分で細かく場所を決めて使うものです。

今日作る実践の完成イメージ

今回は、Day 42で学んだデータ取得ページをもとにして、/postsページにローディングUIを付けます。さらに、ページ全体ではなく「記事一覧の部分だけ」をSuspenseで待たせる例も作ります。

ファイル構成は次のようにします。

src/
├── app/
│   ├── posts/
│   │   ├── loading.tsx
│   │   ├── page.tsx
│   │   └── PostsList.tsx
│   ├── globals.css
│   ├── layout.tsx
│   └── page.tsx
└── lib/
    └── posts.ts

この構成で、まずはloading.tsxによるページ全体のローディングを作り、そのあとSuspenseで部品単位のローディングへ発展させます。

Step 1:外部APIから記事一覧を取得する関数を用意する

まず、Day 42の復習としてデータ取得関数を用意します。

src/lib/posts.ts

// 記事1件分の型です
export type Post = {
  id: string;
  title: string;
};

// 外部APIから記事一覧を取得する関数です
export async function getPosts(): Promise<Post[]> {
  // 外部APIへアクセスします
  const response = await fetch("https://api.vercel.app/blog", {
    // 毎回最新データを取り直します
    cache: "no-store",
  });

  // 通信結果が失敗ならエラーにします
  if (!response.ok) {
    throw new Error("記事データの取得に失敗しました。");
  }

  // JSONを返します
  return response.json();
}
TypeScript

この取得関数自体はDay 42と同じ考え方です。cache: "no-store"を付けると毎回取得し直すため、ローディング表示を確認しやすくなります。fetchのキャッシュ設定はNext.js独自の拡張で、no-storeは毎回リモートサーバーから取り直す指定です。 (🔗 nextjs.org)

Step 2:まずは通常のページを作る

次に、記事一覧を表示するページを作ります。

src/app/posts/page.tsx

// データ取得関数を読み込みます
import { getPosts } from "../../lib/posts";

// 記事一覧ページです
export default async function PostsPage() {
  // サーバー側で記事データを取得します
  const posts = await getPosts();

  return (
    <main>
      <h1>記事一覧</h1>
      <p>外部APIから取得した記事を表示します。</p>

      <ul>
        {posts.map((post) => (
          // 各記事のidをkeyに使います
          <li key={post.id}>{post.title}</li>
        ))}
      </ul>
    </main>
  );
}
TSX

この時点では、ローディングUIはまだありません。通信が完了するまで、表示の切り替えが分かりにくい状態です。

Step 3:loading.tsxを追加する

ここで、同じpostsフォルダーにloading.tsxを置きます。

src/app/posts/loading.tsx

// 記事一覧ページの読み込み中に表示するUIです
export default function Loading() {
  return (
    <main>
      <h1>記事一覧</h1>
      <p>記事データを読み込んでいます...</p>

      <ul>
        {/* スケルトン風のダミー項目です */}
        <li>読み込み中の記事 1...</li>
        <li>読み込み中の記事 2...</li>
        <li>読み込み中の記事 3...</li>
      </ul>
    </main>
  );
}
TSX

これだけで、/postsへ移動したときに、先にこのローディングUIが表示されるようになります。loading.tsxはルートセグメントの即時ローディング状態を作るための特別ファイルで、ナビゲーション時にすぐ見せられるように設計されています。 (🔗 nextjs.org)

Step 4:なぜloading.tsxは便利なのか

loading.tsxの便利な点は、自分でSuspenseを書かなくても、そのページや子ルートに対してローディング境界を作ってくれるところです。

特に次の性質は重要です。

  • ローディングUIは事前取得されるため、移動が即時に感じやすくなります。
  • ナビゲーションは中断可能で、読み込み完了まで待たずに別ページへ移動できます。
  • 共有レイアウトは新しいセグメントの読み込み中も操作可能なまま保たれます。

初心者向けに言い換えると、画面全体が固まって見えにくくなり、待ち時間の体験が良くなるということです。

Step 5:Suspenseで一部分だけを待たせる設計を学ぶ

ここからがDay 43の後半です。loading.tsxは便利ですが、ページ全部を同じように待たせる設計になります。実務では、「見出しや説明はすぐ出したい」「重い一覧だけ後から出したい」という場面が多くあります。

そのときはSuspenseを使います。Next.js公式でも、loading.jsでルートセグメント全体をストリーミングする方法と、<Suspense>でコンポーネント単位にストリーミングする方法の2つが案内されています。 (🔗 nextjs.org)

Step 6:記事一覧部分を別コンポーネントへ分ける

まず、一覧表示だけを別ファイルへ分けます。

src/app/posts/PostsList.tsx

// データ取得関数を読み込みます
import { getPosts } from "../../lib/posts";

// 記事一覧だけを表示する非同期コンポーネントです
export default async function PostsList() {
  // 記事一覧を取得します
  const posts = await getPosts();

  return (
    <ul>
      {posts.map((post) => (
        // 各記事のidをkeyに使います
        <li key={post.id}>{post.title}</li>
      ))}
    </ul>
  );
}
TSX

このPostsListもServer Componentで、しかもasyncです。App RouterではServer Componentを非同期関数にできるため、このような分割が自然にできます。 (🔗 nextjs.org)

Step 7:ページ側でSuspenseを使う

次に、ページ本体でPostsListをSuspenseで囲みます。

src/app/posts/page.tsx

// ReactのSuspenseを読み込みます
import { Suspense } from "react";

// 記事一覧コンポーネントを読み込みます
import PostsList from "./PostsList";

// 記事一覧ページです
export default function PostsPage() {
  return (
    <main>
      <h1>記事一覧</h1>
      <p>
        このページでは、見出しや説明は先に表示し、
        記事一覧だけをあとから読み込みます。
      </p>

      {/* 一覧部分だけをローディング表示付きで待たせます */}
      <Suspense fallback={<p>記事一覧を読み込んでいます...</p>}>
        <PostsList />
      </Suspense>
    </main>
  );
}
TSX

この書き方をすると、ページ全体ではなく**PostsListの部分だけ**が読み込み中表示になります。ReactのSuspenseは、囲まれた子UIが待機中のあいだfallbackを表示し、準備後に本来のUIへ切り替えます。 (🔗 react.dev)

Step 8:loading.tsxとSuspenseの使い分けを整理する

ここをあいまいにすると、後で混乱しやすいです。整理すると次のようになります。

  • `loading.tsx`は、そのフォルダーのページや子要素に対するルート単位のローディングです。
  • `Suspense`は、その中で囲んだ部品だけに対する部分的なローディングです。
  • ページ遷移直後に即時表示したいなら`loading.tsx`が分かりやすいです。
  • 重いデータ取得が一部だけにあるなら、その近くを`Suspense`で囲むほうが柔軟です。Next.js公式も、未キャッシュや実行時データに近い場所では“を使うことを勧めています。

Step 9:スケルトンUIにして見やすくする

文字だけの「読み込み中です…」でも動きますが、実務ではスケルトンUIのほうが分かりやすいことが多いです。loading.tsxにもSuspenseのfallbackにも、軽量なスケルトンを置けます。公式でも、ローディングUIとしてスケルトンやスピナー、小さくても意味のある将来画面の一部を使うことが推奨されています。 (🔗 nextjs.org)

src/app/posts/loading.tsx の改善例

// 記事一覧ページのスケルトン表示です
export default function Loading() {
  return (
    <main>
      <h1>記事一覧</h1>
      <p>記事データを読み込んでいます...</p>

      <ul>
        {/* 実際の内容に近い形でダミーを出します */}
        <li className="skeleton-item">..........</li>
        <li className="skeleton-item">..........</li>
        <li className="skeleton-item">..........</li>
      </ul>
    </main>
  );
}
TSX

src/app/globals.css に追加

/* スケルトンの見た目を作ります */
.skeleton-item {
  margin: 12px 0;
  padding: 12px;
  color: transparent;
  background: linear-gradient(
    90deg,
    #e5e7eb 25%,
    #f3f4f6 50%,
    #e5e7eb 75%
  );
  border-radius: 8px;
}

ローディングUIは派手である必要はありません。むしろ、軽くて、すぐ出て、画面の構造が予想できることが大切です。 (🔗 nextjs.org)

Step 10:loading.tsxだけで十分な場合

次のようなページなら、まずloading.tsxだけで十分です。

  • ページ全体が同じデータ取得を待つページです。
  • 「ページ丸ごと切り替わる」体験で問題ないページです。
  • 学習初期で、まずシンプルにローディングを導入したいページです。

たとえば、単純な一覧ページ、単純な詳細ページでは、loading.tsxから始めると理解しやすいです。

Step 11:Suspenseを使うべき場面

次のようなページでは、Suspenseが特に役立ちます。

  • 上部の説明はすぐ表示し、一覧だけ後から出したいページです。
  • 複数の非同期部品を別々に待たせたいページです。公式でも複数の`Suspense`境界で別々の読み込みUIを出す例があります。
  • 未キャッシュや実行時データの取得箇所を細かく囲みたいページです。

たとえば、ニュース一覧と天気情報を別々に表示するなら、それぞれ別のSuspenseで囲むと、片方が遅くてももう片方は先に表示できます。これは体験の改善に非常に効果的です。 (🔗 nextjs.org)

Step 12:layoutでの注意点

これは少し重要な注意です。Next.js公式では、同じルートセグメントのlayoutが未キャッシュデータや実行時データに依存している場合、そのloading.tsxではフォールバックできず、ナビゲーションをブロックすることがあると説明しています。そういう場合は、その未キャッシュアクセスを専用の<Suspense>で囲むか、取得場所をpage.js側へ移すのが解決策です。 (🔗 nextjs.org)

初心者向けに言い換えると、次のようになります。

  • 「同じフォルダーに`loading.tsx`を置いたのに思ったように効かない」ときがあります。
  • 原因が`layout`側の重い処理である場合、`loading.tsx`だけでは助けられないことがあります。
  • そのときは、重い部分の近くを`Suspense`で囲む設計を考えます。 ([nextjs.org](https://nextjs.org/docs/app/getting-started/fetching-data))

これは実務でかなり大切です。

Step 13:よくあるつまずき

  • `loading.tsx`を置いたのに何も変わらない:ファイル名と場所を確認します。同じセグメントのフォルダーに置く必要があります。
  • `loading.tsx`で重すぎるUIを作ってしまう:ローディングUIは軽量であることが大切です。公式でも軽いfallback UIが想定されています。
  • 全部を1つの`Suspense`で囲ってしまう:細かく分けたほうが表示体験が良くなることがあります。
  • `Suspense`は何でも待てると思っている:React公式では、Effectやイベントハンドラ内で始めたデータ取得を`Suspense`が自動検知するわけではないと説明されています。
  • `loading.tsx`と`Suspense`の違いがあいまい:ルート単位か、部品単位かで考えると整理しやすいです。

Step 14:初心者向けテンプレート

まずは、次の3つを覚えると応用しやすいです。

loading.tsxテンプレート

// ルートセグメントのローディングUIです
export default function Loading() {
  return (
    <div>
      <p>読み込み中です...</p>
    </div>
  );
}
TSX

Suspenseテンプレート

// ReactのSuspenseを読み込みます
import { Suspense } from "react";

// 非同期コンポーネントを囲む例です
<Suspense fallback={<p>データを読み込んでいます...</p>}>
  <AsyncSection />
</Suspense>
TSX

非同期コンポーネントテンプレート

// 非同期でデータを取得するServer Componentです
export default async function AsyncSection() {
  // データ取得処理です
  const response = await fetch("https://api.vercel.app/blog", {
    cache: "no-store",
  });

  // 結果をJSONへ変換します
  const data = await response.json();

  return (
    <ul>
      {data.map((item: { id: string; title: string }) => (
        <li key={item.id}>{item.title}</li>
      ))}
    </ul>
  );
}
TSX

Day 43のチェックリスト

  • `loading.tsx`がルートセグメント用の特別ファイルだと説明できます。
  • `loading.tsx`が内部的に`Suspense`ベースで動くと説明できます。
  • `Suspense`が待機中に`fallback`を表示する仕組みだと説明できます。
  • ページ全体のローディングには`loading.tsx`、部分的なローディングには`Suspense`を使い分けられます。
  • 軽量なローディングUIやスケルトンを作れます。
  • `layout`側の未キャッシュ処理では、`loading.tsx`だけでは不十分な場合があると理解しています。

まとめ

Day 43では、Next.jsのLoading UIとしてloading.tsxとSuspenseを学びました。loading.tsxはルートセグメント単位の即時ローディングUIを作る特別ファイルで、内部的にはSuspense境界として働きます。一方でSuspenseは、ページの中の特定の重い部品だけを待たせたいときに使います。 (🔗 nextjs.org)

実践では、まず/postsにloading.tsxを追加し、その後で記事一覧だけをSuspenseで囲う構成に発展させました。これで、「ページ全体のローディング」と「部分的なローディング」の両方を自分で設計できる土台ができました。次の学習では、error.tsxやnot-found.tsxと組み合わせて、待機中だけでなく失敗時や未存在時の画面も整えていくと、より実践的なNext.jsアプリになります。

タイトルとURLをコピーしました