Baseline UI
強制執行一套有觀點的 UI 基準,以防止 AI 生成的介面垃圾。
使用方式
-
/baseline-ui在此對話中對任何 UI 工作套用這些約束條件。 -
/baseline-ui <檔案>根據下列所有約束條件審查該檔案,並輸出:- 違規項目(引用確切的行數或程式碼片段)
- 為何重要(一句簡短的說明)
- 具體的修復方式(程式碼層級的建議)
技術棧
- 必須使用 Tailwind CSS 預設值,除非已有自訂值或明確要求使用
- 當需要 JavaScript 動畫時,必須使用
motion/react(原名framer-motion) - 應使用
tw-animate-css為 Tailwind CSS 中的進場與微動畫提供支援 - 類別邏輯必須使用
cn工具函數(clsx+tailwind-merge)
元件
- 任何涉及鍵盤或焦點行為的元件,必須使用無障礙元件原語(
Base UI、React Aria、Radix) - 必須優先使用專案中既有的元件原語
- 絕不在同一個互動表面混合使用不同的原語系統
- 若與技術棧相容,應優先為新原語選擇
Base UI - 只有圖示的按鈕必須加上
aria-label屬性 - 除非明確要求,否則絕不自行重建鍵盤或焦點行為
互動
- 破壞性或不可逆的操作必須使用
AlertDialog - 載入狀態應使用結構化的骨架螢幕
- 絕不使用
h-screen,應使用h-dvh - 固定定位元素必須遵循
safe-area-inset - 錯誤訊息必須顯示在觸發動作的位置旁邊
- 絕不在
input或textarea元素中攔截貼上功能
動畫
- 除非明確要求,否則絕不加入動畫
- 只能對合成器屬性(
transform、opacity)進行動畫 - 絕不對版面屬性(
width、height、top、left、margin、padding)進行動畫 - 應避免對繪製屬性(
background、color)進行動畫,除非是小型、局部 UI(如文字、圖示) - 進入動畫應使用
ease-out - 互動回饋的動畫持續時間絕不超過
200ms - 當畫面離開螢幕時,必須暫停循環動畫
- 應尊重
prefers-reduced-motion設定 - 除非明確要求,否則絕不使用自訂緩動曲線
- 應避免對大型圖片或全螢幕表面進行動畫
排版
- 標題必須使用
text-balance,內文或段落則使用text-pretty - 數據必須使用
tabular-nums - 密集的 UI 應使用
truncate或line-clamp - 除非明確要求,否則絕不修改
letter-spacing(tracking-*)
版面
- 必須使用固定的
z-index層級(禁止使用任意的z-*值) - 正方形元素應使用
size-*,而非w-*+h-*
效能
- 絕不為大型
blur()或backdrop-filter表面製作動畫 - 除非動畫正在進行中,否則絕不套用
will-change - 絕不使用
useEffect來處理任何可以表示為渲染邏輯的行為
設計
- 除非明確要求,否則絕不使用漸層
- 絕不使用紫色或多色漸層
- 絕不使用發光效果作為主要提示方式
- 除非明確要求,否則應使用 Tailwind CSS 預設的陰影層級
- 空狀態必須提供一個明確的下一步操作
- 每個檢視畫面應限制僅使用一個強調色
- 在引入新顏色之前,應優先使用既有主題或 Tailwind CSS 的顏色代碼