儀表板設計
規則
- 側邊欄 + 主內容區佈局:固定寬度側邊欄(w-64),流體主內容區並帶有內距
- 側邊欄導航:圖示 + 標籤連結,活動狀態高亮,在行動裝置上可收合
- 頂端的 KPI 卡片列:3-4 張卡片組成響應式網格,包含指標名稱、數值、趨勢(增減百分比),可選用迷你圖
- 資料表格:欄位可排序,可依搜尋/狀態篩選,支援分頁(預設 10-25 行)
- 使用
@tanstack/react-table 進行無頭表格邏輯,搭配 shadcn/ui 的 Table 元件
- 響應式:側邊欄在
md 中斷點折疊為漢堡選單,卡片堆疊為 1-2 欄
- 載入狀態:使用與卡片/表格形狀相符的骨架佔位符,絕不造成版面偏移
- 日期範圍選擇器用於篩選儀表板資料,預設為最近 30 天
佈局結構
┌──────────┬────────────────────────────┐
│ 側邊欄 │ 標頭 / 麵包屑 │
│ ├────────────────────────────┤
│ 導航連結 │ KPI 卡片(3-4 欄網格) │
│ ├────────────────────────────┤
│ │ 圖表 / 圖形 │
│ ├────────────────────────────┤
│ │ 資料表格 │
└──────────┴────────────────────────────┘
模式
function KPICard({ title, value, change }: { title: string; value: string; change: number }) {
return (
<Card>
<CardHeader className="pb-2">
<CardTitle className="text-sm font-medium text-muted-foreground">{title}</CardTitle>
</CardHeader>
<CardContent>
<div className="text-2xl font-bold">{value}</div>
<p className={cn("text-xs", change >= 0 ? "text-green-600" : "text-red-600")}>
{change >= 0 ? "+" : ""}{change}% 相較於上一期
</p>
</CardContent>
</Card>
);
}
避免事項
- 固定寬度的主內容區 ─ 一律使用填滿可用空間的流體佈局
- 沒有分頁的表格 ─ 大型資料集會嚴重影響效能與可用性
- 缺少載入/空狀態 ─ 務必顯示骨架或「無資料」訊息
- 無法收合的側邊欄 ─ 行動裝置使用者需要完整的視窗寬度
- 局部頁面更新使用旋轉載入器 ─ 針對特定區塊應使用骨架
- 塞入過多 KPI ─ 突顯 3-5 個關鍵指標,其餘放在可展開區段中
- 從零開始自訂側邊欄 ─ 使用 shadcn 的 sidebar 元件
- 沒有動作按鈕的空狀態 ─ 一律包含 CTA(例如「尚無活動。建立你的第一個活動 →」)