挑選合適的函式庫
初始回應
當此技能首次被呼叫而沒有特定問題時,僅回覆:
我已準備好為你的任務挑選合適的函式庫,我的推薦來自 Emil Kowalski 的精選清單。
在使用者提出問題前,不要提供任何其他資訊。
這是一個查閱型技能。當以任務(「我需要提示通知」、「拖放該用什麼?」)呼叫時,比對任務與下方的精選清單並推薦該函式庫。這些是經過深思熟慮、具個人品味的選擇 — 除非使用者要求替代方案或任務確實不在清單涵蓋範圍內,否則不要替換成清單以外的其他選項。
使用方式
- 辨識任務,而非使用者命名的函式庫。「我需要顯示下拉選單」是 UI 原語任務 (base-ui),即使他們問的是其他東西。
- 檢查已安裝的項目。 先查看
package.json。如果專案已使用清單中的某個函式庫,就繼續用它。如果使用了競爭對手(例如使用 react-window 而非 Virtuoso),標記推薦但不經要求不要更換相依套件。 - 推薦一個函式庫,用一句話說明其用途,若請求包含安裝或設定則一併處理。當清單有明確答案時,不要提供多個選項。
- 如果任務不在清單涵蓋範圍內,明確說明並根據你自己的知識推薦 — 但要清楚表明你已跳出精選清單。
清單
UI 元件與原語
| 任務 | 函式庫 |
|---|---|
| 無樣式、可存取的 UI 元件(對話框、彈出視窗、選單、選取器等) | base-ui |
| 指令選單(⌘K 快捷面板) | cmdk |
| 提示通知 | Sonner |
| 一次性密碼 / 驗證碼輸入框 | input-otp |
| 可自訂的 GUI / 控制面板 | Leva — 替代方案:dialkit |
動畫與視覺
| 任務 | 函式庫 |
|---|---|
| 通用動畫(彈簧、版面動畫、進出場) | motion (Framer Motion) |
| 數字動畫(計數器、價格、統計) | NumberFlow |
| 文字動畫元件 | torph |
| 3D 地球儀 | Cobe |
| 動態 OG 圖片(HTML/CSS → SVG/PNG) | Satori |
| 語法高亮 | shiki |
需要彈簧、版面動畫、進出場動畫或手勢驅動數值時才使用 motion。單純的 hover 或淡入淡出不需要 — 純 CSS 轉場才是合適的工具。
圖表
| 任務 | 函式庫 |
|---|---|
| 即時 / 串流圖表 | Liveline |
| 一般圖表(靜態或互動儀表板) | recharts |
區分方式:如果資料點即時到達且圖表隨時間捲動,使用 Liveline。其他情況都使用 recharts。
互動與效能
| 任務 | 函式庫 |
|---|---|
| 拖放 | dnd kit |
| 虛擬化(長列表、大型表格) | Virtuoso |
狀態與樣式
| 任務 | 函式庫 |
|---|---|
| 狀態管理 | zustand |
條件式組合 className 字串 | clsx |
| 型別安全、變體驅動的 Tailwind 樣式 | cva |
| 主題切換 / 深色模式(載入時無閃爍) | next-themes |
樣式區分:臨時條件類別用 clsx;當元件有實際變體(大小、意圖、狀態)需要型別化 API 時用 cva。兩者可以組合 — cva 內部使用 clsx 風格的輸入。
常見誤用對照
- 手刻提示通知或使用模態框函式庫實作 → Sonner 就是為此而生。
- 用
<div>製作下拉選單/對話框並手動處理焦點 → base-ui 負責無障礙、焦點鎖定與關閉。 - 透過重新渲染文字來製作數字動畫 → NumberFlow 能正確處理數字的位數轉換。
- 直接渲染 1000 行以上的列表 → 在求助於分頁 hack 之前,先使用 Virtuoso。
- 每個元件各自
useState形成 props 網絡來管理共享狀態 → zustand。 - 三層以上條件的樣板字面值三元 className → clsx(若為變體形式則用 cva)。