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

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

Day 35:カテゴリー別の支出をグラフで表示する

Day 35では、Day 34までに作った家計簿アプリへグラフを追加します。今回は、選択した月の支出をカテゴリー別に集計し、円グラフで表示します。たとえば、食費や交通費など、どのカテゴリーに支出が多いかを視覚的に確認できます。

グラフには、利用者が登録した取引データから計算した値だけを渡します。練習用の固定データを表示するのではなく、取引の追加・削除や月の切り替えに合わせてグラフも更新されるようにします。

1. グラフの種類と表示内容を決める

今回は、選択中の月におけるカテゴリー別支出の割合を見せる円グラフを作ります。

  • 対象は選択中の月の支出です。
  • 収入はグラフに含めません。
  • カテゴリー別フィルターでは絞らず、その月の支出全体の内訳を表示します。
  • 支出がないカテゴリーはグラフに含めません。
  • 支出がない月は、グラフの代わりに案内を表示します。

一覧のフィルターにカテゴリーが選ばれているときでも、グラフは月全体の内訳を表示します。フィルター後の取引だけでグラフを作ると、一つのカテゴリーしか表示されず、全体の支出傾向が分かりにくくなるためです。

2. Rechartsをインストールする

この例では、React向けのグラフライブラリであるRechartsを使います。プロジェクトのルートで次のコマンドを実行します。

# Rechartsをプロジェクトへ追加します
npm install recharts

パッケージ管理にpnpmやyarnを使っている場合は、プロジェクトで利用中のコマンドに読み替えてください。Recharts公式には、ResponsiveContainerの内側でPieChartとPieを使う円グラフ例があります。(🔗 recharts.github.io)

3. カテゴリー別の支出データを作る

グラフを描画する前に、取引一覧を次のような形に変換します。

// 円グラフへ渡すデータの例です
[
  { name: "食費", value: 12000 },
  { name: "交通費", value: 5000 },
];
TypeScript

nameはグラフ上のカテゴリー名、valueはそのカテゴリーで使った金額です。取引データをグラフ用の形に変換する関数を、src/utils/ledger.tsに追加します。

Day 34で作ったgetCategoryLabelとTransactionの型を使います。すでに同じ名前の関数がある場合は、重複して作らず、既存の関数を利用してください。

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

// グラフ用データ1件の型です
export type CategoryExpense = {
  name: string;
  value: number;
  category: TransactionCategory;
};

// カテゴリーの内部値を画面表示用の名前に変換します
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 calculateCategoryExpenses(
  transactions: Transaction[],
  month: string
): CategoryExpense[] {
  // カテゴリーごとの合計金額を保存する入れ物です
  const totals = new Map<TransactionCategory, number>();

  // すべての取引を確認します
  for (const transaction of transactions) {
    // 支出以外はグラフに使わないので飛ばします
    if (transaction.type !== "expense") {
      continue;
    }

    // 取引日から年月を取り出します
    const transactionMonth = transaction.date.slice(0, 7);

    // 選択した月以外の取引は飛ばします
    if (transactionMonth !== month) {
      continue;
    }

    // 同じカテゴリーの金額を加算します
    const currentTotal = totals.get(transaction.category) ?? 0;
    totals.set(
      transaction.category,
      currentTotal + transaction.amount
    );
  }

  // Mapをグラフ表示用の配列に変換します
  return Array.from(totals, ([category, value]) => ({
    // 内部値ではなく利用者向けの名前を表示します
    name: getCategoryLabel(category),
    value,
    category,
  })).sort((a, b) => b.value - a.value);
}
TypeScript

この関数はReactに依存しません。取引データと月を受け取って結果を返すだけなので、画面の表示とは分けてテストできます。支出だけを対象にし、月とカテゴリーごとに金額を合算しています。

4. グラフコンポーネントを作る

src/components/ledger/ExpenseCategoryChart.tsxを作ります。グラフ描画をページから分けておくと、ページにはデータの準備や画面構成を、グラフ部品には描画方法を置けます。

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

// Rechartsの円グラフ関連コンポーネントを読み込みます
import {
  Cell,
  Legend,
  Pie,
  PieChart,
  ResponsiveContainer,
  Tooltip,
} from "recharts";

// グラフ用データの型を読み込みます
import type { CategoryExpense } from "../../utils/ledger";

// 円グラフに使う色をカテゴリー分だけ用意します
const CHART_COLORS = [
  "#2563eb",
  "#16a34a",
  "#f97316",
  "#9333ea",
  "#dc2626",
  "#0891b2",
  "#ca8a04",
  "#64748b",
];

// グラフへ渡すPropsの型です
type ExpenseCategoryChartProps = {
  data: CategoryExpense[];
  month: string;
};

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

// カテゴリー別支出の円グラフを表示します
export default function ExpenseCategoryChart({
  data,
  month,
}: ExpenseCategoryChartProps) {
  // データがないときはグラフを描かず、理由を説明します
  if (data.length === 0) {
    return (
      <section>
        <h2>{month}のカテゴリー別支出</h2>
        <p>この月に登録された支出はありません。</p>
      </section>
    );
  }

  return (
    <section>
      <h2>{month}のカテゴリー別支出</h2>

      {/* グラフの親に高さを指定します */}
      <div className="expense-chart">
        {/* 親要素のサイズに合わせてグラフを調整します */}
        <ResponsiveContainer width="100%" height="100%">
          <PieChart>
            {/* valueを円の大きさ、nameをカテゴリー名に使います */}
            <Pie
              data={data}
              dataKey="value"
              nameKey="name"
              cx="50%"
              cy="50%"
              outerRadius="78%"
              label
            >
              {/* 項目ごとに色を指定します */}
              {data.map((item, index) => (
                <Cell
                  key={item.category}
                  fill={CHART_COLORS[index % CHART_COLORS.length]}
                />
              ))}
            </Pie>

            {/* グラフ上にカーソルを置いたとき金額を表示します */}
            <Tooltip
              formatter={(value) => formatYen(Number(value))}
            />

            {/* カテゴリーと色の対応を表示します */}
            <Legend />
          </PieChart>
        </ResponsiveContainer>
      </div>

      {/* 色だけでなく金額も文章で確認できる一覧を付けます */}
      <ul>
        {data.map((item) => (
          <li key={item.category}>
            {item.name}:{formatYen(item.value)}
          </li>
        ))}
      </ul>
    </section>
  );
}
TSX

ResponsiveContainerの親要素には、幅だけでなく高さも必要です。Recharts公式の例でも、親のdivに幅と高さを設定してからResponsiveContainerを配置しています。(🔗 recharts.github.io)

5. グラフに高さを指定する

src/app/globals.cssにグラフの高さを追加します。既存のCSSは残したまま追記してください。

/* ResponsiveContainerが広がるための親要素です */
.expense-chart {
  width: 100%;
  height: 320px;
  min-width: 0;
}

親の高さが決まっていないと、グラフが見えなかったり、高さが0になったりすることがあります。グラフ自体が表示されない場合は、まず親要素の幅と高さを確認してください。

6. ページからグラフを呼び出す

Day 34のsrc/app/page.tsxに、集計関数とグラフ部品を追加します。Day 34で作ったtransactionsとselectedMonthを使えば、グラフ用のデータを毎回Stateとして保存する必要はありません。

// Reactの計算結果を再利用するHookを読み込みます
import { useMemo } from "react";

// グラフ部品を読み込みます
import ExpenseCategoryChart from "../components/ledger/ExpenseCategoryChart";

// カテゴリー別支出の集計関数を読み込みます
import { calculateCategoryExpenses } from "../utils/ledger";

// ページの中で、取引と選択月からグラフ用データを作ります
const categoryExpenses = useMemo(() => {
  // 月が設定されていない間は空のデータを返します
  if (selectedMonth === "") {
    return [];
  }

  // 選択月の支出をカテゴリー別に集計します
  return calculateCategoryExpenses(transactions, selectedMonth);
}, [transactions, selectedMonth]);
TSX

このコードは、Day 34のページコンポーネントの中、returnより前に置きます。useMemoを使う場合は、ファイルの先頭でReactから読み込みます。すでにuseMemoを読み込んでいる場合は重複して追加しないでください。

// React Hookをまとめて読み込みます
import { useEffect, useMemo, useState } from "react";
TSX

次に、ページのreturn内でグラフ部品を表示します。月別集計の近くに配置すると、数字と内訳を続けて確認できます。

{/* 選択月の支出をカテゴリー別にグラフ表示します */}
<ExpenseCategoryChart
  data={categoryExpenses}
  month={selectedMonth}
/>
TSX

transactionsが変わる、またはselectedMonthが変わると、グラフ用の値も再計算されます。カテゴリー別のフィルターを変更しても、このグラフは月全体の支出内訳を表示します。

7. useMemoは必要な場合に使う

今回のカテゴリー集計は、取引件数が少なければuseMemoなしでも問題ありません。ここでは、データから算出する値をStateとして重複して持たず、取引か選択月が変わったときに計算する例として使っています。

  • 取引件数が少なく、計算が軽いなら、毎回計算しても構いません。
  • 計算結果を別Stateに保存すると、取引との同期漏れが起きる場合があります。
  • 件数が多く、Profilerで計算負荷が確認できた場合に、`useMemo`の効果を検討します。

グラフが正しく更新されるかどうかは、まずtransactionsとselectedMonthから正しい配列が作られているかを確認します。メモ化はその後に検討します。

8. 動作を確認する

  • 同じ月に、複数カテゴリーの支出を登録します。
  • 円グラフにカテゴリーごとの区分が表示されることを確認します。
  • グラフの項目にカーソルを置き、金額が表示されることを確認します。
  • 収入だけの取引は支出グラフに含まれないことを確認します。
  • 別の月を選び、グラフの内訳が切り替わることを確認します。
  • カテゴリー別フィルターを変更しても、グラフが月全体の支出内訳を示すことを確認します。
  • 対象月に支出がない場合、空の円グラフではなく案内が表示されることを確認します。
  • 支出を追加・削除し、LocalStorage保存後にもグラフが更新されることを確認します。

9. よくあるつまずき

  • グラフが見えない:グラフの親要素に高さが設定されているか確認します。
  • 収入までグラフに入る:集計関数で`type === “expense”`を確認しているか見ます。
  • 月を変えてもグラフが変わらない:`selectedMonth`が集計関数へ渡り、`useMemo`の依存配列にも入っているか確認します。
  • フィルターを選ぶとグラフが一つのカテゴリーだけになる:グラフ用データに`visibleTransactions`ではなく、全取引と選択月を渡します。
  • 空の月でグラフが崩れる:`data.length === 0`のときに案内を表示します。
  • 色だけでカテゴリーを判断している:凡例と、グラフの下にある金額一覧も併せて表示します。

10. 家計簿データのプライバシー

家計簿には収入や支出など個人的な情報が含まれます。Day 34で使ったLocalStorageはブラウザー内に保存する機能であり、パスワード保管庫のように秘密を守る仕組みではありません。

  • 練習では、実際の口座番号、カード番号、認証情報などを入力しないでください。
  • LocalStorageの内容は利用者のブラウザー内から参照・変更される可能性があります。
  • 複数人が使うサービスにする場合は、サーバー側の認証・権限確認・保存設計が必要です。

このアプリのグラフは、ブラウザー内にある取引から作成しています。サーバーへ家計データを送る処理はありません。

11. Day 33〜35の完成チェック

  • 収入と支出を登録し、カテゴリーと日付を付けられます。
  • 月を選ぶと、その月の収入・支出・差額が表示されます。
  • 種類やカテゴリーで取引一覧を絞り込めます。
  • LocalStorageから取引を読み込み、追加・削除した内容を保存できます。
  • 選択月の支出がカテゴリー別のグラフに反映されます。
  • 取引がない月に、分かりやすい案内を表示できます。
  • グラフ以外にもカテゴリー別金額の一覧があり、色だけに頼らず内容を確認できます。

12. この3日間で身につけること

  • Day 33:データの形を決め、登録・一覧・削除・合計を作りました。
  • Day 34:LocalStorage、月別集計、種類・カテゴリーのフィルターを追加しました。
  • Day 35:取引データを集計し、カテゴリー別支出をグラフで表示しました。

これで、収入・支出の登録から月別集計、保存、グラフ表示までを備えた簡易家計簿アプリの基本が完成します。最後に、取引を追加・削除したとき、月を切り替えたとき、再読み込みしたときに、一覧・合計・グラフが同じデータを正しく反映しているか確認してください。 Rechartsの円グラフは、データ配列をPieへ渡し、親のサイズに合わせてResponsiveContainerで描画できます。(🔗 recharts.github.io)

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