知識衛星設計系統
把 Figma「知識衛星 - 設計系統 v1.1」轉成 CSS:顏色、字級、陰影是 CSS 變數,元件是 class。單檔 HTML、活動頁直接引入一行就能用;React/Vue 專案也可以直接用同一套 class。
1. 引入
把這行放進 <head>(含 tokens、元件、icon,約 60 KB):
只想要顏色、字級等變數,不要元件 class,就改引 css/sat-tokens.css。另外也有 tokens.json、icons.json 可下載。
2. 加上 .sat
在 <body> 或最外層容器加 class="sat",就會套用系統字體(PingFang TC)與內文色。
3. 複製元件
下面每個元件都可以:點「HTML」展開程式碼再按「複製」,或直接點畫面上的元件複製那一顆的 HTML。
is-hover、is-pressed、is-focus 固定顯示狀態,複製時會自動拿掉;實際使用時滑鼠移上去就會出現。若 prototype 想固定顯示某個狀態,可以自己加回這些 class。4. 自訂顏色
元件只讀 semantic 變數(--sat-color-*)。要換某一頁的主色,覆寫變數就好:
.campaign-page {
--sat-color-primary: var(--sat-red-500);
--sat-color-primary-hover: var(--sat-red-400);
--sat-color-primary-active: var(--sat-red-600);
}
與 Figma 的差異、待確認
照 Figma 數值做,以下是 Figma 沒定義或前後不一致、這裡先自己決定的地方:
- Dark 模式:Figma 沒有 Dark 變數,這版先不做,結構已預留(
[data-theme="dark"])。目前只有 Pagination 有 Figma 的深色版。 - 表單錯誤紅
#e44048、Checkbox hover 藍#2e92fa、Message 四個圖示顏色,Figma 都是直接填色、沒有建 style,這裡照原值收進 tokens。 - 輸入框 focus:Figma 的 focus 陰影數值是 0(看不到),這裡加了 3px 淡藍光暈。TextArea 的 focus 框在 Figma 是灰色
#adaeb3、hover 是#b8bcc5,這裡統一跟 Input 一樣(藍色 focus、#a6a6a6hover)。 - Breadcrumb:Figma 的 Default 和 Hover 都是
#a6a6a6,這裡 hover 與目前頁改成#333。 - Button:Error & Courses 的 L 尺寸在 Figma 有兩顆 padding 是 8/16(其他 L 都是 12/24),這裡統一 12/24。L 尺寸字級與 M 一樣是 14。
- Role tag「AI 助教」的漸層外框,顏色是推估(Primary 400 → Note 500)。
- 命名:Figma 的
Btn-Seconday色系收在--sat-graphite-*;Error & Course色系收在--sat-red-*;Error 300 與 400 在 Figma 是同一個色值。 - 沒有做的:Header、Footer、Menu、Comment、Upload、Card 等跟頁面綁很深的元件,以及 Slider(Figma 標示跳過)。
Color
點色塊複製 CSS 變數。上方是元件用的語意色(之後 Dark 只換這層),下方是 Figma Color styles 原值。
Semantic
Primitive
Typography
字體 PingFang TC(Windows 會退到 Noto Sans TC/微軟正黑體)。M = Medium 500,R = Regular 400;加 .sat-medium 切粗細。
Shadow/Radius
--sat-shadow-card--sat-shadow-plan--sat-shadow-block--sat-shadow-popoverIcon
用 CSS mask 做的 icon,顏色跟著文字色(color),大小用 .sat-icon--16/--20/--24。點 icon 複製寫法;需要 SVG 原檔可下載 icons.json。目前收 34 個常用的,Figma 共 169 個,需要哪個再補。
Text Link
sat-link(藍)、--secondary(黑);--lg 16px。停用加 aria-disabled="true"。
Input
.sat-field 包住標題、輸入框和提示文字。錯誤狀態在 .sat-field 加 is-error;大尺寸加 .sat-input--lg(48 高、16px)。
TextArea
Select
原生 <select>,手機上會叫出系統選單。第一個選項設 value="" 加 required,沒選時就是灰色 placeholder。
Checkbox
M(12px,預設)、.sat-checkbox--lg(16px)。
Radio
Toggle
Pagination
目前頁加 aria-current="page";第一頁時「上一頁」加 disabled。深色底用 .sat-pagination--dark。
Tabs/Chip
Ver-1 .sat-tabs(18px,黑色底線;--md 16px)、Ver-2 .sat-tabs--primary(藍色)。選中加 aria-selected="true"。
Chip(Figma: Tabs / Label)
膠囊篩選,選中加 aria-pressed="true"。
Tag
M 28(預設)、--sm 22。Type:Primary(預設)、--neutral、--discount、--orange、--secondary。
Role tag(Figma: User Container)
Badge
Tooltip
靜態樣式 .sat-tooltip,箭頭方向 --top/--left/--right(預設朝下)。滑過顯示可以直接用 data-tooltip:
Collapse
用原生 <details>,不用寫 JS。平板以下(<1024)內距自動從 32 縮成 24。
募資課程是什麼?
購買後可以退費嗎?
Empty
查無結果
換個關鍵字再試試看
Message
Modal
桌機/平板寬 387,手機自動縮成螢幕寬減 40。外層 .sat-modal-backdrop 是半透明遮罩。
Dialog 標題
敘述文字敘述文字敘述文字敘述文字敘述文字敘述文字敘述文字敘述