Skip to Content
設計

視覺基礎與 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-ringfocus-visible 狀態
圓角--card-radius、--button-radius、--button-pill-radiusCard 與控件形狀
按鈕字型大小--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 層級。

本頁目錄