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

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

Day 33:簡易家計簿アプリを設計して作る

Day 33では、3日間で作る簡易家計簿アプリの土台を作ります。今日は、収入・支出の登録、カテゴリー選択、取引一覧、合計金額の表示までを実装します。

月別集計・フィルター・LocalStorage保存はDay 34、グラフ表示と仕上げはDay 35で追加します。最初から全部を作ろうとせず、機能を分けて少しずつ完成させる練習です。

今回はDay 32で学んだ構成を使い、画面部品・型・集計処理を別ファイルに分けます。

30日で身につけるTypeScript
「30日で身につけるTypeScript」の記事一覧です。

1. Day 33の完成目標を決める

今日作るアプリでは、次の操作ができます。

  • 収入または支出を選んで登録します。
  • 金額、カテゴリー、日付、メモを入力します。
  • 登録した収入・支出の一覧を表示します。
  • 収入合計、支出合計、差額を表示します。
  • 登録した取引を削除します。

今日はデータをブラウザーのメモリー内で管理します。そのためページを再読み込みすると登録内容は消えます。これは意図した段階分けです。Day 34でLocalStorageを追加し、再読み込み後もデータが残るようにします。

2. データの形を考える

まず、家計簿の記録をどのようなデータで表すか決めます。収入と支出は、同じ取引データのtypeで区別します。金額は常に正の整数で保存し、収入か支出かはtypeで判定します。

{
  id: "取引ごとのID",
  type: "income" または "expense",
  amount: 1200,
  category: "food",
  date: "2026-11-14",
  memo: "昼食",
  createdAt: 1234567890
}

金額を「支出だからマイナス」にして保存すると、入力や表示のルールが複雑になりがちです。今回は金額を正の値で保存し、合計を計算するときに収入と支出を分けます。

3. フォルダー構成を作る

TypeScriptを使うNext.jsプロジェクトでは、次の構成にします。

src/
├── app/
│   └── page.tsx
├── components/
│   └── ledger/
│       ├── TransactionForm.tsx
│       └── TransactionList.tsx
├── types/
│   └── ledger.ts
└── utils/
    └── ledger.ts

srcを使っていないプロジェクトでは、appやcomponentsなどをルートに配置してください。既存のNext.jsプロジェクトに合わせ、どちらかに統一すれば問題ありません。

4. 取引データの型を定義する

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">;
TypeScript

NewTransactionは、登録前の取引にまだないidとcreatedAtを除いた型です。IDや作成時刻は入力欄ではなく、取引を追加する処理の中で作ります。

TypeScriptの型は、コードを書いているときにデータの形を確認する助けになります。ただし、実行時に入力値やLocalStorageの内容を自動検証するものではありません。外部から読み込んだデータは、必要に応じて実際の値も確認します。

5. カテゴリーと集計処理を作る

src/utils/ledger.tsを作ります。カテゴリーの表示名と、収入・支出・差額の集計関数をここに置きます。

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

// 取引の種類ごとのカテゴリー一覧です
export const CATEGORY_OPTIONS: Record<
  TransactionType,
  { value: TransactionCategory; label: string }[]
> = {
  // 収入カテゴリーです
  income: [
    { value: "salary", label: "給与" },
    { value: "other-income", label: "その他の収入" },
  ],

  // 支出カテゴリーです
  expense: [
    { value: "food", label: "食費" },
    { value: "transport", label: "交通費" },
    { value: "housing", label: "住居費" },
    { value: "utilities", label: "水道・光熱費" },
    { value: "shopping", label: "買い物" },
    { value: "other-expense", label: "その他の支出" },
  ],
};

// カテゴリーの内部値を画面表示用の名前に変換します
export function getCategoryLabel(
  category: TransactionCategory
): string {
  // 収入カテゴリーと支出カテゴリーをまとめて検索します
  const allCategories = [
    ...CATEGORY_OPTIONS.income,
    ...CATEGORY_OPTIONS.expense,
  ];

  // 一致するカテゴリーの表示名を返します
  return (
    allCategories.find((item) => item.value === category)?.label ??
    "その他"
  );
}

// 収入・支出・差額を計算します
export function calculateTotals(transactions: Transaction[]) {
  // 収入の金額だけを合計します
  const income = transactions
    .filter((transaction) => transaction.type === "income")
    .reduce((total, transaction) => total + transaction.amount, 0);

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

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

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

calculateTotals()は、Reactに依存しない関数です。取引一覧を受け取って合計を返すだけなので、画面部品と分けておくと読みやすく、後でテストもしやすくなります。

6. 取引登録フォームを作る

src/components/ledger/TransactionForm.tsxを作ります。入力中の値はフォームだけで使うため、このコンポーネントのLocal Stateとして管理します。収入・支出を切り替えたとき、選択できるカテゴリーも切り替えます。

// フォームで使うReactのState機能を読み込みます
import { useState } from "react";

// 新規取引と取引種別の型を読み込みます
import type {
  NewTransaction,
  TransactionCategory,
  TransactionType,
} from "../../types/ledger";

// カテゴリー選択肢を読み込みます
import { CATEGORY_OPTIONS } from "../../utils/ledger";

// 親から受け取るPropsの型です
type TransactionFormProps = {
  onAdd: (transaction: NewTransaction) => void;
};

// 入力フォームの初期値を返す関数です
function createInitialForm() {
  return {
    type: "expense" as TransactionType,
    amount: "",
    category: "food" as TransactionCategory,
    date: "",
    memo: "",
  };
}

// 収入・支出を登録するフォームです
export default function TransactionForm({
  onAdd,
}: TransactionFormProps) {
  // 入力中の値を管理します
  const [form, setForm] = useState(createInitialForm);

  // 入力エラーを管理します
  const [error, setError] = useState("");

  // 収入・支出を切り替えたときの処理です
  function handleTypeChange(nextType: TransactionType) {
    // 選んだ取引種別に合うカテゴリー一覧を取得します
    const options = CATEGORY_OPTIONS[nextType];

    // 取引種別とカテゴリーをまとめて更新します
    setForm((currentForm) => ({
      ...currentForm,
      type: nextType,
      category: options[0].value,
    }));

    // 古いエラーメッセージを消します
    setError("");
  }

  // フォームを送信して取引を登録します
  function handleSubmit(event: React.FormEvent<HTMLFormElement>) {
    // ページの再読み込みを防ぎます
    event.preventDefault();

    // 金額欄の文字列を数値に変換します
    const amount = Number(form.amount);

    // 金額が正の安全な整数か確認します
    if (!Number.isSafeInteger(amount) || amount <= 0) {
      setError("金額は1円以上の整数で入力してください。");
      return;
    }

    // 日付が入力されているか確認します
    if (form.date === "") {
      setError("日付を選択してください。");
      return;
    }

    // 新しい取引を親コンポーネントへ渡します
    onAdd({
      type: form.type,
      amount,
      category: form.category,
      date: form.date,
      memo: form.memo.trim(),
    });

    // 登録後はフォームを初期状態に戻します
    setForm(createInitialForm());

    // 登録できたらエラー表示を消します
    setError("");
  }

  // 現在の取引種別に対応するカテゴリーを取得します
  const categoryOptions = CATEGORY_OPTIONS[form.type];

  return (
    <section>
      <h2>収入・支出を登録</h2>

      {/* 送信時に入力内容を検証し、親へ取引を渡します */}
      <form onSubmit={handleSubmit}>
        <fieldset>
          <legend>取引の種類</legend>

          <label>
            <input
              type="radio"
              name="transaction-type"
              value="expense"
              checked={form.type === "expense"}
              onChange={() => handleTypeChange("expense")}
            />
            支出
          </label>

          <label>
            <input
              type="radio"
              name="transaction-type"
              value="income"
              checked={form.type === "income"}
              onChange={() => handleTypeChange("income")}
            />
            収入
          </label>
        </fieldset>

        <div>
          <label htmlFor="amount">金額(円)</label>
          <input
            id="amount"
            type="number"
            min="1"
            step="1"
            max="999999999"
            required
            value={form.amount}
            onChange={(event) =>
              setForm((currentForm) => ({
                ...currentForm,
                amount: event.target.value,
              }))
            }
          />
        </div>

        <div>
          <label htmlFor="category">カテゴリー</label>
          <select
            id="category"
            value={form.category}
            onChange={(event) =>
              setForm((currentForm) => ({
                ...currentForm,
                category: event.target.value as TransactionCategory,
              }))
            }
          >
            {categoryOptions.map((option) => (
              // カテゴリーの内部値をReactのkeyに使います
              <option key={option.value} value={option.value}>
                {option.label}
              </option>
            ))}
          </select>
        </div>

        <div>
          <label htmlFor="date">日付</label>
          <input
            id="date"
            type="date"
            required
            value={form.date}
            onChange={(event) =>
              setForm((currentForm) => ({
                ...currentForm,
                date: event.target.value,
              }))
            }
          />
        </div>

        <div>
          <label htmlFor="memo">メモ(任意)</label>
          <input
            id="memo"
            type="text"
            maxLength={100}
            value={form.memo}
            onChange={(event) =>
              setForm((currentForm) => ({
                ...currentForm,
                memo: event.target.value,
              }))
            }
          />
        </div>

        {/* 入力エラーがあるときだけ表示します */}
        {error && <p role="alert">{error}</p>}

        <button type="submit">登録</button>
      </form>
    </section>
  );
}
TSX

金額欄にはtype="number"やmin、stepを指定していますが、ブラウザーの入力制約だけに頼らず、handleSubmitでも金額を検証しています。画面側のチェックは、入力しやすさを高めるためのものです。実際にサーバーへ送る場合は、サーバー側でも値を確認してください。

7. 取引一覧を作る

src/components/ledger/TransactionList.tsxを作ります。取引一覧を受け取り、日付、種別、カテゴリー、金額、メモを表示します。削除ボタンを押すと、親へIDを伝えます。

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

// 表示名と金額表示の関数を読み込みます
import { formatYen, getCategoryLabel } from "../../utils/ledger";

// 親から受け取るPropsの型です
type TransactionListProps = {
  transactions: Transaction[];
  onDelete: (transactionId: string) => void;
};

// 取引一覧を表示します
export default function TransactionList({
  transactions,
  onDelete,
}: TransactionListProps) {
  // 取引がまだない場合の表示です
  if (transactions.length === 0) {
    return <p>取引はまだありません。最初の記録を登録しましょう。</p>;
  }

  return (
    <section>
      <h2>取引一覧</h2>

      <ul>
        {transactions.map((transaction) => (
          // 取引ごとのIDをkeyとして使います
          <li key={transaction.id}>
            <p>
              {transaction.date}・
              {transaction.type === "income" ? "収入" : "支出"}・
              {getCategoryLabel(transaction.category)}
            </p>

            <p>
              {transaction.type === "income" ? "+" : "-"}
              {formatYen(transaction.amount)}
            </p>

            {/* メモが入力されている場合だけ表示します */}
            {transaction.memo && <p>{transaction.memo}</p>}

            <button
              type="button"
              onClick={() => onDelete(transaction.id)}
              aria-label={`${transaction.date}の取引を削除`}
            >
              削除
            </button>
          </li>
        ))}
      </ul>
    </section>
  );
}
TSX

収入と支出の違いは、金額を正負にして保存するのではなく、表示時にtypeを見て「+」「-」を付けています。

8. ページで組み合わせる

src/app/page.tsxに、取引一覧のStateと集計を置きます。フォームや一覧の表示は、先ほど作ったコンポーネントに任せます。

// このページはStateとイベントを使うClient Componentです
"use client";

// ReactのState機能を読み込みます
import { useState } from "react";

// フォームと一覧のコンポーネントを読み込みます
import TransactionForm from "../components/ledger/TransactionForm";
import TransactionList from "../components/ledger/TransactionList";

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

// 集計と金額表示の関数を読み込みます
import { calculateTotals, formatYen } from "../utils/ledger";

// 家計簿アプリのページです
export default function HomePage() {
  // 登録した取引一覧を管理します
  const [transactions, setTransactions] = useState<Transaction[]>([]);

  // フォームから受け取った取引を追加します
  function handleAdd(transaction: NewTransaction) {
    // IDと作成時刻を付けて、取引データを完成させます
    const newTransaction: Transaction = {
      ...transaction,
      id: crypto.randomUUID(),
      createdAt: Date.now(),
    };

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

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

  // 収入・支出・差額を取引一覧から計算します
  const totals = calculateTotals(transactions);

  return (
    <main>
      <h1>簡易家計簿</h1>
      <p>まずは収入と支出を登録し、取引の一覧と合計を確認します。</p>

      {/* 合計を表示します */}
      <section aria-label="収支の合計">
        <h2>合計</h2>
        <p>収入:{formatYen(totals.income)}</p>
        <p>支出:{formatYen(totals.expense)}</p>
        <p>差額:{formatYen(totals.balance)}</p>
      </section>

      {/* 登録フォームから親の追加処理を呼び出します */}
      <TransactionForm onAdd={handleAdd} />

      {/* 取引一覧へデータと削除処理を渡します */}
      <TransactionList
        transactions={transactions}
        onDelete={handleDelete}
      />
    </main>
  );
}
TSX

このページでは、取引データをStateとして持ちます。追加と削除の操作でStateを更新すると、集計表示と一覧が新しいデータに合わせて再描画されます。

9. CSSで基本の見た目を整える

必要であれば、src/app/globals.cssに次のスタイルを追加します。既存のCSSを消さず、末尾に追加してください。

/* ページ全体の基本設定です */
* {
  box-sizing: border-box;
}

body {
  margin: 0;
  color: #222;
  background: #f7f7f7;
  font-family: sans-serif;
}

/* ページ本文の幅と余白を設定します */
main {
  max-width: 760px;
  margin: 0 auto;
  padding: 24px 16px;
}

/* フォームや集計のまとまりをカード風に表示します */
section {
  margin: 20px 0;
  padding: 18px;
  background: #fff;
  border: 1px solid #ddd;
  border-radius: 10px;
}

/* フォーム項目を縦に並べます */
form > div {
  display: grid;
  gap: 6px;
  margin: 14px 0;
}

/* 入力欄やボタンの基本サイズです */
input,
select,
button {
  min-height: 40px;
  padding: 8px 10px;
  font: inherit;
}

/* 一覧項目を見やすく区切ります */
li {
  margin: 12px 0;
  padding: 12px;
  border-bottom: 1px solid #ddd;
}

10. Day 33の動作確認

  • 支出を選び、金額・カテゴリー・日付を入力して登録します。
  • 収入に切り替え、収入用のカテゴリーが表示されることを確認します。
  • 収入合計、支出合計、差額が更新されることを確認します。
  • 金額を空欄、0、小数にして、登録できないことを確認します。
  • メモを入力し、一覧に表示されることを確認します。
  • 削除ボタンを押し、一覧と合計が更新されることを確認します。
  • ページを再読み込みし、今日はデータが消えることを確認します。

最後の確認は失敗ではありません。Day 33ではStateにだけ保存しており、LocalStorageをまだ追加していないためです。

11. 今日の実装で大切な設計

このアプリでは、入力欄の値はTransactionFormに、登録済み取引はpage.tsxに置いています。フォームで使うだけの一時的な値はフォーム内に置き、一覧や合計など複数の部品が必要とするデータは、共通の親で管理します。

  • フォーム部品は入力と入力チェックを担当します。
  • ページは取引一覧をStateとして管理し、追加・削除を行います。
  • 一覧部品は受け取った取引を表示します。
  • ユーティリティ関数はカテゴリー名や合計金額を計算します。
  • 型定義は取引データの形をそろえます。

この役割分担を守ると、たとえばカテゴリー名を変えたいときはutils、一覧の見た目を変えたいときはTransactionListを中心に確認できます。

12. 家計簿アプリでのプライバシーに注意する

Day 33のアプリは入力データをサーバーへ送信しませんが、家計簿には収入や支出などの個人的な情報が含まれます。Day 34でLocalStorageへ保存した場合、そのデータは同じブラウザー上で参照・変更できるため、機密情報を安全に保管する場所とは考えないでください。

  • 練習では、実際の口座番号やカード情報などを入力しないようにします。
  • LocalStorageの内容は利用者のブラウザー内に保存され、暗号化された秘密の保管庫ではありません。
  • このアプリは個人のブラウザー内で使う学習用です。複数人で利用するサービスには、サーバー側の認証・認可・保存設計が別途必要です。

13. Day 34・35で追加する機能

Day 33の土台が動いたら、次のように発展させます。

  • Day 34:LocalStorage保存、月別集計、期間やカテゴリーによるフィルターを追加します。
  • Day 35:月別の収支やカテゴリー別支出をグラフ表示し、表示や操作を仕上げます。

今日の段階では、まず登録したデータが正しくStateに入り、合計と一覧に反映されることを確認してください。

14. Day 33のチェックリスト

  • 収入と支出を登録できます。
  • 収入・支出でカテゴリーが切り替わります。
  • 日付、金額、カテゴリー、メモを記録できます。
  • 収入合計、支出合計、差額を表示できます。
  • 取引を削除すると、一覧と合計が更新されます。
  • Stateを直接変更せず、新しい配列で更新しています。
  • 画面部品、型、集計処理を役割ごとに分けています。
  • Day 33ではLocalStorage保存をまだ実装していないと理解しています。

Day 33のゴールは、家計簿アプリの基本となるデータの形と操作を、自分で組み立てることです。収入と支出の記録が一覧と合計に正しく反映されるところまで作ったら、Day 34で月別集計・フィルター・保存機能を追加できる状態になっています。

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