Day 20:Reactミニアプリ① Todoアプリ
この日は、これまで学んだuseState、イベント処理、フォーム、map()、filter()、条件付きレンダリングを組み合わせてTodoアプリを作ります。
- タスクを追加します。
- タスクの完了・未完了を切り替えます。
- タスクを削除します。
- 「すべて」「未完了」「完了済み」で表示を絞り込みます。
- 全タスク数と未完了タスク数を表示します。
今回は、まず機能が分かりやすいように1つのページファイルで作ります。完成したあとでコンポーネントに分割する練習もできます。
1. Todoのデータを考える
Todo1件を、次のようなオブジェクトで表します。
// Todo1件分のデータ例です
const task = {
id: "task-001",
title: "Reactの復習をする",
completed: false,
};JavaScriptidは、タスクを区別するためのIDです。titleは、タスクの内容です。completedは、完了済みかどうかを表します。
Todoを複数管理するため、これらのオブジェクトを配列に入れます。タスク数やフィルター結果は、この配列から計算できます。件数を別のStateにも保存すると、Todoを追加・削除したときに数字の更新を忘れる可能性があるため、今回は必要なときに配列から求めます。
2. ページファイルを用意する
Next.jsのApp Routerでは、ページはapp/page.jsまたはsrc/app/page.jsに作ります。今回のアプリは入力やクリックに応じて状態が変化するため、Client Componentとして実装します。'use client'はファイルの先頭に書きます。
my-app/
└── app/
└── page.js
srcフォルダーを使っている場合は、src/app/page.jsを編集してください。
3. Todoアプリの全コード
次のコードをapp/page.jsまたはsrc/app/page.jsに記述します。
// このファイルをClient Componentとして扱います
"use client";
// Reactの状態管理機能を読み込みます
import { useState } from "react";
// Todoアプリのページです
export default function TodoPage() {
// Todo一覧をStateとして管理します
const [tasks, setTasks] = useState([]);
// 追加フォームの入力値を管理します
const [newTaskTitle, setNewTaskTitle] = useState("");
// 現在選択されている表示フィルターを管理します
const [filter, setFilter] = useState("all");
// 入力エラーや操作結果のメッセージを管理します
const [message, setMessage] = useState("");
// 完了状態とフィルター条件に応じて表示対象を作ります
const visibleTasks = tasks.filter((task) => {
// 未完了フィルターなら、未完了のタスクだけを残します
if (filter === "active") {
return task.completed === false;
}
// 完了済みフィルターなら、完了したタスクだけを残します
if (filter === "completed") {
return task.completed === true;
}
// "all"なら、すべてのタスクを残します
return true;
});
// まだ完了していないタスク数を計算します
const remainingTaskCount = tasks.filter((task) => {
return task.completed === false;
}).length;
// フォーム送信時に新しいタスクを追加します
function handleSubmit(event) {
// フォーム標準のページ再読み込みを防ぎます
event.preventDefault();
// 入力文字の前後にある空白を取り除きます
const trimmedTitle = newTaskTitle.trim();
// 空欄のタスクは追加しません
if (trimmedTitle === "") {
setMessage("タスクの内容を入力してください。");
return;
}
// 長すぎる入力は追加しないようにします
if (trimmedTitle.length > 100) {
setMessage("タスクは100文字以内で入力してください。");
return;
}
// 新しいタスクオブジェクトを作ります
const newTask = {
// ブラウザーで一意なIDを作ります
id: crypto.randomUUID(),
// 空白を取り除いた入力内容を保存します
title: trimmedTitle,
// 新しいタスクは未完了から始めます
completed: false,
};
// 元の配列を変更せず、新しい配列を作って追加します
setTasks((currentTasks) => [...currentTasks, newTask]);
// 入力欄を空に戻します
setNewTaskTitle("");
// 前の案内メッセージを消します
setMessage("");
}
// 指定したタスクの完了状態を切り替えます
function handleToggle(taskId) {
// map()で新しい配列を作り、対象タスクを更新します
setTasks((currentTasks) =>
currentTasks.map((task) => {
// 対象でないタスクはそのまま返します
if (task.id !== taskId) {
return task;
}
// 対象タスクは新しいオブジェクトとして返します
return {
...task,
completed: !task.completed,
};
})
);
// 操作結果を示すメッセージを消します
setMessage("");
}
// 指定したタスクを削除します
function handleDelete(taskId) {
// 削除対象以外のタスクで新しい配列を作ります
setTasks((currentTasks) =>
currentTasks.filter((task) => task.id !== taskId)
);
// 操作結果を示すメッセージを消します
setMessage("");
}
// Todoアプリの画面を返します
return (
<main className="todo-app">
<h1>Todoアプリ</h1>
<p>タスクを追加して、進み具合を管理しましょう。</p>
{/* タスク追加フォームです */}
<form className="todo-form" onSubmit={handleSubmit}>
<label htmlFor="new-task">新しいタスク</label>
{/* 入力値をStateと同期させるcontrolled inputです */}
<input
id="new-task"
type="text"
value={newTaskTitle}
onChange={(event) => setNewTaskTitle(event.target.value)}
placeholder="例:Reactの復習をする"
maxLength={100}
aria-describedby="form-message"
/>
{/* クリックまたはEnterキーでフォームを送信します */}
<button type="submit">追加</button>
</form>
{/* 入力エラーなどのメッセージを表示します */}
<p id="form-message" aria-live="polite">
{message}
</p>
{/* タスク数を表示します */}
<section className="task-summary" aria-label="タスク数">
<p>全タスク:{tasks.length}件</p>
<p>未完了:{remainingTaskCount}件</p>
</section>
{/* 表示するタスクの種類を選びます */}
<div className="filter-control">
<label htmlFor="task-filter">表示するタスク</label>
{/* 選択したフィルターをStateに保存します */}
<select
id="task-filter"
value={filter}
onChange={(event) => setFilter(event.target.value)}
>
<option value="all">すべて</option>
<option value="active">未完了</option>
<option value="completed">完了済み</option>
</select>
</div>
{/* フィルター後の件数を表示します */}
<p aria-live="polite">
表示中:{visibleTasks.length}件
</p>
{/* 表示対象のタスクがあるかどうかで内容を切り替えます */}
{visibleTasks.length > 0 ? (
<ul className="task-list">
{visibleTasks.map((task) => (
// task.idを使い、各項目を識別できるようにします
<li className="task-item" key={task.id}>
<label className="task-label">
{/* チェックボックスで完了状態を切り替えます */}
<input
type="checkbox"
checked={task.completed}
onChange={() => handleToggle(task.id)}
/>
{/* 完了済みのタスクには取り消し線を付けます */}
<span
className={
task.completed
? "task-title task-title--completed"
: "task-title"
}
>
{task.title}
</span>
</label>
{/* このタスクを削除します */}
<button
type="button"
onClick={() => handleDelete(task.id)}
aria-label={`${task.title}を削除`}
>
削除
</button>
</li>
))}
</ul>
) : (
// Todoがない場合や、条件に合うタスクがない場合の表示です
<p className="empty-message">
{tasks.length === 0
? "タスクはまだありません。最初のタスクを追加しましょう。"
: "この条件に当てはまるタスクはありません。"}
</p>
)}
</main>
);
}JSX4. アプリを順番に動かす
ページを表示したら、次の操作を試します。
- 何も登録されていないときの案内が表示されることを確認します。
- 入力欄にタスクを入力し、「追加」を押します。
- 入力欄にフォーカスした状態でEnterキーを押しても追加できることを確認します。
- チェックボックスを押し、完了・未完了が切り替わることを確認します。
- 「未完了」「完了済み」を選び、表示が絞り込まれることを確認します。
- 削除ボタンを押し、対象タスクだけが一覧から消えることを確認します。
- 空白だけを入力して追加しようとしたとき、案内が表示されることを確認します。
5. タスク追加の仕組み
入力欄はnewTaskTitleというStateで管理しています。onChangeが発生するたびに、入力値をStateへ保存します。フォームを送信すると、handleSubmitが実行されます。
// 入力値をStateと同期させます
<input
value={newTaskTitle}
onChange={(event) => setNewTaskTitle(event.target.value)}
/>JSX追加処理では、trim()で入力の前後にある空白を除いてから、空文字でないかを確かめます。これにより、スペースだけのタスクが追加されるのを防げます。
// 前後の空白を取り除きます
const trimmedTitle = newTaskTitle.trim();
// 空の文字列なら追加処理を止めます
if (trimmedTitle === "") {
return;
}JSXタスクの追加では、既存の配列を直接変更せず、新しい配列を作ります。
// 現在の配列をコピーし、その末尾に新しいタスクを加えます
setTasks((currentTasks) => [...currentTasks, newTask]);JSX6. 完了状態を切り替える仕組み
map()でタスク全体を確認し、IDが一致したタスクだけ新しいオブジェクトに置き換えます。それ以外のタスクはそのまま返します。
// IDが一致したタスクだけ、完了状態を反転します
setTasks((currentTasks) =>
currentTasks.map((task) => {
// 対象でないタスクは変更せずに返します
if (task.id !== taskId) {
return task;
}
// 対象タスクの内容をコピーし、completedだけ反転します
return {
...task,
completed: !task.completed,
};
})
);JSX{ ...task, completed: !task.completed }は、元のタスクをコピーし、completedだけを反転した新しいオブジェクトを作ります。State内のオブジェクトや配列を直接変更しないことが重要です。
7. 削除とフィルターの仕組み
削除では、削除対象以外のタスクだけをfilter()で残します。
// 指定ID以外のタスクを残した新しい配列を作ります
setTasks((currentTasks) =>
currentTasks.filter((task) => task.id !== taskId)
);JSX表示フィルターもfilter()を使います。元のtasksはそのまま保ち、表示用のvisibleTasksを作っています。
// 未完了のタスクだけを表示用の配列に残します
const visibleTasks = tasks.filter((task) => {
return task.completed === false;
});JSX元データと表示用データを分けると、フィルターを切り替えてもタスクが削除されたり、元の配列が変わったりしません。
8. タスク数をStateにしない理由
全タスク数はtasks.length、未完了数はfilter()で計算しています。
// 未完了タスクの数を、Todo配列から計算します
const remainingTaskCount = tasks.filter((task) => {
return task.completed === false;
}).length;JSX件数を別のStateにしてしまうと、追加・削除・完了切り替えのたびに、タスク配列と件数の両方を更新する必要があります。更新漏れによる不一致を避けるため、配列から計算できる値は、まず計算で求める方法を検討しましょう。
9. keyとタスクIDの注意点
一覧の各<li>にはkey={task.id}を付けています。keyはReactがリスト項目を識別するためのもので、map()で作る要素には安定した値を指定します。
この例では、追加時にブラウザーのcrypto.randomUUID()でIDを作っています。これはタスクの識別に使うIDであり、ログイン認証や秘密情報の保護に使うものではありません。識別子を秘密情報として扱ったり、アクセス権限の確認に代用したりしないでください。
10. 完成版の見た目を整える
まず機能を確認し、その後でCSSを追加すると、表示の問題と見た目の問題を分けて調べやすくなります。簡単に整える場合は、プロジェクトのapp/globals.cssまたはsrc/app/globals.cssに次のスタイルを追加できます。
/* ページ全体の余白と文字色を設定します */
.todo-app {
max-width: 720px;
margin: 40px auto;
padding: 24px;
color: #243044;
font-family: sans-serif;
}
/* フォームの入力欄を読みやすい幅にします */
.todo-form input {
width: min(100%, 480px);
margin: 8px;
padding: 10px;
}
/* タスクの一覧を読みやすく配置します */
.task-list {
display: grid;
gap: 12px;
padding: 0;
list-style: none;
}
/* 各タスクを横並びにします */
.task-item {
display: flex;
align-items: center;
justify-content: space-between;
gap: 16px;
padding: 12px;
border: 1px solid #d8deea;
border-radius: 8px;
background: #ffffff;
}
/* チェックボックスとタスク名を並べます */
.task-label {
display: flex;
align-items: center;
gap: 10px;
}
/* 完了済みタスクに取り消し線を付けます */
.task-title--completed {
color: #657084;
text-decoration: line-through;
}
/* 空の一覧の案内を目立たせすぎず表示します */
.empty-message {
padding: 16px;
color: #5f6878;
background: #f5f7fb;
border-radius: 8px;
}
11. よくあるつまずき
- 入力欄に入力できない:`value`と`onChange`が同じStateを使っているか確認します。
- 追加後に画面が更新されない:配列を直接変更せず、`setTasks`に新しい配列を渡しているか確認します。
- 完了にしたらタスクが消える:選択中のフィルターが「未完了」になっていないか確認します。未完了フィルターなら、完了したタスクが一覧から消えるのは想定どおりです。
- 違うタスクが削除される:削除処理に渡しているIDが、各タスクのIDと合っているか確認します。
- 一覧の更新が不自然になる:`key`に配列番号ではなく、各タスクの安定したIDを使います。
- 空のとき数字の0だけが表示される:条件には`visibleTasks.length > 0`のように比較を明記します。
12. 発展課題
完成したら、次の機能にも挑戦してみましょう。
- タスクを編集できるようにします。
- 完了済みのタスクをまとめて削除します。
- タスクの検索欄を追加します。
- タスクの作成日時を表示します。
- ページを再読み込みしてもタスクが残るように、ブラウザー保存を学びます。
- `TaskForm`や`TaskItem`などのコンポーネントに分割します。
ブラウザー保存を追加する場合も、パスワードや秘密情報を保存しないようにします。今回のアプリのタスクは、ページを再読み込みすると初期状態に戻ります。
13. Day 20のチェックリスト
- タスクをフォームから追加できます。
- チェックボックスで完了・未完了を切り替えられます。
- 指定したタスクを削除できます。
- 「すべて」「未完了」「完了済み」のフィルターが動きます。
- 全タスク数と未完了タスク数を表示できます。
- タスクがない場合や、フィルターに一致するタスクがない場合の案内を表示できます。
- 配列やオブジェクトを直接変更せず、新しいデータを作ってStateを更新できます。
- 一覧の各項目に安定したIDを使った
keyを指定できます。
このTodoアプリでは、フォームからデータを受け取り、Stateに保存し、map()で一覧に表示しました。完了切り替えには新しいオブジェクト、削除やフィルターにはfilter()を使い、タスク数は配列から計算しています。これらはReactで一覧を扱うときの基本パターンです。まずは各機能を動かし、次にコンポーネント分割や保存機能へ進んでみましょう。
