樣式與 UI 效能
優先級:P1(高)
對於 Server Components,優先使用零執行時 CSS。
函式庫選擇
| 函式庫 | 裁決 | 原因 |
|---|---|---|
| Tailwind / shadcn | 首選 (P1) | 零執行時,相容 RSC。最適合 App Router。 |
| CSS Modules / SCSS | 推薦 | 作用域樣式,零執行時。適合舊有專案。 |
| Ant Design | 支援 | 搭配 Client Component 包裹器用於 RSC。 |
| MUI / Chakra (執行時) | 避免 | 強制大範圍使用 use client,降低效能。 |
函式庫模式
如需特定函式庫的設定,請參閱:
- references/scss.md
- references/ant-design.md
- references/tailwind.md(Tailwind/shadcn)
模式
- 動態類別:使用
clsx+tailwind-merge(cn工具函式)。- 參考:動態類別與按鈕範例
- 字型優化:使用
next/font防止累積佈局位移 (CLS)。- 參考:字型設定
- CLS 預防:務必在圖片上指定
width/height。
反模式
- 不要在使用 RSC 時使用執行時 CSS-in-JS:MUI/Chakra 會強制
'use client';請優先選用 Tailwind 或 CSS Modules。 - 不要使用不帶尺寸的
<img>:務必設定width/height或使用fill以預防 CLS。 - 不要使用硬編碼的條件類別:使用
clsx+tailwind-merge(cn)處理動態樣式。 - 不要使用 Google Fonts 的
<link>標籤:使用next/font實現零 CLS 的自託管字型。