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 とその下の子を包みます。既定ではサーバーコンポーネントです。
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 する非同期のサーバーコンポーネントなら、フォールバックが出たまま待てます。描画が終わったあとにブラウザで取りにいく処理は、このフォールバックを引き留めません。
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行が、ドキュメントにある最小の形です。一覧のように形が決まっているページでは、これから出るカードと同じ並びのスケルトンにします。
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種類が基本です。
スケルトン:これから出る中身の形を、灰色の箱で先に見せる。一覧やカードなど、形が決まっているものに向く
スピナー:回る印で、処理中であることだけを伝える。ボタンの送信など、短くて形のない待ちに向く
ページ全体を中央のスピナーだけにすると、何が出てくるのか分かりません。形が分かるものは、スケルトンにしてください。
"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 として包みます。
"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 を付けています。
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 で解説しています。
完成したローディング画面をコピーするには?

ロゴの文字が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 で読み込みを軽くする方法を解説しています。



