Next.jsで学ぶReact講座 90日コース | React実践力を身につける - Day 34:React実践アプリ②

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

Day 34:月別集計・フィルター・LocalStorage保存を追加する

Day 34では、Day 33で作った家計簿アプリに、LocalStorageへの保存、月別集計、取引のフィルターを追加します。ページを再読み込みしても取引を残し、選択した月の収入・支出を確認できるようにします。

この説明はDay 33のファイル構成を引き継ぎます。TransactionFormとTransactionListはそのまま利用し、保存処理をservicesとhooksに、絞り込みや月別集計をutilsに分けます。

1. 今日追加する機能

  • LocalStorage保存:取引をブラウザーに保存し、再読み込み後も読み込みます。
  • 月選択:表示・集計したい年月を選びます。
  • 種類フィルター:すべて・収入・支出で一覧を絞り込みます。
  • カテゴリー絞り込み:選択したカテゴリーの取引だけを表示します。
  • 月別集計:選択した月の収入・支出・差額を表示します。

ここでは、合計金額は選択した月の全取引から計算し、フィルターは一覧だけに適用します。たとえば「食費だけを表示」しても、月の支出合計は住居費なども含めたままです。集計もフィルターに連動させたい場合は、集計対象を同じ絞り込み結果に変更します。

2. LocalStorageの読み込み順に注意する

LocalStorageはブラウザーにある機能で、サーバー上にはありません。Next.jsでは、ページのレンダー中にLocalStorageを読み込まず、useEffectでブラウザーに表示された後に読み込みます。

また、読み込む前に空の配列を保存すると、以前のデータを上書きしてしまうことがあります。そこで、読み込みが終わってから保存するようにします。データ形式が壊れていて読み込みに失敗したときも、空配列で上書きしないようにします。

3. 取引データの型を確認する

Day 33で作ったsrc/types/ledger.tsを使います。まだ作っていない場合は、次の型を作成してください。

// 収入と支出を表します
export type TransactionType = "income" | "expense";

// 取引で利用するカテゴリーを表します
export type TransactionCategory =
  | "salary"
  | "other-income"
  | "food"
  | "transport"
  | "housing"
  | "utilities"
  | "shopping"
  | "other-expense";

// 取引1件のデータです
export type Transaction = {
  id: string;
  type: TransactionType;
  amount: number;
  category: TransactionCategory;
  date: string;
  memo: string;
  createdAt: number;
};

// 新規登録時の入力データです
export type NewTransaction = Omit<Transaction, "id" | "createdAt">;

// 一覧表示に使うフィルター条件です
export type TransactionFilters = {
  month: string;
  type: TransactionType | "all";
  category: TransactionCategory | "all";
};
TypeScript

TypeScriptの型は、コードを書くときに値の形を確認するためのものです。LocalStorageから読み込んだ値が正しい形かどうかは、実行時に別途確認します。

4. servicesにLocalStorageの処理を作る

src/services/transactionStorage.tsを作ります。このファイルは、取引の読み込みと保存を担当します。

<em>// 取引データの型を読み込みます</em>
import type {
  Transaction,
  TransactionCategory,
} from "../types/ledger";

<em>// 保存に使うLocalStorageのキーです</em>
const STORAGE_KEY = "day33-35-ledger-transactions";

<em>// 利用できるカテゴリーを実行時にも確認できるようにします</em>
const VALID_CATEGORIES: TransactionCategory[] = [
  "salary",
  "other-income",
  "food",
  "transport",
  "housing",
  "utilities",
  "shopping",
  "other-expense",
];

<em>// 保存データ1件が取引の形式か確認します</em>
function isTransaction(value: unknown): value is Transaction {
  <em>// nullや配列など、通常のオブジェクトでない値を除外します</em>
  if (typeof value !== "object" || value === null) {
    return false;
  }

  <em>// プロパティを安全に確認できる形にします</em>
  const item = value as Record<string, unknown>;

  <em>// 日付が「年-月-日」の形か確認する簡易パターンです</em>
  const isDateFormat =
    typeof item.date === "string" &&
    /^\d{4}-\d{2}-\d{2}$/.test(item.date);

  <em>// 必要な項目の型と値を確認します</em>
  return (
    typeof item.id === "string" &&
    (item.type === "income" || item.type === "expense") &&
    typeof item.amount === "number" &&
    Number.isSafeInteger(item.amount) &&
    item.amount > 0 &&
    typeof item.category === "string" &&
    VALID_CATEGORIES.includes(item.category as TransactionCategory) &&
    isDateFormat &&
    typeof item.memo === "string" &&
    typeof item.createdAt === "number" &&
    Number.isFinite(item.createdAt)
  );
}

<em>// LocalStorageから取引一覧を読み込みます</em>
export function loadTransactions(): Transaction[] {
  <em>// LocalStorageはブラウザー上で呼び出す前提です</em>
  const savedText = window.localStorage.getItem(STORAGE_KEY);

  <em>// 保存データがなければ、空の一覧を返します</em>
  if (savedText === null) {
    return [];
  }

  <em>// JSON文字列をJavaScriptの値に変換します</em>
  const parsed: unknown = JSON.parse(savedText);

  <em>// 保存内容が配列か確認します</em>
  if (!Array.isArray(parsed)) {
    throw new Error("保存データが取引一覧の形式ではありません。");
  }

  <em>// 配列の各要素が取引の形式か確認します</em>
  if (!parsed.every(isTransaction)) {
    throw new Error("保存データに正しくない取引が含まれています。");
  }

  <em>// 検証済みの取引一覧を返します</em>
  return parsed;
}

<em>// 取引一覧をLocalStorageへ保存します</em>
export function saveTransactions(transactions: Transaction[]): void {
  <em>// 配列をJSON文字列にして保存します</em>
  window.localStorage.setItem(
    STORAGE_KEY,
    JSON.stringify(transactions)
  );
}
TypeScript

JSON.parse()は、壊れたJSONを読み込むとエラーになります。また、以前のアプリの形式や手動で変更された値が混じることもあります。ここではエラーを呼び出し元へ伝え、Hook側で扱います。

5. hooksで読み込み・保存をまとめる

src/hooks/useTransactions.tsを作ります。ここでは取引一覧のState、初回読み込み、保存、追加、削除を管理します。

// ReactのStateとEffectを読み込みます
import { useEffect, useState } from "react";

// LocalStorageの読み書き関数を読み込みます
import {
  loadTransactions,
  saveTransactions,
} from "../services/transactionStorage";

// 取引データの型を読み込みます
import type {
  NewTransaction,
  Transaction,
} from "../types/ledger";

// 取引の管理をまとめるカスタムHookです
export function useTransactions() {
  // 取引一覧を管理します
  const [transactions, setTransactions] = useState<Transaction[]>([]);

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

  // 読み込みに成功し、保存してよい状態かを管理します
  const [canSave, setCanSave] = useState(false);

  // 保存や読み込みに関する案内を管理します
  const [storageMessage, setStorageMessage] = useState("");

  // 初回表示後にLocalStorageから取引を読み込みます
  useEffect(() => {
    try {
      // 保存データを読み込みます
      const savedTransactions = loadTransactions();

      // 読み込んだデータをStateに設定します
      setTransactions(savedTransactions);

      // 読み込み成功後に保存を許可します
      setCanSave(true);
    } catch {
      // 読み込みに失敗したことを利用者に伝えます
      setStorageMessage("保存データを読み込めませんでした。");

      // 読み込み失敗時に空配列で上書きしないようにします
      setCanSave(false);
    } finally {
      // 読み込み処理が終了したことを記録します
      setIsReady(true);
    }
  }, []);

  // 読み込み成功後、取引が変わるたびに保存します
  useEffect(() => {
    // 読み込み前や読み込み失敗時には保存しません
    if (!isReady || !canSave) {
      return;
    }

    try {
      // 現在の取引一覧を保存します
      saveTransactions(transactions);

      // 前回の保存エラーを消します
      setStorageMessage("");
    } catch {
      // 保存に失敗した場合の案内です
      setStorageMessage("取引をブラウザーに保存できませんでした。");
    }
  }, [transactions, isReady, canSave]);

  // 新しい取引を追加します
  function addTransaction(input: NewTransaction) {
    // IDと作成時刻を追加し、取引データを完成させます
    const newTransaction: Transaction = {
      ...input,
      id: crypto.randomUUID(),
      createdAt: Date.now(),
    };

    // 既存配列を直接変更せず、新しい配列を作ります
    setTransactions((current) => [newTransaction, ...current]);
  }

  // 指定された取引を削除します
  function deleteTransaction(transactionId: string) {
    // 対象以外の取引から新しい配列を作ります
    setTransactions((current) =>
      current.filter((item) => item.id !== transactionId)
    );
  }

  // ページで使う値と操作関数を返します
  return {
    transactions,
    isReady,
    storageMessage,
    addTransaction,
    deleteTransaction,
  };
}
TypeScript

このHookを使うと、ページ側でLocalStorageの細かな読み書きを書かずに済みます。読み込みに失敗した場合は保存も無効にしているため、読み込めなかった既存データを、空配列でうっかり上書きするのを避けられます。

6. 月別集計とフィルター関数を作る

Day 33のsrc/utils/ledger.tsに関数を追加します。既存のcalculateTotalsとformatYenを残したまま、月別集計と一覧フィルターを追加してください。

// 取引とフィルターの型を読み込みます
import type {
  Transaction,
  TransactionCategory,
  TransactionFilters,
} from "../types/ledger";

// 取引を月・種類・カテゴリーで絞り込みます
export function filterTransactions(
  transactions: Transaction[],
  filters: TransactionFilters
): Transaction[] {
  // すべての条件を満たす取引だけを返します
  return transactions.filter((transaction) => {
    // 取引日の日付文字列から年月を取り出します
    const transactionMonth = transaction.date.slice(0, 7);

    // 選択した月と一致するか確認します
    const matchesMonth =
      filters.month === "" || transactionMonth === filters.month;

    // 収入・支出の条件を確認します
    const matchesType =
      filters.type === "all" || transaction.type === filters.type;

    // カテゴリーの条件を確認します
    const matchesCategory =
      filters.category === "all" ||
      transaction.category === filters.category;

    // すべての条件に一致した取引を表示します
    return matchesMonth && matchesType && matchesCategory;
  });
}

// 指定した月の収入・支出・差額を計算します
export function calculateMonthlyTotals(
  transactions: Transaction[],
  month: string
) {
  // 指定月の取引だけを取り出します
  const monthlyTransactions = transactions.filter((transaction) => {
    return transaction.date.slice(0, 7) === month;
  });

  // 収入の合計を計算します
  const income = monthlyTransactions
    .filter((transaction) => transaction.type === "income")
    .reduce((total, transaction) => total + transaction.amount, 0);

  // 支出の合計を計算します
  const expense = monthlyTransactions
    .filter((transaction) => transaction.type === "expense")
    .reduce((total, transaction) => total + transaction.amount, 0);

  // 収入から支出を引いた差額も返します
  return {
    income,
    expense,
    balance: income - expense,
  };
}

// カテゴリーの値を表示用ラベルへ変換する関数です
export function getCategoryLabel(
  category: TransactionCategory
): string {
  // ここではカテゴリーごとの表示名をまとめます
  const labels: Record<TransactionCategory, string> = {
    salary: "給与",
    "other-income": "その他の収入",
    food: "食費",
    transport: "交通費",
    housing: "住居費",
    utilities: "水道・光熱費",
    shopping: "買い物",
    "other-expense": "その他の支出",
  };

  // カテゴリーに対応する表示名を返します
  return labels[category];
}

// 金額を日本円表示へ変換します
export function formatYen(amount: number): string {
  // 数値を「¥1,200」のような文字列にします
  return new Intl.NumberFormat("ja-JP", {
    style: "currency",
    currency: "JPY",
    maximumFractionDigits: 0,
  }).format(amount);
}
TypeScript

年月をYYYY-MMの形式で保存しているので、取引日YYYY-MM-DDの先頭7文字と比べるだけで月を判定できます。ここでは日付を文字列で扱い、タイムゾーンによる日付のずれを避けています。

7. ページに月別表示とフィルターを追加する

src/app/page.tsxを更新します。Day 33のフォームと一覧コンポーネントは引き続き利用します。

// このページをClient Componentとして扱います
"use client";

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

// 家計簿のフォームと一覧を読み込みます
import TransactionForm from "../components/ledger/TransactionForm";
import TransactionList from "../components/ledger/TransactionList";

// 取引管理Hookを読み込みます
import { useTransactions } from "../hooks/useTransactions";

// 集計・絞り込み・表示関数を読み込みます
import {
  calculateMonthlyTotals,
  filterTransactions,
  formatYen,
} from "../utils/ledger";

// フィルター用の型を読み込みます
import type {
  TransactionCategory,
  TransactionFilters,
  TransactionType,
} from "../types/ledger";

// 現在の年月をブラウザーの現地時刻で作ります
function getCurrentLocalMonth(): string {
  // 現在時刻を取得します
  const now = new Date();

  // 月は0から始まるため、1を足して2桁にします
  const month = String(now.getMonth() + 1).padStart(2, "0");

  // YYYY-MMの形で返します
  return `${now.getFullYear()}-${month}`;
}

// 家計簿アプリのページです
export default function HomePage() {
  // 取引一覧と操作関数をHookから受け取ります
  const {
    transactions,
    isReady,
    storageMessage,
    addTransaction,
    deleteTransaction,
  } = useTransactions();

  // 選択中の月を管理します
  const [selectedMonth, setSelectedMonth] = useState("");

  // 取引種類とカテゴリーのフィルターを管理します
  const [filters, setFilters] = useState<Pick<
    TransactionFilters,
    "type" | "category"
  >>({
    type: "all",
    category: "all",
  });

  // 初回表示後に現在の月を設定します
  useEffect(() => {
    setSelectedMonth(getCurrentLocalMonth());
  }, []);

  // 選択月の収入・支出・差額を計算します
  const monthlyTotals = useMemo(() => {
    // 月が未設定の間は0円の集計を返します
    if (selectedMonth === "") {
      return { income: 0, expense: 0, balance: 0 };
    }

    // 全取引から選択月の集計を作ります
    return calculateMonthlyTotals(transactions, selectedMonth);
  }, [transactions, selectedMonth]);

  // 月・種類・カテゴリーに合う一覧を計算します
  const visibleTransactions = useMemo(() => {
    // 月が未設定なら一覧を空にします
    if (selectedMonth === "") {
      return [];
    }

    // フィルター条件をそろえて絞り込み関数へ渡します
    const result = filterTransactions(transactions, {
      month: selectedMonth,
      type: filters.type,
      category: filters.category,
    });

    // 日付の新しい順に並べます
    return [...result].sort((a, b) => {
      return b.date.localeCompare(a.date);
    });
  }, [transactions, selectedMonth, filters]);

  // 読み込み中は、誤って空一覧を見せないようにします
  if (!isReady || selectedMonth === "") {
    return <p>家計簿データを読み込んでいます...</p>;
  }

  return (
    <main>
      <h1>簡易家計簿</h1>

      {/* LocalStorageに関する案内を表示します */}
      {storageMessage && <p role="alert">{storageMessage}</p>}

      {/* 集計する年月を選びます */}
      <section>
        <h2>表示する月</h2>

        <label htmlFor="selected-month">年月</label>
        <input
          id="selected-month"
          type="month"
          value={selectedMonth}
          onChange={(event) => setSelectedMonth(event.target.value)}
        />
      </section>

      {/* 選択月の全取引から集計した金額を表示します */}
      <section aria-label="月別集計">
        <h2>{selectedMonth}の集計</h2>
        <p>収入:{formatYen(monthlyTotals.income)}</p>
        <p>支出:{formatYen(monthlyTotals.expense)}</p>
        <p>差額:{formatYen(monthlyTotals.balance)}</p>
      </section>

      {/* 収入・支出とカテゴリーのフィルターを設定します */}
      <section>
        <h2>取引を絞り込む</h2>

        <label htmlFor="type-filter">取引の種類</label>
        <select
          id="type-filter"
          value={filters.type}
          onChange={(event) =>
            setFilters((current) => ({
              ...current,
              type: event.target.value as TransactionType | "all",
            }))
          }
        >
          <option value="all">収入・支出すべて</option>
          <option value="income">収入</option>
          <option value="expense">支出</option>
        </select>

        <label htmlFor="category-filter">カテゴリー</label>
        <select
          id="category-filter"
          value={filters.category}
          onChange={(event) =>
            setFilters((current) => ({
              ...current,
              category: event.target.value as TransactionCategory | "all",
            }))
          }
        >
          <option value="all">すべてのカテゴリー</option>
          <option value="salary">給与</option>
          <option value="other-income">その他の収入</option>
          <option value="food">食費</option>
          <option value="transport">交通費</option>
          <option value="housing">住居費</option>
          <option value="utilities">水道・光熱費</option>
          <option value="shopping">買い物</option>
          <option value="other-expense">その他の支出</option>
        </select>

        {/* すべての条件を初期状態に戻します */}
        <button
          type="button"
          onClick={() =>
            setFilters({
              type: "all",
              category: "all",
            })
          }
        >
          フィルターをリセット
        </button>
      </section>

      {/* 新しい取引を追加するフォームです */}
      <TransactionForm onAdd={addTransaction} />

      {/* 月とフィルターに合う件数を表示します */}
      <p>表示中:{visibleTransactions.length}件</p>

      {/* 絞り込み後の取引一覧を表示します */}
      <TransactionList
        transactions={visibleTransactions}
        onDelete={deleteTransaction}
      />
    </main>
  );
}
TSX

getCurrentLocalMonth()ではtoISOString()を使わず、ブラウザーの現地時刻から年月を作っています。toISOString()はUTC基準なので、時刻によっては利用者の現地の日付・月とずれることがあるためです。

8. フィルターと集計の違いを確かめる

このページでは、月別集計と一覧表示で参照するデータが異なります。

  • 月別集計:選択した月の全取引から計算します。
  • 一覧:選択した月に加え、取引種類とカテゴリーの条件で絞ります。

たとえば「2026年11月」「支出」「食費」を選ぶと、一覧には11月の食費だけが表示されます。一方で、月別集計の支出額は11月の食費以外も含む全支出です。フィルターに合わせた金額も必要なら、絞り込み結果から別の合計を計算し、「月全体の合計」と「表示中の取引の合計」を分けて表示すると利用者に伝わりやすくなります。

9. LocalStorageの保存を確認する

  • 収入と支出をいくつか登録します。
  • ブラウザーを再読み込みします。
  • 取引が残っていることを確認します。
  • 取引を追加または削除し、もう一度再読み込みします。
  • 月を変え、月別集計と一覧が切り替わることを確認します。

LocalStorageはブラウザーごとに保存されます。別のブラウザーや端末への同期は行われません。

10. 家計簿データのプライバシーに注意する

家計簿には、収入や支出など個人的な情報が含まれます。LocalStorageはブラウザー内の保存機能であり、秘密情報を安全に保管する専用の仕組みではありません。

  • 練習では、実際の口座番号・カード番号・認証情報を入力しないでください。
  • LocalStorageの内容は、同じブラウザーで動くスクリプトや利用者自身から参照される可能性があります。
  • 複数人で使うアプリにする場合は、サーバー側の認証、権限確認、データ保存が別途必要です。

この学習アプリは、利用者のブラウザー内で動く個人用の練習アプリです。登録データをサーバーへ送る機能はありません。

11. よくあるつまずき

  • 再読み込みでデータが消える:読み込みと保存のEffectが実行されているか、LocalStorageのキーが一致しているか確認します。
  • 読み込み後にデータが消える:LocalStorage読み込み前に空配列を保存していないか確認します。
  • 保存データが壊れて画面が止まる:JSON解析と実行時の形式チェックが`try…catch`で扱われているか確認します。
  • 選んだ月が1か月ずれる:UTC変換ではなく、現地時刻で年月を作っているか確認します。
  • 月別集計に別の月が混ざる:取引の日付の`YYYY-MM`と選択月を比較しているか確認します。
  • カテゴリーを選んだら集計も変わると思った:この例では集計は月全体、フィルターは一覧だけに適用しています。

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

  • LocalStorageから取引を読み込み、変更を保存できます。
  • 読み込み完了前に空の一覧で保存データを上書きしない設計になっています。
  • 選択月の収入・支出・差額を表示できます。
  • 種類とカテゴリーで一覧を絞り込めます。
  • 月別集計とフィルター後の一覧の違いを説明できます。
  • LocalStorageのデータが、機密情報を安全に保管する場所ではないと理解しています。

Day 34では、Day 33の家計簿に保存・月別集計・フィルターを追加しました。再読み込み後にデータが残ること、年月を変えると集計が変わること、種類やカテゴリーで一覧だけが絞られることを一つずつ確認してください。Day 35では、この集計結果を使ってグラフ表示を追加します。

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