Day 19:リスト表示でTodo一覧を作る
Reactでは、データの配列から画面の一覧を作るときにmap()を使います。表示する項目を絞り込むにはfilter()を使い、配列から作る各要素にはReactが識別できるkeyを付けます。(🔗 react.dev)
この日は、Todoを追加し、完了・未完了を切り替え、削除できる一覧を作ります。表示条件も切り替え、Todoがない場合の案内も表示します。
1. Todoをオブジェクトで表す
Todoを1件ずつオブジェクトで表し、それらを配列にまとめます。
// Todo1件分のデータ例です
const todo = {
id: 1,
title: "Reactのリスト表示を学ぶ",
completed: false,
};JavaScriptid:Todoを区別するためのIDです。title:Todoの内容です。completed:完了済みならtrue、未完了ならfalseです。
IDがあると、完了状態の切り替えや削除で、対象のTodoを特定できます。
2. ファイルを用意する
Next.jsのApp Routerでは、ページをapp/page.jsまたはsrc/app/page.jsに作ります。今回の例ではuseStateやクリック処理を使うため、Client Componentにします。
my-app/
└── app/
└── page.js
srcフォルダーを使っている場合はsrc/app/page.jsです。
3. map()でリストを表示する
map()は、配列の各項目から新しい値を作る配列メソッドです。Todo配列に対して使うと、Todoごとの<li>要素を作れます。
// Todoデータの配列です
const todos = [
{ id: 1, title: "Reactを学ぶ", completed: false },
{ id: 2, title: "リストを表示する", completed: true },
];
// Todo配列からli要素を作るコンポーネントです
function TodoList() {
return (
<ul>
{todos.map((todo) => (
// Todoの内容をli要素に表示します
<li key={todo.id}>
{todo.title}
</li>
))}
</ul>
);
}JSXtodos.map(...)は、配列の各Todoをひとつずつ受け取り、<li>に変換しています。配列の中にあるデータを、同じ構造の画面要素として並べるのがmap()の基本的な使い方です。
4. keyの役割
keyは、一覧の項目をReactが識別するための目印です。Todoの追加・削除・並べ替えがあったとき、Reactが「どの項目が変わったのか」を正しく把握するのに使います。(🔗 react.dev)
データに安定したIDがある場合は、そのIDを使います。
// データに含まれるidをkeyとして使います
<li key={todo.id}>{todo.title}</li>JSX配列の番号をkeyにする方法は、項目の追加や削除、並べ替えがある一覧では避けましょう。位置がずれると、Reactが項目を対応づけにくくなることがあるためです。また、Math.random()などでレンダーのたびに異なる値を作るのも避けます。(🔗 react.dev)
5. filter()で表示対象を絞る
filter()は、条件に合った項目だけを含む新しい配列を返します。たとえば、未完了のTodoだけを表示する場合は、completedがfalseのものを残します。
// 未完了のTodoだけを取り出します
const activeTodos = todos.filter((todo) => {
// 未完了なら、このTodoを新しい配列に残します
return todo.completed === false;
});JSX完了済みのTodoだけを取り出す場合は、条件を反対にします。
// 完了済みのTodoだけを取り出します
const completedTodos = todos.filter((todo) => {
// completedがtrueのTodoを残します
return todo.completed === true;
});JSX実際の画面では、「すべて」「未完了」「完了済み」を選べるようにします。
6. Todo一覧アプリを作る
次のコードをapp/page.jsまたはsrc/app/page.jsに記述します。Todoの追加、完了切り替え、削除、絞り込み、空のときの表示まで含んでいます。
// このファイルをClient Componentとして扱います
"use client";
// Reactの状態管理機能を読み込みます
import { useState } from "react";
// Todo一覧アプリのページです
export default function TodoPage() {
// 最初に表示するTodoの配列をStateとして管理します
const [todos, setTodos] = useState([
{
id: 1,
title: "Reactのリスト表示を学ぶ",
completed: false,
},
{
id: 2,
title: "map()でTodoを表示する",
completed: true,
},
{
id: 3,
title: "keyの役割を確認する",
completed: false,
},
]);
// 入力欄の文字を管理します
const [newTitle, setNewTitle] = useState("");
// 一覧の表示条件を管理します
const [filter, setFilter] = useState("all");
// 新しく追加するTodoに使うIDを管理します
const [nextId, setNextId] = useState(4);
// フィルター条件に合うTodoだけを取り出します
const visibleTodos = todos.filter((todo) => {
// "active"なら未完了のTodoだけを表示します
if (filter === "active") {
return todo.completed === false;
}
// "completed"なら完了済みのTodoだけを表示します
if (filter === "completed") {
return todo.completed === true;
}
// "all"ならすべてのTodoを表示します
return true;
});
// フォーム送信時にTodoを追加します
function handleSubmit(event) {
// フォーム標準のページ再読み込みを止めます
event.preventDefault();
// 前後の空白を取り除いた入力値を作ります
const trimmedTitle = newTitle.trim();
// 空欄だけのTodoは追加せずに終了します
if (trimmedTitle === "") {
return;
}
// 入力内容から新しいTodoを作ります
const newTodo = {
id: nextId,
title: trimmedTitle,
completed: false,
};
// 元の配列を直接変更せず、新しい配列を作ります
setTodos((currentTodos) => [...currentTodos, newTodo]);
// 次に使うIDを1増やします
setNextId((currentId) => currentId + 1);
// 入力欄を空に戻します
setNewTitle("");
}
// 指定されたTodoの完了状態を切り替えます
function handleToggle(todoId) {
// map()で新しい配列を作り、対象のTodoだけ更新します
setTodos((currentTodos) =>
currentTodos.map((todo) => {
// 対象外のTodoはそのまま返します
if (todo.id !== todoId) {
return todo;
}
// 対象のTodoは新しいオブジェクトとして返します
return {
...todo,
completed: !todo.completed,
};
})
);
}
// 指定されたTodoを削除します
function handleDelete(todoId) {
// 対象ID以外のTodoで新しい配列を作ります
setTodos((currentTodos) =>
currentTodos.filter((todo) => todo.id !== todoId)
);
}
// Todo追加フォームと一覧を表示します
return (
<main>
<h1>Todo一覧</h1>
{/* Todoを追加するフォームです */}
<form onSubmit={handleSubmit}>
<label htmlFor="todo-title">新しいTodo</label>
{/* 入力欄の値をStateと同期させます */}
<input
id="todo-title"
type="text"
value={newTitle}
onChange={(event) => setNewTitle(event.target.value)}
maxLength={100}
placeholder="例:Reactの復習をする"
/>
{/* クリックまたはEnterキーでフォームを送信します */}
<button type="submit">追加</button>
</form>
{/* 表示するTodoの種類を選びます */}
<div>
<label htmlFor="todo-filter">表示するTodo</label>
{/* 選択内容をfilterのStateに保存します */}
<select
id="todo-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">
表示中:{visibleTodos.length}件
</p>
{/* 条件に合うTodoがある場合だけリストを表示します */}
{visibleTodos.length > 0 ? (
<ul>
{visibleTodos.map((todo) => (
// 安定したtodo.idをkeyとして指定します
<li key={todo.id}>
{/* チェックボックスで完了状態を切り替えます */}
<label>
<input
type="checkbox"
checked={todo.completed}
onChange={() => handleToggle(todo.id)}
/>
{/* 完了したTodoに取り消し線を表示します */}
<span
style={{
textDecoration: todo.completed
? "line-through"
: "none",
}}
>
{todo.title}
</span>
</label>
{/* このTodoを削除します */}
<button
type="button"
onClick={() => handleDelete(todo.id)}
aria-label={`${todo.title}を削除`}
>
削除
</button>
</li>
))}
</ul>
) : (
// 一致するTodoがないときの案内です
<p>表示できるTodoはありません。</p>
)}
</main>
);
}JSX7. アプリの動きを確認する
ページを開いたら、次の操作を試してください。
- 最初のTodoが3件表示されることを確認します。
- 入力欄にTodoを入力して「追加」を押します。
- 追加したTodoにチェックを入れ、完了状態が切り替わることを確認します。
- 「未完了」を選び、未完了のTodoだけが表示されることを確認します。
- 「完了済み」を選び、完了したTodoだけが表示されることを確認します。
- Todoを削除し、一覧から消えることを確認します。
- 表示条件に合うTodoがない場合、案内文が表示されることを確認します。
8. コードの重要部分を理解する
filter()で絞り込み、map()で表示する
完成版では、まずfilter()で表示対象を決め、その結果をmap()で画面要素にしています。
// 条件に合うTodoだけを取得します
const visibleTodos = todos.filter((todo) => {
return filter === "all" || todo.completed === false;
});
// 絞り込んだTodoをli要素に変換します
{visibleTodos.map((todo) => (
<li key={todo.id}>{todo.title}</li>
))}JSXfilter()とmap()は役割が違います。filter()はどのデータを残すかを決め、map()はデータを何に変換するかを決めます。Reactで一覧を作るときは、この組み合わせをよく使います。(🔗 react.dev)
状態を直接変更しない
Todoの追加では、push()で現在の配列を直接変更せず、スプレッド構文で新しい配列を作っています。
// 元の配列を変更せず、新しい配列へTodoを追加します
setTodos((currentTodos) => [...currentTodos, newTodo]);JSX完了状態の切り替えでは、map()で新しい配列を作り、対象のTodoだけ新しいオブジェクトを返します。削除では、filter()で対象以外のTodoから新しい配列を作ります。こうした更新方法はイミュータブルな更新と呼ばれます。
9. 条件付き表示の使い分け
Todo一覧では、条件に応じて表示を変えています。
- 表示するTodoがある場合は、三項演算子でリストを表示します。
- 表示対象が0件の場合は、案内文を表示します。
- フィルター条件は`filter()`で判定します。
items.length && ...のように書くと、配列が空のときに数字の0が表示される場合があります。件数を条件にする場合は、items.length > 0のように明示すると安全です。
// 1件以上ある場合に限って一覧を表示します
{visibleTodos.length > 0 && <TodoList />}JSX10. keyについてもう少し詳しく
keyはReactが一覧を更新するときの識別用情報です。画面に表示されるHTML属性ではなく、Reactが内部で使います。子コンポーネントにもIDが必要なら、keyとは別にPropsとして渡します。(🔗 react.dev)
// keyはReactが使い、todoIdはコンポーネントが使います
<TodoItem
key={todo.id}
todoId={todo.id}
title={todo.title}
/>JSX今回のようにtodo.idをkeyに使えば、並べ替えや削除があっても各項目を追跡できます。keyは兄弟要素の中で一意であればよく、別の一覧で同じ値を使うことは可能です。
11. よくあるつまずき
map()の中でkeyを付け忘れる:データに含まれる安定したIDを指定します。- 配列の番号を安易に
keyにする:追加・削除・並べ替えがある一覧では、項目固有のIDを使います。 filter()の条件が逆になる:条件関数がtrueを返した要素が残ることを確認します。- Stateの配列を直接変更する:
push()やsplice()で直接変更せず、新しい配列を作ります。 - 空の配列のとき何も案内しない:条件付き表示で「Todoがありません」と伝えます。
- 文字だけのTodoを追加できてしまう:
trim()で空白を除いてから、空文字か確認します。
12. 発展課題
基本が動いたら、次の機能を追加してみましょう。
- 「すべて」「未完了」「完了済み」の件数をそれぞれ表示します。
- Todoを編集できるようにします。
- すべてのTodoを完了にするボタンを作ります。
- 完了済みのTodoをまとめて削除します。
- 検索欄を追加し、Todo名に一致する項目だけを表示します。
- `localStorage`を使い、ページ再読み込み後もTodoを保持します。
localStorageへ保存する場合は、ブラウザーだけで扱うデータであることを理解し、パスワードや秘密情報などを保存しないでください。
13. Day 19のチェックリスト
map()で配列をJSXのリストに変換できます。- 一覧の各項目に、安定したIDを使った
keyを指定できます。 filter()で表示する項目だけを取り出せます。- 完了状態に応じてTodoを絞り込めます。
- 配列を直接変更せず、新しい配列でStateを更新できます。
- 表示結果が0件のとき、案内を表示できます。
Todo一覧では、データをfilter()で絞り込み、map()で画面に変換し、keyで各項目を識別します。追加・完了切り替え・削除を通して、ReactのStateを直接変更せずに更新する方法も練習しました。この流れは、商品一覧や検索結果、コメント一覧など、さまざまなリスト表示に応用できます。
