【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 に追い出すことで、コンポーネント側は表示に専念できるようになりました。
変更に強い定数化 文字列や数値を直接書くのをやめたため、仕様変更時も一箇所の修正で安全に対応可能です。
〇参照先
▼公式ドキュメント
▼書籍
リーダブルコード ―より良いコードを書くためのシンプルで実践的なテクニック
以上
Discussion