🦉

【28日目】『リーダブルコード』を意識してNext.js/Reactをリファクタリングしてみた

に公開

技術ブログ28日目。
本日は、Next.js/Reactの読みやすさを追求します。

〇課題 
プロジェクト・タスクボードの改善
タスク一覧の表示、ラベル絞り込み、優先度ソートの機能をすべて1箇所で管理しています。機能は動きますが、コードがパズルのようになっており、新しいステータスを追加しようとするとどこかが壊れそうな状態です。

〇修正前コード(動くけれど読みにくいコード)


// src/app/projects/board/page.tsx
"use client";

import { useState, useEffect } from "react";

export default function TaskBoard() {
  const [d, setD] = useState<any[]>([]);
  const [f, setF] = useState("all");

  useEffect(() => {
    // タスクデータの取得(実際はAPIから)
    setD([
      { id: 1, title: "バグ修正", p: 1, s: "open", tag: "dev" },
      { id: 2, title: "要件定義", p: 3, s: "closed", tag: "design" },
      { id: 3, title: "UI改善", p: 2, s: "open", tag: "design" },
    ]);
  }, []);

  return (
    <div className="p-12">
      <h1 className="text-3xl font-bold mb-6">タスクボード</h1>
      
      <select value={f} onChange={(e) => setF(e.target.value)} className="border p-2 mb-6">
        <option value="all">すべて</option>
        <option value="dev">開発</option>
        <option value="design">デザイン</option>
      </select>

      <div className="grid gap-6">
        {d
          .filter((i) => f === "all" || i.tag === f)
          .sort((a, b) => a.p - b.p) // 優先度順にソート
          .map((i) => (
            <div key={i.id} className="border-l-4 p-4 shadow-sm bg-white" 
                 style={{ borderLeftColor: i.s === "open" ? (i.p === 1 ? "red" : "orange") : "gray" }}>
              <div className="flex justify-between items-center">
                <span className="font-bold">{i.title}</span>
                {/* 複雑な条件分岐がJSX内に埋もれている */}
                <span className="text-xs px-2 py-1 rounded bg-gray-100">
                  {i.p === 1 ? "最優先" : i.p === 2 ? "重要" : "通常"}
                </span>
              </div>
              <p className="text-sm text-gray-500 mt-2">
                状態: {i.s === "open" ? "進行中" : "完了"} | カテゴリ: {i.tag}
              </p>
            </div>
          ))}
      </div>
    </div>
  );
}

〇リファクタリングの指針
名著『リーダブルコード』に基づき、以下の点を意識しました。

名前に情報を詰め込む
d, f, p などの1文字変数を、tasks, filterTag, priority のように意味がわかる名前に変更する。

巨大な式を分割する(タスクの分離)
JSXの中で直接行っていた計算を Custom Hook に集約し、見た目とロジックを切り離す。

制御フローを読みやすくする
三項演算子のネストを、ガード節を用いた独立した関数へ抽出する。

マジック文字列・数値を避ける
ステータスや優先度を定数(オブジェクト)で管理し、変更に強い構造にする。

〇修正後のコード

"use client";

import { useState, useEffect, useMemo } from "react";

//  1. 定数・型定義(マジック文字列を排除) 
const TASK_STATUS = {
  OPEN: "open",
  CLOSED: "closed",
} as const;

const PRIORITY = {
  HIGH: 1,
  MEDIUM: 2,
  LOW: 3,
} as const;

type TaskStatus = typeof TASK_STATUS[keyof typeof TASK_STATUS];
type TaskTag = "dev" | "design" | "all";

interface Task {
  id: number;
  title: string;
  priority: number;
  status: TaskStatus;
  tag: string;
}

//  2. Custom Hook(データの加工と管理) 
function useTasks() {
  const [tasks, setTasks] = useState<Task[]>([]);
  const [filterTag, setFilterTag] = useState<TaskTag>("all");

  useEffect(() => {
    // 実際はAPI等から取得
    setTasks([
      { id: 1, title: "バグ修正", priority: PRIORITY.HIGH, status: TASK_STATUS.OPEN, tag: "dev" },
      { id: 2, title: "要件定義", priority: PRIORITY.LOW, status: TASK_STATUS.CLOSED, tag: "design" },
      { id: 3, title: "UI改善", priority: PRIORITY.MEDIUM, status: TASK_STATUS.OPEN, tag: "design" },
    ]);
  }, []);

  // フィルタリングとソートを一箇所に集約
  const filteredTasks = useMemo(() => {
    return tasks
      .filter((task) => filterTag === "all" || task.tag === filterTag)
      .sort((a, b) => a.priority - b.priority);
  }, [tasks, filterTag]);

  return { filteredTasks, filterTag, setFilterTag };
}

//  3. メインコンポーネント(レイアウトの指示) 
export default function TaskBoardPage() {
  const { filteredTasks, filterTag, setFilterTag } = useTasks();

  return (
    <div className="p-12 space-y-6 bg-gray-50 min-h-screen">
      <header>
        <h1 className="text-3xl font-bold">タスクボード</h1>
      </header>
      
      <div className="flex items-center gap-4">
        <label className="text-sm font-medium">カテゴリ:</label>
        <select 
          value={filterTag} 
          onChange={(e) => setFilterTag(e.target.value as TaskTag)} 
          className="border p-2 rounded bg-white shadow-sm"
        >
          <option value="all">すべて</option>
          <option value="dev">開発</option>
          <option value="design">デザイン</option>
        </select>
      </div>

      <div className="grid gap-6">
        {filteredTasks.map((task) => (
          <TaskCard key={task.id} task={task} />
        ))}
      </div>
    </div>
  );
}

//  4. サブコンポーネント(個別の部品表示) 
function TaskCard({ task }: { task: Task }) {
  // 優先度のラベルを判定
  const getPriorityLabel = () => {
    if (task.priority === PRIORITY.HIGH) return "最優先";
    if (task.priority === PRIORITY.MEDIUM) return "重要";
    return "通常";
  };

  // 左側のボーダー色を決定(ロジックの抽出)
  const getBorderColor = () => {
    if (task.status === TASK_STATUS.CLOSED) return "gray";
    if (task.priority === PRIORITY.HIGH) return "red";
    if (task.priority === PRIORITY.MEDIUM) return "orange";
    return "blue";
  };

  return (
    <div 
      className="p-4 shadow-sm bg-white rounded-r border-l-4" 
      style={{ borderLeftColor: getBorderColor() }}
    >
      <div className="flex justify-between items-center">
        <span className="font-bold text-gray-800">{task.title}</span>
        <span className="text-xs px-2 py-1 rounded bg-gray-100 font-medium">
          {getPriorityLabel()}
        </span>
      </div>
      <footer className="text-sm text-gray-500 mt-2">
        <span>状態: {task.status === TASK_STATUS.OPEN ? "進行中" : "完了"}</span>
        <span className="mx-2">|</span>
        <span>カテゴリ: {task.tag}</span>
      </footer>
    </div>
  );
}

〇主な修正ポイント
一文字の変数を排除し、読み手が推測しなくても済む名前に変更しました。

ガード節による「直線的な」ロジック ネストされた三項演算子を排除し、if文で早期リターンさせることで、上から下へ自然に読めるようにしました。

下位の問題の抽出 「データのフィルタリング」という計算を Custom Hook に追い出すことで、コンポーネント側は表示に専念できるようになりました。

変更に強い定数化 文字列や数値を直接書くのをやめたため、仕様変更時も一箇所の修正で安全に対応可能です。

〇参照先
▼公式ドキュメント
https://www.typescriptlang.org/docs/handbook/2/everyday-types.html

https://react.dev/reference/react/useMemo

https://react.dev/learn/keeping-components-pure

▼書籍
リーダブルコード ―より良いコードを書くためのシンプルで実践的なテクニック

以上

Discussion