読み方のヒント
矢印ボタン(または ← → キー)でページを移動できます。
よく使う表示を、部品にまとめます。
// src/components/status/EmptyState.tsx
export const EmptyState = ({ title, action }: { title: string; action?: React.ReactNode }) => (
<div className="empty-state">
<p>{title}</p>
{action}
</div>
);
// src/components/status/ErrorState.tsx
"use client";
export const ErrorState = ({ title, onRetry }: { title: string; onRetry: () => void }) => (
<div className="error-state" role="alert">
<p>{title}</p>
<button type="button" onClick={onRetry}>
もう一度読み込む
</button>
</div>
);
// src/app/products/error.tsx
"use client";
import { ErrorState } from "@/components/status/ErrorState";
export default function ProductsError({ retry }: { error: unknown; retry: () => void }) {
return <ErrorState title="商品を読み込めませんでした" onRetry={retry} />;
}
| 部品 | 使う場面 |
|---|---|
EmptyState | 項目が1つもない |
ErrorState | 読み込みに失敗した |
画面ごとの枠(...Skeleton) | 読み込み中 |
role="alert" は、表示されたときに読み上げの道具がすぐに読む、という印です。失敗の知らせのように、すぐに伝えたい表示に使います。
読み込み中は「予約を確かめています」の1行、見つからないときは notFound() で「予約が見つかりません。予約番号を確かめてください」、失敗は ErrorState で読み直すボタン、成功は予約番号と受け取りの日時を表示します。
src/app/products/error.tsx の「商品を読み込めませんでした」と、読み直すボタンが表示されます。ヘッダーは、そのまま表示されています。開発中は、エラーの内容を示す Next.js の画面が上に重なって出ることがあり、閉じると error.tsx の表示が見えます。npm run build では、前もって作るときにエラーになり、ビルドが止まります。
16 / 17