Next.jsで学ぶReact講座 90日コース | React基礎 - Day 18:条件付きレンダリング

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

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>
  );
}
JSX

returnは、その時点で関数の処理を終えます。そのため、ログインしていないときは案内だけを返し、ログイン時の画面は表示されません。

ローディングやエラーなど、状態が複数ある場合にもif文が役立ちます。

// 読み込み状態ごとに表示を分けます
function Content({ isLoading, error, data }) {
  // 読み込み中の画面を返します
  if (isLoading) {
    return <p>読み込み中です。</p>;
  }

  // エラーがある場合の画面を返します
  if (error) {
    return <p role="alert">情報を読み込めませんでした。</p>;
  }

  // 問題なく読み込めたデータを表示します
  return <p>{data}</p>;
}
JSX

3. 三項演算子で2つの表示を切り替える

条件に応じて表示する内容が2つだけなら、三項演算子を使えます。形は条件 ? 条件がtrueのとき : falseのときです。

// ログイン状態を文字で表示します
function LoginStatus({ isLoggedIn }) {
  // 条件に応じて、どちらかの文章を表示します
  return (
    <p>
      {isLoggedIn ? "ログイン中です。" : "ログインしていません。"}
    </p>
  );
}
JSX

JSXの大きな部分を切り替える場合は、読みやすいように改行して書けます。

// ログイン状態に合わせて画面の一部分を切り替えます
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>}
JSX

5. ローディングとエラー表示を使い分ける

データを読み込む画面では、画面の状態を分けて考えます。たとえば、読み込み中、成功、エラーの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文が便利です。ログイン画面の切り替えは表示制御の練習であり、実際のアクセス制限にはサーバー側での認証・認可が必要です。

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