視覺基礎與 Token
Qokit 品牌顏色、字型、間距、圓角與語義 Token 的公開使用契約。
視覺基礎與 Token
Qokit 的平台介面使用清透、專業、節制的藍色體系。開發者應透過語義 Token 適配主題,不在業務元件中複製色值、陰影、圓角或字型。
核心角色
| 角色 | 推薦 Token | 用途 |
|---|---|---|
| 頁面背景 | --bg、--page-background | 頁面底色和整體空間 |
| 內容表面 | --panel、--card-surface | 面板、內容卡片 |
| 控件表面 | --control-surface、--control-surface-hover、--control-surface-active、--input-surface | 按鈕、搜尋、輸入框與互動狀態 |
| 浮層表面 | --dropdown-surface、--dialog-surface | 選單、Popover、Dialog |
| 邊界 | --panel-border、--control-border、--input-border | 分隔和狀態邊界 |
| 文字 | --text、--muted | 主要與次要資訊 |
| 品牌互動 | --accent、--link-color、--link-hover-color | 連結、選中和輕量強調 |
| 鍵盤焦點 | --focus-ring | focus-visible 狀態 |
| 圓角 | --card-radius、--button-radius、--button-pill-radius | Card 與控件形狀 |
| 按鈕字型大小 | --button-font-size-sm、--button-font-size-md、--button-font-size-lg | 共享按鈕的尺寸級排版 |
| 字型 | --font-heading、--font-body | 標題與正文/控件 |
排版
- Space Grotesk 用於品牌標題、頁面標題和關鍵數字;
- Manrope 用於正文、按鈕、表單、表格和工作區;
- 工作區保持緊湊,不使用行銷頁尺度的大標題;
- 中文不增加英文式寬字距,長翻譯不得擠壓相鄰操作。
間距與尺寸
- 使用 4px 節奏:8、12、16、20、24、32、48、64、96;
- 緊湊控件的點擊高度不低於 40px;
- 預設操作高度為 44px,行動裝置主要操作不低於 44px;
- 共享按鈕按
sm、md、lg分別使用 14px、15px、16px 文字,不繼承所在容器的字型大小; - 平台內容寬度通常不超過 1160px,生成站點內容通常不超過 1120px。
主題規則
- 淺色和深色主題必須複用相同的語義 Token;
- 一般 Dialog 使用
--dialog-surface提供輕微縱向漸變,圓角與 Card 共用--card-radius; --accent用於連結、焦點、選中和進度,不用於大面積鋪底;- 普通未選中控件 hover 使用中性
--control-surface-hover;按下、選中、目前和展開狀態使用品牌淺底--control-surface-active。focus-visible在中性表面上疊加--focus-ring;輸入框 focus/active 繼續使用輸入狀態 Token; - 狀態顏色只表達成功、警告和危險;
- 生成站點可以覆蓋主題變數,但必須保持正文對比度和明確的 CTA 層級。