Next.jsで学ぶReact講座 90日コース | React基礎 - Day 25:React総合演習

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

Day 25:React総合演習でタスク管理アプリを作る

この日は、これまで学んだState、フォーム、イベント処理、リスト表示、条件付きレンダリング、コンポーネント設計を組み合わせて、タスク管理アプリを作ります。

完成するアプリでは、タスクの追加・表示・編集・削除に加えて、検索、カテゴリー絞り込み、完了状態の切り替え、LocalStorageへの保存を実装します。

  • CRUD:タスクの追加(Create)、表示(Read)、更新(Update)、削除(Delete)を行います。
  • フィルター:すべて・未完了・完了済みで絞り込みます。
  • 検索:タスク名から探します。
  • カテゴリー:カテゴリーを選んで絞り込みます。
  • LocalStorage:同じブラウザーでページを再読み込みしてもタスクを残します。

このアプリは学習用として、タスクを利用者のブラウザーに保存します。複数端末での同期や、サーバーへの共有機能はありません。

1. データの形を決める

まず、タスク1件をどのようなデータで表すか決めます。

// タスク1件を表すデータの例です
const task = {
  id: "task-example-1",
  title: "Reactの総合演習をする",
  category: "study",
  completed: false,
  createdAt: 1730000000000,
};
JavaScript
  • id:タスクを区別するためのIDです。
  • title:タスクの内容です。
  • category:タスクのカテゴリーです。
  • completed:完了済みかどうかを表します。
  • createdAt:作成時刻を数値で保存します。

タスクは、このオブジェクトを複数まとめた配列としてStateで管理します。タスク数や検索結果は、元の配列から計算します。別のStateにも同じ情報を保存すると、更新漏れで値が食い違うことがあるためです。

2. LocalStorageとは

localStorageは、ブラウザーに文字列を保存する仕組みです。ページを再読み込みしてもデータが残りますが、値は文字列として保存されるため、オブジェクトや配列はJSON.stringify()で文字列にして保存し、読み込むときはJSON.parse()で戻します。

// オブジェクトをJSON文字列に変換して保存します
localStorage.setItem("sample", JSON.stringify({ message: "こんにちは" }));

// 保存した文字列を取得します
const savedValue = localStorage.getItem("sample");

// JSON文字列をJavaScriptの値に戻します
const data = savedValue ? JSON.parse(savedValue) : null;
JavaScript

Next.jsではClient Componentも最初のページ表示時にサーバー側でHTMLとして描画される場合があります。サーバーにはlocalStorageがないため、初期描画で直接読み込むとエラーやHydrationの不一致につながることがあります。今回は初期値をサーバーとブラウザーで同じにし、useEffectでブラウザー上に表示された後にLocalStorageを読み込みます。(🔗 nextjs.org) (🔗 react.dev)

3. Next.jsのファイルを用意する

App Routerの場合、ページファイルはapp/page.jsまたはsrc/app/page.jsです。今回の例は1つのファイルで完成させます。

my-app/
└── app/
    └── page.js

srcフォルダーを使っている場合はsrc/app/page.jsに書いてください。useState、useEffect、ブラウザーのlocalStorageを使うため、ファイルの先頭に'use client'を置きます。ブラウザーAPIが必要な部分はClient ComponentにするのがNext.jsの基本です。(🔗 nextjs.org)

4. 完成コード

以下をapp/page.jsまたはsrc/app/page.jsに記述します。追加、編集、削除、検索、カテゴリー、完了状態、LocalStorage保存を含む一通りの実装です。

// このファイルをClient Componentとして扱います
"use client";

// ReactのState、Effect、Ref、メモ化機能を読み込みます
import { useEffect, useMemo, useRef, useState } from "react";

// LocalStorageに保存するときのキーです
const STORAGE_KEY = "day25-task-manager";

// 使用できるカテゴリーの一覧です
const CATEGORIES = [
  { value: "work", label: "仕事" },
  { value: "study", label: "学習" },
  { value: "personal", label: "プライベート" },
];

// 初期フォームの値を返す関数です
function createEmptyForm() {
  return {
    title: "",
    category: "study",
  };
}

// 保存データがタスク配列として扱えるかを確認します
function isValidTaskList(value) {
  // 配列でなければタスク一覧として扱いません
  if (!Array.isArray(value)) {
    return false;
  }

  // 各要素に必要な型がそろっているか確認します
  return value.every((task) => {
    return (
      task !== null &&
      typeof task === "object" &&
      typeof task.id === "string" &&
      typeof task.title === "string" &&
      typeof task.category === "string" &&
      typeof task.completed === "boolean" &&
      typeof task.createdAt === "number"
    );
  });
}

// タスク管理アプリです
export default function TaskManagerPage() {
  // タスク一覧をStateで管理します
  const [tasks, setTasks] = useState([]);

  // LocalStorageからの読み込みが終わったかを管理します
  const [isReady, setIsReady] = useState(false);

  // 新規タスクフォームの内容を管理します
  const [form, setForm] = useState(createEmptyForm);

  // 編集中のタスクIDを管理します
  const [editingId, setEditingId] = useState(null);

  // 編集中の入力値を管理します
  const [editingTitle, setEditingTitle] = useState("");

  // 検索欄の入力値を管理します
  const [searchQuery, setSearchQuery] = useState("");

  // 完了状態のフィルターを管理します
  const [statusFilter, setStatusFilter] = useState("all");

  // カテゴリーフィルターを管理します
  const [categoryFilter, setCategoryFilter] = useState("all");

  // 入力エラーや操作結果の案内を管理します
  const [message, setMessage] = useState("");

  // 初回読み込み後に保存を有効にするための目印です
  const hasLoadedRef = useRef(false);

  // 初回表示後、ブラウザー上でLocalStorageからタスクを読み込みます
  useEffect(() => {
    try {
      // 保存済みのJSON文字列を取得します
      const savedText = window.localStorage.getItem(STORAGE_KEY);

      // 保存データがあればJSONとして読み込みます
      if (savedText !== null) {
        const savedTasks = JSON.parse(savedText);

        // 読み込んだデータの形を確認してから使います
        if (isValidTaskList(savedTasks)) {
          setTasks(savedTasks);
        } else {
          // 形式が違うデータをアプリで使わないよう案内します
          setMessage("保存データの形式が異なるため、空の一覧から開始しました。");
        }
      }
    } catch {
      // JSON解析やLocalStorage利用に失敗した場合の案内です
      setMessage("保存データを読み込めませんでした。");
    } finally {
      // 読み込み処理が完了したことを記録します
      hasLoadedRef.current = true;
      setIsReady(true);
    }
  }, []);

  // LocalStorageからの読み込み完了後に、タスク変更を保存します
  useEffect(() => {
    // 読み込み前の空配列で既存データを上書きしないようにします
    if (!hasLoadedRef.current) {
      return;
    }

    try {
      // タスク配列をJSON文字列にして保存します
      window.localStorage.setItem(STORAGE_KEY, JSON.stringify(tasks));
    } catch {
      // 保存容量やブラウザー設定などによる失敗を案内します
      setMessage("タスクをブラウザーに保存できませんでした。");
    }
  }, [tasks]);

  // 検索とフィルターに合うタスク一覧を計算します
  const visibleTasks = useMemo(() => {
    // 検索語を小文字にして比較しやすくします
    const normalizedQuery = searchQuery.trim().toLocaleLowerCase();

    // 各条件に合うタスクだけを残します
    return tasks.filter((task) => {
      // タイトルに検索語が含まれるか確認します
      const matchesSearch = task.title
        .toLocaleLowerCase()
        .includes(normalizedQuery);

      // 完了状態のフィルターを確認します
      const matchesStatus =
        statusFilter === "all" ||
        (statusFilter === "active" && !task.completed) ||
        (statusFilter === "completed" && task.completed);

      // カテゴリーのフィルターを確認します
      const matchesCategory =
        categoryFilter === "all" ||
        task.category === categoryFilter;

      // すべての条件に合うタスクだけ表示します
      return matchesSearch && matchesStatus && matchesCategory;
    });
  }, [tasks, searchQuery, statusFilter, categoryFilter]);

  // 未完了タスク数をタスク一覧から計算します
  const remainingCount = tasks.filter((task) => {
    return !task.completed;
  }).length;

  // 新規タスクフォームの入力を更新します
  function handleFormChange(event) {
    // 変更された入力欄のnameとvalueを取得します
    const { name, value } = event.target;

    // 既存フォームの他の値を保って、変更項目だけ更新します
    setForm((currentForm) => ({
      ...currentForm,
      [name]: value,
    }));
  }

  // 新しいタスクを追加します
  function handleAddTask(event) {
    // ブラウザー標準のフォーム送信を止めます
    event.preventDefault();

    // タスク名の前後の空白を取り除きます
    const title = form.title.trim();

    // 空のタスク名は追加しません
    if (title === "") {
      setMessage("タスク名を入力してください。");
      return;
    }

    // 文字数の上限を確認します
    if (title.length > 100) {
      setMessage("タスク名は100文字以内で入力してください。");
      return;
    }

    // ブラウザー上の操作時に新しいタスクを作ります
    const newTask = {
      // IDは表示時ではなくイベント処理の中で作ります
      id: window.crypto.randomUUID(),
      title,
      category: form.category,
      completed: false,
      createdAt: Date.now(),
    };

    // 既存配列を直接変更せず、新しい配列に追加します
    setTasks((currentTasks) => [...currentTasks, newTask]);

    // フォームを初期状態に戻します
    setForm(createEmptyForm());

    // 前回の案内を消します
    setMessage("");
  }

  // 指定したタスクの完了状態を切り替えます
  function handleToggleTask(taskId) {
    // map()で新しい配列を作り、対象だけ更新します
    setTasks((currentTasks) =>
      currentTasks.map((task) => {
        // 対象でないタスクはそのまま返します
        if (task.id !== taskId) {
          return task;
        }

        // 対象タスクのコピーを作り、完了状態を反転します
        return {
          ...task,
          completed: !task.completed,
        };
      })
    );

    // 操作後に古い案内を消します
    setMessage("");
  }

  // タスクの編集を開始します
  function handleStartEdit(task) {
    // 編集対象のIDを保存します
    setEditingId(task.id);

    // 現在のタスク名を編集欄に入れます
    setEditingTitle(task.title);

    // 前回の案内を消します
    setMessage("");
  }

  // タスク名の編集内容を保存します
  function handleSaveEdit(event, taskId) {
    // フォームの再読み込みを防ぎます
    event.preventDefault();

    // 入力の前後の空白を取り除きます
    const title = editingTitle.trim();

    // 空のタスク名は保存しません
    if (title === "") {
      setMessage("タスク名を空にすることはできません。");
      return;
    }

    // タスク名の文字数を確認します
    if (title.length > 100) {
      setMessage("タスク名は100文字以内で入力してください。");
      return;
    }

    // 対象タスクだけを新しいオブジェクトに更新します
    setTasks((currentTasks) =>
      currentTasks.map((task) =>
        task.id === taskId ? { ...task, title } : task
      )
    );

    // 編集状態を解除します
    setEditingId(null);
    setEditingTitle("");

    // 案内を消します
    setMessage("");
  }

  // 指定したタスクを削除します
  function handleDeleteTask(taskId) {
    // 対象以外のタスクから新しい配列を作ります
    setTasks((currentTasks) =>
      currentTasks.filter((task) => task.id !== taskId)
    );

    // 削除したタスクを編集中なら編集状態を解除します
    if (editingId === taskId) {
      setEditingId(null);
      setEditingTitle("");
    }

    // 古い案内を消します
    setMessage("");
  }

  // 画面を表示します
  return (
    <main className="task-app">
      <h1>タスク管理アプリ</h1>
      <p>タスクを登録し、検索やカテゴリーで整理できます。</p>

      {/* LocalStorage読み込み中は状態が確定するまで案内します */}
      {!isReady ? (
        <p aria-live="polite">保存済みのタスクを読み込んでいます...</p>
      ) : (
        <>
          {/* タスクを追加するフォームです */}
          <section aria-labelledby="add-heading">
            <h2 id="add-heading">タスクを追加</h2>

            <form onSubmit={handleAddTask}>
              <label htmlFor="new-title">タスク名</label>
              <input
                id="new-title"
                name="title"
                type="text"
                value={form.title}
                onChange={handleFormChange}
                maxLength={100}
                placeholder="例:Reactの復習をする"
              />

              <label htmlFor="new-category">カテゴリー</label>
              <select
                id="new-category"
                name="category"
                value={form.category}
                onChange={handleFormChange}
              >
                {CATEGORIES.map((category) => (
                  // カテゴリー値をReactのkeyに使います
                  <option key={category.value} value={category.value}>
                    {category.label}
                  </option>
                ))}
              </select>

              <button type="submit">追加</button>
            </form>
          </section>

          {/* 検索とフィルターの操作欄です */}
          <section aria-labelledby="filter-heading">
            <h2 id="filter-heading">検索・絞り込み</h2>

            <label htmlFor="search-query">タスク名で検索</label>
            <input
              id="search-query"
              type="search"
              value={searchQuery}
              onChange={(event) => setSearchQuery(event.target.value)}
              placeholder="タスク名を入力"
            />

            <label htmlFor="status-filter">完了状態</label>
            <select
              id="status-filter"
              value={statusFilter}
              onChange={(event) => setStatusFilter(event.target.value)}
            >
              <option value="all">すべて</option>
              <option value="active">未完了</option>
              <option value="completed">完了済み</option>
            </select>

            <label htmlFor="category-filter">カテゴリー</label>
            <select
              id="category-filter"
              value={categoryFilter}
              onChange={(event) => setCategoryFilter(event.target.value)}
            >
              <option value="all">すべて</option>
              {CATEGORIES.map((category) => (
                // 各カテゴリーを選択肢として表示します
                <option key={category.value} value={category.value}>
                  {category.label}
                </option>
              ))}
            </select>
          </section>

          {/* タスク数を表示します */}
          <section aria-label="タスク数">
            <p>全タスク:{tasks.length}件</p>
            <p>未完了:{remainingCount}件</p>
            <p>表示中:{visibleTasks.length}件</p>
          </section>

          {/* 入力や保存に関する案内を表示します */}
          <p aria-live="polite">{message}</p>

          {/* 表示対象のタスクがあれば一覧を作ります */}
          {visibleTasks.length > 0 ? (
            <ul className="task-list">
              {visibleTasks.map((task) => {
                // タスクのカテゴリー名を画面表示用に探します
                const categoryLabel =
                  CATEGORIES.find(
                    (category) => category.value === task.category
                  )?.label ?? "その他";

                return (
                  // 安定したタスクIDをkeyに指定します
                  <li className="task-item" key={task.id}>
                    {editingId === task.id ? (
                      // 編集中はタスク名を入力欄にします
                      <form
                        onSubmit={(event) =>
                          handleSaveEdit(event, task.id)
                        }
                      >
                        <label htmlFor={`edit-${task.id}`}>
                          タスク名を編集
                        </label>
                        <input
                          id={`edit-${task.id}`}
                          type="text"
                          value={editingTitle}
                          onChange={(event) =>
                            setEditingTitle(event.target.value)
                          }
                          maxLength={100}
                        />
                        <button type="submit">保存</button>
                        <button
                          type="button"
                          onClick={() => {
                            // 編集を取り消して元の表示に戻します
                            setEditingId(null);
                            setEditingTitle("");
                          }}
                        >
                          キャンセル
                        </button>
                      </form>
                    ) : (
                      // 通常時は完了チェック、タスク名、操作を表示します
                      <>
                        <label className="task-row">
                          <input
                            type="checkbox"
                            checked={task.completed}
                            onChange={() => handleToggleTask(task.id)}
                          />

                          <span
                            className={
                              task.completed
                                ? "task-title task-title--completed"
                                : "task-title"
                            }
                          >
                            {task.title}
                          </span>
                        </label>

                        <span className="task-category">
                          {categoryLabel}
                        </span>

                        <div className="task-actions">
                          <button
                            type="button"
                            onClick={() => handleStartEdit(task)}
                            aria-label={`${task.title}を編集`}
                          >
                            編集
                          </button>
                          <button
                            type="button"
                            onClick={() => handleDeleteTask(task.id)}
                            aria-label={`${task.title}を削除`}
                          >
                            削除
                          </button>
                        </div>
                      </>
                    )}
                  </li>
                );
              })}
            </ul>
          ) : (
            // タスクがない場合と絞り込み結果がない場合を分けて案内します
            <p>
              {tasks.length === 0
                ? "タスクはまだありません。最初のタスクを追加しましょう。"
                : "条件に一致するタスクはありません。"}
            </p>
          )}
        </>
      )}
    </main>
  );
}
JSX

5. CRUDをコードに対応させる

CRUDは、データを作成・取得・更新・削除する基本操作です。このアプリでは次のように実装しています。

  • Create(追加):`handleAddTask`で新しいタスクを配列に追加します。
  • Read(表示):`visibleTasks.map()`で画面に一覧表示します。
  • Update(更新):`handleToggleTask`で完了状態を変え、`handleSaveEdit`でタスク名を編集します。
  • Delete(削除):`handleDeleteTask`で対象以外のタスクから新しい配列を作ります。

どの操作でもStateの配列を直接書き換えず、setTasksに新しい配列を渡しています。これをイミュータブルな更新と呼びます。

6. 検索と複数フィルター

検索結果は、タスク一覧から検索語・完了状態・カテゴリーのすべてに合うものをfilter()で選んで作っています。

// 検索語、完了状態、カテゴリーに合うタスクだけを残します
const visibleTasks = tasks.filter((task) => {
  const matchesSearch = task.title
    .toLocaleLowerCase()
    .includes(searchQuery.trim().toLocaleLowerCase());

  const matchesStatus =
    statusFilter === "all" ||
    (statusFilter === "active" && !task.completed) ||
    (statusFilter === "completed" && task.completed);

  const matchesCategory =
    categoryFilter === "all" ||
    task.category === categoryFilter;

  return matchesSearch && matchesStatus && matchesCategory;
});
JSX

表示するタスクだけを別のStateに保存するのではなく、元のtasksから計算しています。元データと表示結果を分けておくと、検索やフィルターを変更してもタスクそのものは失われません。

7. LocalStorageの読み込みと保存

このアプリでは、初回表示後のuseEffectでLocalStorageを読み込みます。その後、タスクが変わるたびに別のuseEffectで保存します。EffectはReactの外にある仕組みとの同期に適しており、LocalStorageの読み書きもその例です。(🔗 react.dev)

特に重要なのは、保存済みタスクを読み込む前に空の配列を保存しないことです。初期Stateの[]を先に保存すると、以前のタスクを上書きしてしまう可能性があります。コードではhasLoadedRefを使い、読み込み完了後だけ保存しています。

LocalStorageへのアクセスは、ブラウザーの設定や保存容量などの事情で失敗することがあります。そのため、読み込みと保存の両方をtry...catchで囲み、失敗を画面に案内しています。

8. LocalStorageを使うときのセキュリティ注意

LocalStorageは、秘密情報や重要な個人情報を保管するための安全な保管庫ではありません。同じブラウザーで動くスクリプトから読み取られる可能性があり、利用者自身も内容を確認・変更できます。

  • パスワード、認証トークン、秘密鍵などを保存しないでください。
  • LocalStorageの内容を信頼できるデータとして扱わず、読み込み時に形式を確認します。
  • このアプリのタスクはブラウザー内のデータであり、別の端末には自動で共有されません。
  • 重要なデータを複数人で共有するアプリでは、サーバー側の保存とアクセス制御を設計します。

このサンプルではisValidTaskList()で保存データの基本的な形を確認しています。ただし、これはデータ形式の確認であって、認証やアクセス制御ではありません。

9. テストの手順

完成したら、次の順で動作を確認してください。

  • タスク名を入力し、カテゴリーを選んで追加します。
  • 空欄や空白だけの入力では追加されないことを確認します。
  • タスクを完了にし、未完了数が減ることを確認します。
  • 編集して保存し、タスク名が変わることを確認します。
  • 編集をキャンセルし、元の表示に戻ることを確認します。
  • カテゴリーを選び、そのカテゴリーのタスクだけが表示されることを確認します。
  • 完了状態のフィルターと検索を組み合わせて試します。
  • タスクを削除し、件数が更新されることを確認します。
  • ページを再読み込みし、保存済みタスクが読み込まれることを確認します。

10. コンポーネント分割への発展

完成コードは仕組みを追いやすくするため、1つのページファイルにまとめています。コードが大きくなってきたら、役割に合わせて分割できます。

  • TaskForm:新しいタスクの追加フォームを担当します。
  • TaskFilters:検索欄とフィルターを担当します。
  • TaskList:表示対象の一覧を担当します。
  • TaskItem:タスク1件の表示、完了、編集、削除を担当します。
  • TaskManagerPage:Stateと操作処理をまとめ、各部品へPropsを渡します。

まず1ファイルで動かし、その後に責務ごとに分割すると、処理の流れとPropsの関係を理解しやすくなります。

11. よくあるつまずき

  • ページ再読み込みで保存データが消える:LocalStorageへの保存Effectが動いているか、ブラウザーの開発者ツールで確認します。
  • 読み込み直後に保存データが消える:LocalStorageの読み込み完了前に初期配列を保存していないか確認します。
  • Next.jsで`localStorage is not defined`になる:レンダー中に直接アクセスせず、ブラウザーで動くEffectやイベント処理の中で使います。
  • 検索条件を変えるとタスクが消える:元の`tasks`ではなく、表示用の`visibleTasks`だけを絞り込んでいるか確認します。
  • 編集した内容が反映されない:対象タスクのIDと一致する要素だけ、新しいオブジェクトに置き換えているか確認します。
  • カテゴリーを増やしたら選択肢と表示名がずれる:`CATEGORIES`の値を追加し、追加フォームとフィルターの両方で同じ定義を使います。
  • 保存データが壊れてアプリが止まる:`JSON.parse()`を`try…catch`で扱い、保存データの形式も確認します。

12. Day 25のチェックリスト

  • タスクを追加・表示・編集・削除できます。
  • 完了状態を切り替えられます。
  • 検索語、完了状態、カテゴリーを組み合わせて絞り込めます。
  • 全タスク数、未完了数、表示中の件数を確認できます。
  • 配列やオブジェクトを直接変更せずにStateを更新できます。
  • LocalStorageから読み込み、タスク変更時に保存できます。
  • ブラウザー専用APIをレンダー中に使わず、初期描画の違いを避けられます。
  • LocalStorageにパスワードや認証情報を保存してはいけないと理解しています。

このアプリは、タスクのStateを中心に、フォーム、CRUD、検索、フィルター、条件付き表示、ブラウザー保存を組み合わせています。コードが動いたら、タスクをいくつか追加して操作を一つずつ確かめてください。その後、表示部分をコンポーネントに分割すれば、Day 23・24で学んだ設計と状態共有も実践できます。

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