Next.jsで学ぶReact講座 90日コース | React基礎 - Day 20:Reactミニアプリ①

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

Day 20:Reactミニアプリ① Todoアプリ

この日は、これまで学んだuseState、イベント処理、フォーム、map()、filter()、条件付きレンダリングを組み合わせてTodoアプリを作ります。

  • タスクを追加します。
  • タスクの完了・未完了を切り替えます。
  • タスクを削除します。
  • 「すべて」「未完了」「完了済み」で表示を絞り込みます。
  • 全タスク数と未完了タスク数を表示します。

今回は、まず機能が分かりやすいように1つのページファイルで作ります。完成したあとでコンポーネントに分割する練習もできます。

1. Todoのデータを考える

Todo1件を、次のようなオブジェクトで表します。

// Todo1件分のデータ例です
const task = {
  id: "task-001",
  title: "Reactの復習をする",
  completed: false,
};
JavaScript
  • idは、タスクを区別するための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>
  );
}
JSX

4. アプリを順番に動かす

ページを表示したら、次の操作を試します。

  • 何も登録されていないときの案内が表示されることを確認します。
  • 入力欄にタスクを入力し、「追加」を押します。
  • 入力欄にフォーカスした状態で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]);
JSX

6. 完了状態を切り替える仕組み

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で一覧を扱うときの基本パターンです。まずは各機能を動かし、次にコンポーネント分割や保存機能へ進んでみましょう。

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