Next.jsで学ぶReact講座 90日コース | React基礎 - Day 19:リスト表示

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

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,
};
JavaScript
  • id: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>
  );
}
JSX

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

7. アプリの動きを確認する

ページを開いたら、次の操作を試してください。

  • 最初の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>
))}
JSX

filter()と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 />}
JSX

10. 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を直接変更せずに更新する方法も練習しました。この流れは、商品一覧や検索結果、コメント一覧など、さまざまなリスト表示に応用できます。

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