Day 18:条件付きレンダリング
条件付きレンダリングとは、条件に応じて画面に表示する内容を切り替えることです。ログインしていればマイページを表示し、ログインしていなければ案内を表示する、といった画面を作れます。
この日は、JavaScriptのif、三項演算子、&&を使って表示を切り替えます。あわせて、ログイン状態に応じて画面が変わるデモを作り、ローディングとエラー表示も練習します。(🔗 react.dev)
1. 条件付きレンダリングとは
普通のJavaScriptと同じように、Reactでも条件を使って処理を分けられます。条件が違えば、返すJSXを変えられます。
たとえば、ログイン状態がtrueならマイページ、falseならログイン案内を表示します。
// ログイン状態に応じて表示を変える例です
function WelcomeMessage({ isLoggedIn }) {
// ログインしている場合の表示を返します
if (isLoggedIn) {
return <p>マイページへようこそ。</p>;
}
// ログインしていない場合の表示を返します
return <p>ログインしてください。</p>;
}JSXここでは、isLoggedInの値をPropsとして受け取っています。条件付きレンダリングでは、StateやPropsの値をもとに表示を切り替えるのが基本です。
2. if文で表示を分ける
if文は、条件によってコンポーネント全体の内容を大きく変えたいときに便利です。
// ログイン状態によって画面を切り替えるコンポーネントです
function AccountPage({ isLoggedIn }) {
// ログインしていない場合はログイン案内だけを返します
if (!isLoggedIn) {
return (
<main>
<h1>ログインが必要です</h1>
<p>アカウント情報を見るにはログインしてください。</p>
</main>
);
}
// ログインしている場合の画面を返します
return (
<main>
<h1>マイページ</h1>
<p>アカウント情報を確認できます。</p>
</main>
);
}JSXreturnは、その時点で関数の処理を終えます。そのため、ログインしていないときは案内だけを返し、ログイン時の画面は表示されません。
ローディングやエラーなど、状態が複数ある場合にもif文が役立ちます。
// 読み込み状態ごとに表示を分けます
function Content({ isLoading, error, data }) {
// 読み込み中の画面を返します
if (isLoading) {
return <p>読み込み中です。</p>;
}
// エラーがある場合の画面を返します
if (error) {
return <p role="alert">情報を読み込めませんでした。</p>;
}
// 問題なく読み込めたデータを表示します
return <p>{data}</p>;
}JSX3. 三項演算子で2つの表示を切り替える
条件に応じて表示する内容が2つだけなら、三項演算子を使えます。形は条件 ? 条件がtrueのとき : falseのときです。
// ログイン状態を文字で表示します
function LoginStatus({ isLoggedIn }) {
// 条件に応じて、どちらかの文章を表示します
return (
<p>
{isLoggedIn ? "ログイン中です。" : "ログインしていません。"}
</p>
);
}JSXJSXの大きな部分を切り替える場合は、読みやすいように改行して書けます。
// ログイン状態に合わせて画面の一部分を切り替えます
function AccountSummary({ isLoggedIn }) {
return (
<section>
{isLoggedIn ? (
<p>登録情報を確認できます。</p>
) : (
<p>ログインすると登録情報を確認できます。</p>
)}
</section>
);
}JSX条件が複雑になったり、三項演算子を何段も重ねたりすると読みづらくなります。その場合は、if文や小さなコンポーネントに分けましょう。
4. &&で条件に合うときだけ表示する
条件に合う場合だけ何かを表示し、それ以外では何も表示しないときは&&を使えます。
// ログインしているときだけ案内を表示します
function MemberNotice({ isLoggedIn }) {
return (
<section>
<h2>お知らせ</h2>
{/* ログインしている場合だけメッセージを表示します */}
{isLoggedIn && <p>会員向けのお知らせがあります。</p>}
</section>
);
}JSX条件 && JSXは、条件がtrueなら右側のJSXを表示し、falseなら何も表示しません。
&&の左側に数値を置かない
&&の左側が0になる可能性がある場合は注意が必要です。JavaScriptでは0 && ...の結果が0になり、Reactが画面に0を表示することがあります。(🔗 react.dev)
// 注意:items.lengthが0のとき、画面に0が表示されることがあります
{items.length && <p>商品があります。</p>}JSX数が0より大きいかを明示しましょう。
// 0件なら何も表示せず、1件以上ならメッセージを表示します
{items.length > 0 && <p>商品があります。</p>}JSX5. ローディングとエラー表示を使い分ける
データを読み込む画面では、画面の状態を分けて考えます。たとえば、読み込み中、成功、エラーの3つです。認証状態の画面では、さらにログインしているかどうかを扱います。
- ローディング:確認や読み込みが終わるまで表示します。
- エラー:確認や読み込みに失敗したときに表示します。
- ログインしていない:ログイン案内を表示します。
- ログインしている:マイページなどを表示します。
「まだ確認していない状態」と「ログインしていない状態」を混同しないことが大切です。確認前にログイン案内を表示すると、状態が確定する前に誤った画面を見せることがあります。
6. Next.jsの準備
App Routerを使っている場合、ページファイルはapp/page.jsまたはsrc/app/page.jsです。今回のデモではボタン操作やuseStateを使うので、Client Componentにします。'use client'はファイルの先頭に記述します。(🔗 nextjs.org)
my-app/
└── app/
└── page.js
7. ログイン状態で表示が変わるデモを作る
次の例では、ログイン状態をstatusで管理します。ローディング、エラー、ログアウト、ログインをそれぞれ画面に表示します。
このサンプルのログインボタンは、画面の切り替えを練習するためのデモ用です。ユーザー名やパスワードを確認する認証処理はなく、実際のログイン機能ではありません。
app/page.jsまたはsrc/app/page.jsに記述してください。
// このファイルをClient Componentとして扱います
"use client";
// Reactの状態管理機能を読み込みます
import { useState } from "react";
// ログイン状態による表示切り替えを学ぶページです
export default function ConditionalPage() {
// 画面状態を管理します
// 初期状態はログインしていない状態です
const [status, setStatus] = useState("loggedOut");
// エラー表示用の状態です
const [errorMessage, setErrorMessage] = useState("");
// 確認中の表示を短時間見せるためのデモ関数です
function handleCheckStatus() {
// 前回のエラーを消し、ローディング状態にします
setErrorMessage("");
setStatus("loading");
// 学習用に少し待ってからログアウト状態へ切り替えます
window.setTimeout(() => {
setStatus("loggedOut");
}, 800);
}
// デモ用のエラー状態に切り替える関数です
function handleShowError() {
// エラー状態を設定します
setErrorMessage("状態を確認できませんでした。");
setStatus("error");
}
// デモ用にログイン状態へ切り替える関数です
function handleDemoLogin() {
// エラーを消してログイン状態にします
setErrorMessage("");
setStatus("loggedIn");
}
// ログアウト状態へ切り替える関数です
function handleDemoLogout() {
// エラーを消してログアウト状態にします
setErrorMessage("");
setStatus("loggedOut");
}
// ローディング状態なら、読み込み表示だけを返します
if (status === "loading") {
return (
<main>
<h1>ログイン状態の確認</h1>
<p aria-live="polite">状態を確認しています...</p>
</main>
);
}
// エラー状態なら、エラー表示と再確認ボタンを返します
if (status === "error") {
return (
<main>
<h1>ログイン状態の確認</h1>
{/* role="alert"でエラーとして伝えます */}
<p role="alert">{errorMessage}</p>
{/* 押すと確認中を経てデモ状態に戻ります */}
<button type="button" onClick={handleCheckStatus}>
もう一度確認する
</button>
{/* エラー表示を試すためのデモボタンです */}
<button type="button" onClick={handleShowError}>
エラー表示をもう一度試す
</button>
</main>
);
}
// ログイン状態ではマイページを表示します
if (status === "loggedIn") {
return (
<main>
<h1>マイページ</h1>
<p>ログイン中として表示しているデモ画面です。</p>
{/* デモとしてログアウト状態に切り替えます */}
<button type="button" onClick={handleDemoLogout}>
デモでログアウト
</button>
</main>
);
}
// それ以外はログアウト状態の画面を表示します
return (
<main>
<h1>ようこそ</h1>
<p>ログインするとマイページを表示するデモです。</p>
{/* デモとしてログイン状態に切り替えます */}
<button type="button" onClick={handleDemoLogin}>
デモでログイン
</button>
{/* ローディング状態を確認するボタンです */}
<button type="button" onClick={handleCheckStatus}>
状態を確認する
</button>
{/* エラー表示を学ぶためのデモボタンです */}
<button type="button" onClick={handleShowError}>
エラー表示を試す
</button>
</main>
);
}JSXこのコードは、次の順序で動きます。
- ページを開くと、`status`は`loggedOut`なのでログイン案内を表示します。
- 「デモでログイン」を押すと、`status`が`loggedIn`になり、マイページを表示します。
- 「状態を確認する」を押すと、一時的に`loading`になり、その後ログアウト表示になります。
- 「エラー表示を試す」を押すと、`error`になり、エラーメッセージを表示します。
8. 三項演算子を使ったログイン表示
先ほどのページはif文で画面全体を切り替えています。表示する場所が小さい場合は、三項演算子でも書けます。
// ログイン状態に応じて表示するボタンを変えます
function LoginAction({ isLoggedIn, onLogin, onLogout }) {
return (
<section>
{/* 条件に応じてログイン用とログアウト用を切り替えます */}
{isLoggedIn ? (
<button type="button" onClick={onLogout}>
ログアウト
</button>
) : (
<button type="button" onClick={onLogin}>
ログイン
</button>
)}
</section>
);
}JSX「どちらか一方を表示する」場合は三項演算子が向いています。条件が増えて複雑になる場合は、if文で状態ごとに処理を分けたほうが読みやすくなります。
9. &&を使った補足表示
ログイン状態のときだけ補足情報を追加したい場合は、&&が使えます。
// ログイン中だけ会員向け案内を表示します
function MemberPage({ isLoggedIn }) {
return (
<main>
<h1>サービス案内</h1>
{/* ログイン中に限り案内を表示します */}
{isLoggedIn && (
<p>会員向けのお知らせを確認できます。</p>
)}
</main>
);
}JSX表示する・しないの2択なら&&、別の内容に切り替えるなら三項演算子、状態が複数あるならif文、という使い分けが目安です。
10. 状態を文字列で管理する理由
ログイン画面では、isLoading、hasError、isLoggedInのような真偽値を別々に持つ方法もあります。しかし、状態が増えると、矛盾した組み合わせができることがあります。たとえば、読み込み中でエラーでもあり、ログイン中でもある、という不自然な状態です。
この例ではstatusに次のいずれかを入れています。
"loading""error""loggedOut""loggedIn"
ひとつの変数で現在の状態を表すと、どの画面を出すべきか分かりやすくなります。状態が増えたときは、画面の状態を整理してからStateの持ち方を決めましょう。
11. 大切な注意:表示を隠すだけでは認証にならない
この日の実践は、Reactの表示を切り替える練習です。ボタンでstatusをloggedInに変えるだけでは、ユーザーの本人確認も、データへのアクセス制御も行っていません。
実際のアプリでは、認証でユーザーの身元を確認し、認可でそのユーザーがデータや操作にアクセスできるかを確認します。保護が必要なデータや処理はサーバー側でチェックしてください。画面上でボタンや情報を隠すだけでは、アクセス制御として不十分です。(🔗 nextjs.org)
- デモ用の`useState`を本物のログイン状態として扱わないでください。
- 秘密情報やパスワードをClient Componentだけで確認しないでください。
- 保護対象のデータを返すサーバー処理でも、セッションや権限を検証します。
- ログイン画面の切り替えと、サーバー側の認証・認可を別の仕組みとして考えます。
12. よくあるつまずき
- 状態が決まる前にログイン画面を表示してしまう:初期状態に`loading`を用意し、確認中とログアウトを区別します。
- 三項演算子を何段も重ねる:複雑な条件は`if`文や小さなコンポーネントに分けます。
0が画面に出てしまう:`count && …`ではなく、`count > 0 && …`のように条件を明示します。- ログイン表示をセキュリティ対策だと思う:画面の表示切り替えとは別に、サーバー側でも本人確認と権限確認が必要です。
- エラー表示が見えにくい:エラー文を明確にし、必要に応じて
role="alert"を使います。 - 状態の組み合わせが増えて管理しにくい:ローディング、エラー、ログイン済みなどを状態として整理します。
13. Day 18のチェックリスト
if文で画面全体や状態ごとの表示を分けられます。- 三項演算子で、2つの表示を切り替えられます。
&&で、条件に合う場合だけ要素を表示できます。0 && JSXで数字の0が表示されることがあると理解しています。- 読み込み中、エラー、ログアウト、ログイン済みを分けて考えられます。
- Reactの画面表示と、サーバー側の認証・認可は別物だと理解しています。
条件付きレンダリングでは、条件に応じてどのJSXを返すかを決めます。2つの表示を簡潔に切り替えるなら三項演算子、条件に合うときだけ追加表示するなら&&、状態が複数あるならif文が便利です。ログイン画面の切り替えは表示制御の練習であり、実際のアクセス制限にはサーバー側での認証・認可が必要です。
