跳到內容
開始使用

Default

Default 預設

預設主題。顏色直接取自 UIKit 正式的色彩設定(設計數值,token:每個有名字的顏色、字級、間距);其他主題沒有特別指定的顏色,都沿用這一套。

誰在用:沒有指定主題的網站都用它。

在整份手冊套用這個主題 手冊其他頁的色票與元件範例會換成 Default 的樣子;之後也可以在頁首的「主題」改回來。

淺色與深色

同一個迷你網頁,用這個主題的淺色、深色各畫一次。

易讀性檢查

文字和底色的「對比值」越高越好讀。一般大小的文字要 4.5 : 1 以上(WCAG 無障礙標準 AA 級)。「主色」的兩項和主題有關;「次要文字」是所有主題共用的正式顏色,目前未達標,要另外處理;這不是主題造成的。

檢查項目 模式 文字 底色 對比值
主色按鈕上的文字 淺色 #FFFFFF #1B2D58 13.44 : 1 通過
背景上的主色文字 淺色 #1B2D58 #FFFFFF 13.44 : 1 通過
背景上的次要文字(所有主題共用) 淺色 #828282 #FFFFFF 3.84 : 1 未達 4.5
主色按鈕上的文字 深色 #1B2D58 #A9C2EA 7.42 : 1 通過
背景上的主色文字 深色 #A9C2EA #1C1C1E 9.39 : 1 通過
背景上的次要文字(所有主題共用) 深色 #B3B3B3 #1C1C1E 8.11 : 1 通過

全部語意色

「語意色」是依用途命名的顏色(例如「主色」「次要文字」),元件只認這些名字。主題做的事,就是決定每個名字在這個主題裡用哪個顏色。

用途 變數名稱(工程用) 淺色 深色
主色 --tc-color-brand-primary #1B2D58 #A9C2EA
主色(滑鼠移上時;連結文字也用它) --tc-color-brand-primary-hover #30559F #C2D4F2
品牌底色(襯在內容後的品牌色塊) --tc-color-brand-surface #E8EEFE #1B2D58
品牌底色(滑鼠移上時) --tc-color-brand-surface-hover #D1DEFF #30559F
中性底色 --tc-color-neutral-surface #F2F2F2 #333333
中性底色(滑鼠移上時) --tc-color-neutral-surface-hover #E0E0E0 #4F4F4F
文字 --tc-color-text-default #333333 #F2F2F2
次要文字 --tc-color-text-muted #828282 #B3B3B3
停用文字 --tc-color-text-disabled #B3B3B3 #828282
主色上的文字 --tc-color-text-on-brand #FFFFFF #1B2D58
背景 --tc-color-surface-default #FFFFFF #1C1C1E
淡背景 --tc-color-surface-subtle #F8F8F8 #161618
邊框 --tc-color-border-default #BDBDBD #6B6B6E
強調邊框 --tc-color-border-strong #828282 #95969B
焦點框(用鍵盤選到時的外框) --tc-color-border-focus #4F7BBE #A9C2EA
錯誤提示 --tc-color-feedback-error #D4494F #F08A8E
成功提示 --tc-color-feedback-success #168967 #3FBF8F
警告提示 --tc-color-feedback-warning #B45309 #FBBF24
資訊提示 --tc-color-feedback-info #1B2D58 #A9C2EA

如何使用

  • 工程師:提案 在網頁最外層的 <html> 加上 data-site="default",元件就會換成這個主題的顏色;色彩模式(淺色/深色)沿用現有的 data-theme="light"/"dark"(不寫時跟著訪客的裝置設定)。兩者可以自由組合,例如 <html data-site="default" data-theme="dark"> 就是 Default 的深色。屬性名稱是工程細節,還沒定案。
  • 美編(設計)、致遠(廠商):Default 是預設主題。改它的顏色,所有主題沒有自己改過的地方都會一起變。跟 Claude 說要改什麼,Claude 會先列出用到這個顏色的檔案和頁面,請你確認。