Next.js の loading.tsx:ローディング画面、スケルトン、Suspense

公開日: 2026年10月8日 · 読了目安 10 分

Next.js App Router の loading.tsx の動き、Suspense を使う場面、スケルトンとスピナーのコード、表示されない理由、スプラッシュ画面まで。

ルートのフォルダに loading.tsx を置くと、そのセグメントの中身を読み込んでいるあいだ、Next.js がこの画面を出します。React の Suspense の上にできていて、layout.js の内側から page.js とその下の子を包みます。既定ではサーバーコンポーネントです。

app/blog/loading.tsx
export default function Loading() {
  return <p>Loading...</p>
}

loading.tsx はどこに置いて、いつ表示されますか?

カバーしたいルートのフォルダに、page.tsx と並べて置きます。app/blog/page.tsx を待つあいだ出すなら、ファイルは app/blog/loading.tsx です。拡張子は .js、.jsx、.tsx のどれでも同じです。公式の説明は loading.js にあります。

Next.js はこのファイルを layout.js の内側に置き、page.js とそのフォルダより下のルートを Suspense の境界で包みます。ページを移動すると、レイアウトとこの画面が先に出て、ページの描画が終わると中身に入れ替わります。待ちがなければ、描画はすぐ終わるので、画面はほとんど見えずに切り替わります。フォールバックは先読みされるので、先読みが済んだルートへの移動はすぐ完了します。

現行の loading.js のページでは、この境界は not-found.js と、さらに下の layout.js も包むと書かれています。同じセグメントの layout.js、template.js、error.js は包みません。共有レイアウトは、新しいセグメントの読み込み中も操作できます。移動先の中身が揃う前に、別のルートへ移ることもできます。

引数は受け取れません。loading は Next.js 13.0.0 で入りました。この記事のコードは Next.js 15 の App Router 向けです。このサイトの依存は next 15.5.27 です。そのバージョンでは動的ルートの params が Promise なので、あとの商品ページでは await しています。

loading.tsx と Suspense はどちらを使いますか?

ページ全体を待たせるなら loading.tsx、遅い部品が1つなら Suspense です。

loading.tsx

Suspense

範囲

セグメント全体(そのフォルダの page.tsx と、その下のルート)

1つの部品

足し方

ルートのフォルダにファイルを置く

遅い部品を包む

向いている場面

データが揃うまで、ページに出せるものがない

残りのページを出したまま、1か所だけ待つ

ストリーミングのガイド でも、loading.js はデータなしでは何も描けないページ向け、Suspense はほとんどのページで範囲を細かく切るときに使う、と分かれています。loading.js のフォールバックは先読みされ、移動ですぐ出ます。自分で書いた Suspense は、既定では先読みされません。同じガイドは、遅いデータに近い Suspense を優先するよう勧めています。ツリーの上の方にある loading.tsx も境界としては有効ですが、ページ全体がスケルトンに落ちます。

ページの一部だけ待つなら Suspense で包む

ページ全体ではなく、レビューの欄だけが遅い場合もあります。そのときは、遅い部品だけを Suspense で包みます。

見出しや商品の説明は先に表示され、レビューの欄だけがスケルトンになります。

包んだ部品が中断(suspend)する必要があります。データを await する非同期のサーバーコンポーネントなら、フォールバックが出たまま待てます。描画が終わったあとにブラウザで取りにいく処理は、このフォールバックを引き留めません。

app/products/[id]/page.tsx
import { Suspense } from "react";
import { Reviews } from "./Reviews";
import { ReviewsSkeleton } from "./ReviewsSkeleton";

export default async function ProductPage({
  params,
}: {
  params: Promise<{ id: string }>;
}) {
  const { id } = await params;

  return (
    <main className="mx-auto max-w-5xl px-6 py-16">
      <h1 className="text-3xl font-semibold">商品の詳細</h1>
      <p className="mt-4 text-zinc-600">ここに商品の説明が入ります。</p>
      <Suspense fallback={<ReviewsSkeleton />}>
        <Reviews productId={id} />
      </Suspense>
    </main>
  );
}

loading.tsx が表示されないのはなぜですか?

次のどれかは、現行の App Router のドキュメントで確認できます。

  • ページに待つ処理がない。描画が終わるとフォールバックは入れ替わる。先読みが済んでいると、移動は完成したページへすぐ進む

  • データをブラウザで取っている。loading.tsx が包むのはサーバーでの描画で、SWR や React Query の Client Component はページが出たあとに自分の isLoading を描く(データの取得)

  • ファイルが別のセグメントにある。包むのは、そのフォルダの page.tsx と、その下のルートだけ

  • 遅い処理が同じフォルダの layout.tsx にある。loading.tsx はその layout の内側なので、layout の待ちは包まない。現行の loading.js では、layout が cookies() や headers()、キャッシュされない取得に触れると、同じセグメントの loading.js はそこへフォールバックしない。Cache Components を使わない場合、移動はその layout が終わるまで待つ。Next.js 15.5.27 は Cache Components を既定では有効にしない

  • 静的エクスポートでは未対応。loading.js の対応表で、Static export は No になっている

ローディング画面は、いつ出して、いつ出さない方がよいですか?

ローディング画面の役目は、待ち時間に「ちゃんと動いている」と伝えることです。待ち時間がないのに出すと、ただの足止めになります。

出す場面は、主に次の3つです。

  • データの取得に時間がかかるページへ移動するとき

  • フォームの送信など、押したあとに結果を待つとき

  • ブランドサイトで、最初の1回だけ演出として見せるとき

すぐ表示できるページを、演出のためだけに数秒隠すのは避けます。読者は中身を見に来ているので、待たせた時間はそのまま負担になります。演出としてのローディング画面は、ポートフォリオやブランドサイトに限って考えるのが安全です。資料請求や購入が目的の LP では、まず中身を見せてください。

この記事で分かることは次のとおりです。

  • loading.tsx を置く場所と、表示されるタイミング

  • loading.tsx と Suspense の使い分け

  • 表示されないときに、ドキュメントで確認できる原因

  • スケルトンとスピナーの使い分け

  • 初回だけ出る全画面のオープニングと、Motion でのフェードアウト

  • 表示速度の指標(LCP)を落とさないための注意点

Next.js でローディング画面を作る方法は何ですか?

目的によって、作る場所が変わります。

  • Step1: loading.tsx で、ページ移動中にスケルトンを出す

  • Step2: ボタンや一部の領域に、スピナーやスケルトンを出す

  • Step3: 初回だけ全画面のオープニングを出し、フェードアウトさせる

多くのサイトは、Step1 と Step2 で足ります。Step3 は、演出そのものがブランドの一部になる場合だけ足してください。

Step1:loading.tsx でスケルトンを出すには?

上の3行が、ドキュメントにある最小の形です。一覧のように形が決まっているページでは、これから出るカードと同じ並びのスケルトンにします。

app/products/loading.tsx
export default function Loading() {
  return (
    <div role="status" className="mx-auto max-w-5xl px-6 py-16">
      <span className="sr-only">商品を読み込んでいます</span>
      <div className="h-8 w-48 animate-pulse rounded-md bg-zinc-200 motion-reduce:animate-none" />
      <div className="mt-8 grid gap-6 sm:grid-cols-2 lg:grid-cols-3">
        {Array.from({ length: 6 }).map((_, i) => (
          <div key={i} className="space-y-3">
            <div className="aspect-[4/3] animate-pulse rounded-xl bg-zinc-200 motion-reduce:animate-none" />
            <div className="h-4 w-3/4 animate-pulse rounded bg-zinc-200 motion-reduce:animate-none" />
            <div className="h-4 w-1/2 animate-pulse rounded bg-zinc-200 motion-reduce:animate-none" />
          </div>
        ))}
      </div>
    </div>
  );
}

コードのポイント

  • role="status" と見えないテキストで、読み上げソフトにも読み込み中だと伝える

  • 本物のカードと同じ並びにして、切り替わったときのずれを小さくする

  • 点滅(animate-pulse)は、動きを減らす設定のときに止める

  • 既定でサーバーコンポーネントなので、"use client" は要らない

Step2:スケルトンとスピナーはどちらを使いますか?

待っている間の見せ方は、スケルトンとスピナーの2種類が基本です。

  • スケルトン:これから出る中身の形を、灰色の箱で先に見せる。一覧やカードなど、形が決まっているものに向く

  • スピナー:回る印で、処理中であることだけを伝える。ボタンの送信など、短くて形のない待ちに向く

ページ全体を中央のスピナーだけにすると、何が出てくるのか分かりません。形が分かるものは、スケルトンにしてください。

components/SubmitButton.tsx
"use client";

import { useFormStatus } from "react-dom";

export function SubmitButton() {
  const { pending } = useFormStatus();

  return (
    <button
      type="submit"
      disabled={pending}
      className="inline-flex min-h-11 items-center gap-2 rounded-lg bg-zinc-900 px-5 text-sm font-medium text-white disabled:opacity-70"
    >
      {pending && (
        <span
          aria-hidden="true"
          className="size-4 animate-spin rounded-full border-2 border-white/40 border-t-white motion-reduce:animate-none"
        />
      )}
      {pending ? "送信中…" : "送信する"}
    </button>
  );
}

送信ボタンにスピナーを出すときのポイント

useFormStatus は、親の form が送信中かどうかを教えてくれる React の機能です。form の中に描画される部品から呼び、form の action と組み合わせて使います。

送信中はボタンを押せなくして、二重送信を防ぎます。文字も「送信中…」に変えると、回る印が見えない人にも伝わります。

Step3:オープニングをセッションで1回だけ出すには?

ブランドサイトでは、ロゴが現れてから中身に切り替わる演出を入れることがあります。ただ、この全画面のローディング画面は、何度も見せると邪魔になります。

そこで、sessionStorage(タブを閉じるまで値を覚えておく仕組み)に「見た」という印を残します。同じタブでは、2回目以降は出しません。

表示は長くても1.5秒にして、スキップのボタンも置きます。消えるときは、Motion でフェードアウトさせます。

仕上がったオープニングとして、Knockout Cloud Opener は、雲の窓からページを見せたあと、バブルのマスクを全画面まで広げ、既存のヒーローを children として包みます。

components/Splash.tsx
"use client";

import { useEffect, useState } from "react";
import { AnimatePresence, motion } from "motion/react";

const STORAGE_KEY = "splash-seen";
const MAX_MS = 1500;

function markSeen() {
  try {
    sessionStorage.setItem(STORAGE_KEY, "1");
  } catch {}
}

export function Splash() {
  const [visible, setVisible] = useState(true);

  useEffect(() => {
    let seen = false;
    try {
      seen = sessionStorage.getItem(STORAGE_KEY) === "1";
    } catch {}
    const reduce = window.matchMedia("(prefers-reduced-motion: reduce)").matches;
    if (seen || reduce) {
      setVisible(false);
      return;
    }
    const timer = window.setTimeout(() => {
      markSeen();
      setVisible(false);
    }, MAX_MS);
    return () => window.clearTimeout(timer);
  }, []);

  const skip = () => {
    markSeen();
    setVisible(false);
  };

  return (
    <AnimatePresence>
      {visible && (
        <motion.div
          key="splash"
          exit={{ opacity: 0 }}
          transition={{ duration: 0.5, ease: "easeOut" }}
          className="fixed inset-0 z-50 grid place-items-center bg-zinc-950 text-white [.splash-seen_&]:hidden"
        >
          <motion.p
            initial={{ opacity: 0, y: 12 }}
            animate={{ opacity: 1, y: 0 }}
            transition={{ duration: 0.6, ease: "easeOut" }}
            className="text-3xl font-semibold tracking-tight"
          >
            Acme Studio
          </motion.p>
          <button
            type="button"
            onClick={skip}
            className="absolute bottom-8 right-6 min-h-11 rounded-full px-5 text-sm text-white/70 hover:text-white focus-visible:outline focus-visible:outline-2 focus-visible:outline-white"
          >
            スキップ
          </button>
        </motion.div>
      )}
    </AnimatePresence>
  );
}

2回目以降のローディング画面をちらつかせない

Splash はブラウザで動く部品なので、印を確かめる前に一瞬だけ画面に出てしまいます。これを防ぐため、描画の前に動く小さなスクリプトを layout.tsx に置きます。

印がある場合や動きを減らす設定の場合は、html に splash-seen というクラスを付けます。Splash の [.splash-seen_&]:hidden が、このクラスを見て最初から隠します。

スクリプトが html の class を書き換えるので、html には suppressHydrationWarning を付けています。

app/layout.tsx
import type { ReactNode } from "react";
import { Splash } from "@/components/Splash";
import "./globals.css";

const splashScript =
  'try{if(sessionStorage.getItem("splash-seen")==="1"||matchMedia("(prefers-reduced-motion: reduce)").matches){document.documentElement.classList.add("splash-seen")}}catch(e){}';

export default function RootLayout({ children }: { children: ReactNode }) {
  return (
    <html lang="ja" suppressHydrationWarning>
      <head>
        <script dangerouslySetInnerHTML={{ __html: splashScript }} />
      </head>
      <body>
        <Splash />
        {children}
      </body>
    </html>
  );
}

コードのポイント

  • 「見た」印は、時間切れかスキップのときに保存する。開発中に処理が2回動いても、1回目として正しく扱える

  • 動きを減らす設定の人には、オープニングを最初から出さない

  • 本体のページは下で普通に描画しておき、透明にしない

  • AnimatePresence で包むと、消えるときにも exit のアニメーションが動く

Motion の基本は、https://design-layer.com/ja/articles/nextjs-framer-motion-guide で解説しています。

ローディング画面で LCP を落とさないには?

LCP は、ページでいちばん大きな画像や文章が表示されるまでの時間です。Google が重視する、表示速度の指標の1つです。

その要素が Suspense の境界の中にあると、フォールバックが中身に入れ替わるまで描けません。ページ全体を包む loading.tsx では、本文の大きな文字や画像がその境界の中に入ります。ページ全体を待つ必要があるときだけ使ってください。1か所だけ遅いなら、上の Suspense の例のように、見出しは境界の外に残します。

全画面のオープニングも、この数値を悪くすることがあります。次の3点を守ってください。

  • 本体の文章や画像を、opacity: 0 で隠したまま待たない。透明な要素は LCP の対象にならず、計測が後ろに延びる

  • 最低表示時間のような、わざと待たせるタイマーを入れない

  • オープニングの中に、大きな画像や重い動画を置かない

演出は本体の読み込みを止めず、上に重ねるだけにします。重ねている間も、下ではページの準備が進みます。

動きを減らす設定のときのローディング画面

点滅や回転は、動きを減らす設定のときに止めるか、ゆっくりにします。Tailwind では motion-reduce: を付けると、その設定のときだけ別の指定にできます。

回る印を止める場合は、「読み込み中」や「送信中…」の文字を必ず添えてください。

公開前に、ローディング画面のどこを確認しますか?

  • 待ち時間のないページに、演出のためだけのローディング画面を出す

  • ページを移動するたびに、全画面のオープニングを出す

  • スキップの手段がなく、終わるまで何もできない

  • ページ全体を中央のスピナーだけにして、何が出るか分からない

  • 読み込み中であることが、読み上げソフトに伝わらない

  • ページ全体のファイルに "use client" を書いてしまう

公開前には、ブラウザの開発者ツールで回線を遅くして確かめます。Network タブで Slow 4G などを選ぶと、遅い回線での待ち時間に近い状態で見られます。

ページを開いたあとの最初の見た目は、https://design-layer.com/ja/articles/nextjs-animated-hero-section-guide で解説しています。

完成したローディング画面をコピーするには?

DesignLayer の「ピクセルアーク・ローダー」の詳細ページ。左でライブプレビューを確かめ、右の「Cursor 用にコピー」でソースをコピーできる
DesignLayer の「ピクセルアーク・ローダー」の詳細ページ。左でライブプレビューを確かめ、右の「Cursor 用にコピー」でソースをコピーできる

ロゴの文字が1文字ずつ波打つような、凝ったローディング画面を作りたい場合もあります。文字ごとの動きと背景の重なりを整えるのは、意外と手間がかかります。

DesignLayer のカタログにある「ピクセルアーク・ローダー」は、全画面のローディング画面です。ぼかした風景写真の上で、アーチ状に並んだ立体的なピクセルのロゴが文字ごとに波打ちます。

詳細ページのライブプレビューで動きを確かめ、「Cursor 用にコピー」を押します。組み込みの指示・ライブプレビューの URL・本体の TSX・必要な npm パッケージが、まとめてコピーされます。

Cursor や Claude に貼れば、自分の Next.js に組み込めます。そのあとは、ロゴの文言と背景写真を差し替えます。

組み込むときは、Step3 の sessionStorage の仕組みと組み合わせると、初回だけ表示できます。

閲覧とライブプレビューは無料で、アカウントもカードも要りません。無料アカウントでは、コンポーネントのコピーは無料です。動画プロンプトは月1回です。Free では MCP に接続できません。Blocks と Templates は30日ビルドパス($19の1回払い、自動更新なし)、Lifetime Access(先着100名の$79の1回払い)、Plus(月額 $9、いつでも解約可)です。カタログ全体は30日ビルドパス、Lifetime、Plus です。https://design-layer.com/ja/components

ローディング画面についてよくある質問

  • そのフォルダの page.tsx と、その下のルートを描画しているあいだに出ます。待つ処理がなければ、ほとんど見えずに切り替わります。

Next.js のローディング画面は、どう作りますか?

  • ローディング画面は、本当に待ち時間があるときだけ出す

  • ページ移動中の待ちは、そのルートのフォルダの loading.tsx にスケルトンを置く

  • 一部だけ遅いなら、その部品だけを Suspense で包む

  • 形が決まっているものはスケルトン、短い送信はスピナーにする

  • オープニングはセッションで1回、1.5秒以内にして、スキップを置く

  • 本体は透明にせず、演出は上に重ねるだけにする

まずは、データを取得しているページのフォルダに loading.tsx を1つ置いてみてください。

ロゴを Lottie で動かす場合は、https://design-layer.com/ja/articles/nextjs-lottie-animation-guide で読み込みを軽くする方法を解説しています。

関連ガイド