Next.jsで学ぶReact講座 90日コース | React実践力を身につける - Day 26:useReducer

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

Day 26:useReducerで複数のStateを管理する

useReducerは、複数の関連するStateや、状態を変える操作が増えてきたときに役立つReact Hookです。状態と更新ルールをひとつのreducer関数にまとめ、コンポーネントからは「何をしたいか」をdispatchで伝えます。

この日は、入力欄・タスク一覧・フィルター・メッセージをまとめて管理する小さなタスクアプリを作ります。

1. useStateとuseReducerの違い

useStateでは、Stateごとに更新関数を使います。

// 複数のStateを個別に管理する例です
const [tasks, setTasks] = useState([]);
const [filter, setFilter] = useState("all");
const [message, setMessage] = useState("");
JSX

Stateが少なく、それぞれの更新が単純なら、useStateで十分です。一方、状態が複数あり、ひとつの操作で複数の値を一緒に更新したい場合は、更新ルールが各イベントハンドラーに散らばりやすくなります。

useReducerでは、状態をまとめて持ち、状態の変更方法をreducer関数に集められます。

  • State:現在の状態です。
  • Action:どんな操作をしたいかを表す情報です。
  • Reducer:現在の状態とActionから、新しい状態を作る関数です。
  • Dispatch:Actionをreducerへ送る関数です。

2. useReducerの基本形

useReducerは、reducer関数と初期Stateを受け取ります。現在のStateと、Actionを送るdispatchを返します。

// ReactからuseReducerを読み込みます
import { useReducer } from "react";

// 現在のstateとactionから、新しいstateを返す関数です
function reducer(state, action) {
  // actionの種類に応じて処理を分けます
  switch (action.type) {
    case "increment":
      // 現在の値を直接変更せず、新しい値を返します
      return { count: state.count + 1 };

    default:
      // 知らないactionの場合は現在のstateを返します
      return state;
  }
}

// コンポーネント内でreducerを使います
function Counter() {
  // 初期状態を設定し、stateとdispatchを受け取ります
  const [state, dispatch] = useReducer(reducer, { count: 0 });

  return (
    <button
      type="button"
      // incrementというactionをreducerへ送ります
      onClick={() => dispatch({ type: "increment" })}
    >
      {state.count}回
    </button>
  );
}
JSX

dispatch({ type: "increment" })は、「カウントを増やす操作を行ってください」と伝えています。実際に新しいStateを作るのはreducerです。

3. タスクアプリで管理するState

今回のアプリでは、次の状態をまとめて管理します。

  • tasks:タスクの一覧です。
  • inputValue:入力欄の内容です。
  • filter:すべて・未完了・完了済みのどれを表示するかです。
  • message:入力エラーなどの案内です。

タスク数やフィルター後の一覧は、これらのStateから計算できます。計算で求められる値を別のStateとして重複して持たないようにします。

4. Actionを設計する

Actionは、アプリで起こる操作を表します。Actionには、操作名を示すtypeと、必要に応じてデータを入れます。

// 入力欄が変わったことを伝えるActionです
{ type: "inputChanged", value: "買い物をする" }

// 新しいタスクを追加するActionです
{ type: "taskAdded", task: newTask }

// タスクの完了状態を切り替えるActionです
{ type: "taskToggled", id: "task-001" }
JavaScript

typeの名前は、何が起きたか分かるものにします。Actionを設計するときは、「画面のどのボタンか」だけでなく、「アプリ上で何が起きたか」を考えると整理しやすくなります。

5. Next.jsのファイルを用意する

App Routerでは、ページをapp/page.jsまたはsrc/app/page.jsに作成します。今回の例はフォームイベントとuseReducerを使うので、ファイルの先頭に'use client'を記述します。

my-app/
└── app/
    └── page.js

6. 完成コード

以下のコードをapp/page.jsまたはsrc/app/page.jsに記述してください。

// このファイルをClient Componentとして扱います
"use client";

// Reactの状態管理Hookを読み込みます
import { useReducer } from "react";

// アプリの初期状態を定義します
const initialState = {
  // タスク一覧は最初は空です
  tasks: [],

  // 入力欄の初期値です
  inputValue: "",

  // 最初はすべてのタスクを表示します
  filter: "all",

  // 表示用メッセージの初期値です
  message: "",
};

// Actionに応じて新しいStateを返すreducerです
function taskReducer(state, action) {
  // Actionの種類に応じて更新方法を切り替えます
  switch (action.type) {
    case "inputChanged":
      // 入力値を更新し、古い案内メッセージを消します
      return {
        ...state,
        inputValue: action.value,
        message: "",
      };

    case "filterChanged":
      // 表示フィルターを更新します
      return {
        ...state,
        filter: action.value,
      };

    case "taskAdded":
      // 新しいタスクを配列の末尾に追加します
      return {
        ...state,
        tasks: [...state.tasks, action.task],
        inputValue: "",
        message: "",
      };

    case "taskToggled":
      // 指定されたタスクの完了状態を切り替えます
      return {
        ...state,
        tasks: state.tasks.map((task) => {
          // 対象外のタスクはそのまま返します
          if (task.id !== action.id) {
            return task;
          }

          // 対象のタスクは新しいオブジェクトにして返します
          return {
            ...task,
            completed: !task.completed,
          };
        }),
      };

    case "taskDeleted":
      // 指定されたID以外のタスクから新しい配列を作ります
      return {
        ...state,
        tasks: state.tasks.filter((task) => task.id !== action.id),
      };

    case "messageChanged":
      // 入力エラーなどの案内を更新します
      return {
        ...state,
        message: action.value,
      };

    default:
      // 未知のActionではStateを変更しません
      return state;
  }
}

// タスクアプリのページです
export default function TaskReducerPage() {
  // reducer、初期状態を指定し、Stateとdispatchを受け取ります
  const [state, dispatch] = useReducer(taskReducer, initialState);

  // 現在のフィルターに合うタスクを計算します
  const visibleTasks = state.tasks.filter((task) => {
    // 未完了フィルターなら未完了のタスクだけを残します
    if (state.filter === "active") {
      return !task.completed;
    }

    // 完了済みフィルターなら完了タスクだけを残します
    if (state.filter === "completed") {
      return task.completed;
    }

    // allの場合はすべてのタスクを残します
    return true;
  });

  // 未完了タスクの数を一覧から計算します
  const remainingCount = state.tasks.filter((task) => {
    return !task.completed;
  }).length;

  // フォーム送信時にタスクを追加します
  function handleSubmit(event) {
    // ブラウザー標準のフォーム送信を止めます
    event.preventDefault();

    // 前後の空白を取り除いた入力値を作ります
    const title = state.inputValue.trim();

    // 空欄の場合は案内を表示します
    if (title === "") {
      dispatch({
        type: "messageChanged",
        value: "タスク名を入力してください。",
      });
      return;
    }

    // タスク名の長さを確認します
    if (title.length > 100) {
      dispatch({
        type: "messageChanged",
        value: "タスク名は100文字以内で入力してください。",
      });
      return;
    }

    // イベント処理の中で新しいタスクを作ります
    const newTask = {
      id: window.crypto.randomUUID(),
      title,
      completed: false,
    };

    // 新しいタスクを追加するActionを送ります
    dispatch({
      type: "taskAdded",
      task: newTask,
    });
  }

  return (
    <main>
      <h1>タスク管理</h1>

      {/* 入力内容をStateに反映し、送信時にタスクを追加します */}
      <form onSubmit={handleSubmit}>
        <label htmlFor="task-input">新しいタスク</label>

        <input
          id="task-input"
          type="text"
          value={state.inputValue}
          maxLength={100}
          placeholder="例:Reactを復習する"
          onChange={(event) => {
            // 入力変更Actionをreducerへ送ります
            dispatch({
              type: "inputChanged",
              value: event.target.value,
            });
          }}
        />

        <button type="submit">追加</button>
      </form>

      {/* 入力エラーなどの案内を表示します */}
      <p aria-live="polite">{state.message}</p>

      {/* タスク数を表示します */}
      <p>全タスク:{state.tasks.length}件</p>
      <p>未完了:{remainingCount}件</p>

      {/* 表示条件を選び、変更内容をreducerへ伝えます */}
      <label htmlFor="task-filter">表示するタスク</label>
      <select
        id="task-filter"
        value={state.filter}
        onChange={(event) => {
          // フィルター変更Actionを送ります
          dispatch({
            type: "filterChanged",
            value: event.target.value,
          });
        }}
      >
        <option value="all">すべて</option>
        <option value="active">未完了</option>
        <option value="completed">完了済み</option>
      </select>

      {/* 条件に合うタスクを一覧表示します */}
      {visibleTasks.length > 0 ? (
        <ul>
          {visibleTasks.map((task) => (
            // タスクIDを安定したkeyとして使います
            <li key={task.id}>
              <label>
                <input
                  type="checkbox"
                  checked={task.completed}
                  onChange={() => {
                    // 完了状態を切り替えるActionを送ります
                    dispatch({
                      type: "taskToggled",
                      id: task.id,
                    });
                  }}
                />

                {/* 完了済みのタスクには取り消し線を付けます */}
                <span
                  style={{
                    textDecoration: task.completed
                      ? "line-through"
                      : "none",
                  }}
                >
                  {task.title}
                </span>
              </label>

              <button
                type="button"
                onClick={() => {
                  // タスク削除Actionを送ります
                  dispatch({
                    type: "taskDeleted",
                    id: task.id,
                  });
                }}
                aria-label={`${task.title}を削除`}
              >
                削除
              </button>
            </li>
          ))}
        </ul>
      ) : (
        // タスクがない場合やフィルターに一致しない場合の表示です
        <p>
          {state.tasks.length === 0
            ? "タスクはまだありません。"
            : "この条件に一致するタスクはありません。"}
        </p>
      )}
    </main>
  );
}
JSX

7. 操作から画面更新までの流れ

たとえば、入力欄にタスク名を入力すると、次の流れになります。

  • 入力欄の`onChange`が実行されます。
  • `dispatch({ type: “inputChanged”, value: … })`でActionを送ります。
  • `taskReducer`がActionの`type`を確認します。
  • 新しい`inputValue`を持つStateを返します。
  • Reactが新しいStateを使って画面を更新します。

タスクの完了操作も同じ仕組みです。コンポーネントは「完了状態を切り替えたい」とActionで伝え、更新方法はreducerに任せます。

8. Reducerは純粋関数にする

Reducerは、同じStateと同じActionを受け取ったら、同じ結果を返すように書きます。これを純粋関数として扱うといいます。

Reducer内では、Stateを直接変更したり、乱数・現在時刻を取得したり、API通信を行ったりしません。

// よい例:新しいStateを作って返します
case "taskDeleted":
  return {
    ...state,
    tasks: state.tasks.filter((task) => task.id !== action.id),
  };
JSX

次のように、既存の配列を直接変更するのは避けます。

// 避けたい例:既存のState配列を直接変更しています
state.tasks.push(action.task);
return state;
JSX

完成コードではcrypto.randomUUID()をイベントハンドラーで実行し、その結果をActionに含めています。ID生成をreducerの中に置かないのは、reducerの結果が毎回同じになる性質を保ちやすくするためです。

9. Stateをまとめる範囲を考える

useReducerを使うからといって、アプリ内のすべてのStateをひとつにまとめる必要はありません。関連する状態と、それを更新する操作をまとめるのが基本です。

  • 複数の入力やタスク一覧が連動する小さなアプリでは、まとめると流れを追いやすくなります。
  • ひとつのコンポーネントだけで使う単純な開閉状態などは、`useState`のほうが簡潔な場合があります。
  • 独立した機能のStateまで大きなReducerに詰め込むと、Actionの種類が増えすぎて分かりにくくなります。

useStateとuseReducerはどちらか一方しか使えないものではありません。同じアプリの中で、用途に応じて使い分けられます。

10. Actionの書き方をそろえる

Actionは、更新の理由が分かる名前にします。typeを見れば、何の操作なのかが判断できるようにしましょう。

// 何をするActionか分かりやすい例です
{ type: "taskToggled", id: taskId }
{ type: "taskDeleted", id: taskId }
{ type: "filterChanged", value: "active" }
JavaScript

type: "change"のように意味が広すぎる名前を多用すると、reducerの分岐を読んでも操作の意図が分かりにくくなります。

11. よくあるつまずき

  • Reducerが何も返さない:各`case`で新しいStateを返し、未知のActionでは現在のStateを返します。
  • Stateを直接変更してしまう:配列には`map()`や`filter()`、オブジェクトにはスプレッド構文を使って新しい値を作ります。
  • Actionの`type`名が合わない:`dispatch`側とreducer側で同じ文字列を使っているか確認します。
  • 更新後すぐのStateを同じ処理内で読もうとする:`dispatch`は更新を依頼します。次の画面描画で新しいStateが使われます。
  • ReducerにAPI通信や乱数を入れる:通信やID生成などの副作用は、イベント処理やEffectなど適切な場所で行い、その結果をActionとして渡します。
  • 何でもReducerにまとめて巨大化する:状態と更新処理に関連があるかを基準に、管理単位を分けます。

12. 練習用テンプレート

次のテンプレートにActionを追加し、タスクの編集機能を作ってみましょう。

// reducerに編集Actionを追加する練習です
function taskReducer(state, action) {
  switch (action.type) {
    case "taskEdited":
      // TODO: state.tasksをmap()で新しい配列にします
      // TODO: action.idが一致するタスクだけtitleを更新します
      // TODO: 新しいStateを返します

    default:
      // 未知のActionでは現在のStateを返します
      return state;
  }
}
JSX

編集処理では、タスク配列を直接変更せず、対象のタスクだけ新しいオブジェクトに置き換えます。

13. Day 26のチェックリスト

  • `useReducer`が、Stateと更新ルールをまとめるために使えると説明できます。
  • State、Action、Reducer、Dispatchの役割を説明できます。
  • `dispatch`でActionを送るとreducerが新しいStateを返す流れを理解しています。
  • Reducer内でStateを直接変更していません。
  • ReducerにAPI通信や乱数などの副作用を入れていません。
  • 状態をまとめすぎず、関連するStateと更新操作を整理できます。

useReducerでは、コンポーネントが操作をActionとして送り、reducerが新しいStateを作ります。状態の更新ルールが複数のイベントハンドラーに散らばり始めたとき、処理を一か所に集めて見通しをよくする方法として役立ちます。まずはActionをひとつずつ追加し、Stateがどのように変化するか確認してみましょう。

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