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("");JSXStateが少なく、それぞれの更新が単純なら、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>
);
}JSXdispatch({ 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" }JavaScripttypeの名前は、何が起きたか分かるものにします。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>
);
}JSX7. 操作から画面更新までの流れ
たとえば、入力欄にタスク名を入力すると、次の流れになります。
- 入力欄の`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" }JavaScripttype: "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がどのように変化するか確認してみましょう。

