スタイリングとUIパフォーマンス
優先度: P1(高)
サーバーコンポーネントではゼロランタイムCSSを優先してください。
ライブラリ選択
| ライブラリ | 判定 | 理由 |
|---|---|---|
| Tailwind / shadcn | 推奨(P1) | ゼロランタイム、RSC互換。App Routerに最適。 |
| CSS Modules / SCSS | 推奨 | スコープ付き、ゼロランタイム。レガシープロジェクトに適しています。 |
| Ant Design | サポート対象 | 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>タグを使用しない: ゼロCLSのセルフホストフォントにはnext/fontを使用してください。