設計系統 是做什麼的?
概述
設計系統是一個決策只做一次、然後到處重複使用的地方。每個顏色都是一個代幣,每個互動元件都顯示其所有狀態,而每項變更都會觸及所有使用該元件的畫面。按層次構建,先建立基礎,並在每一層停下來等待批准。稽核只報告,絕不自行修復。
使用時機
- 「為……開始建立樣式指南 / 設計系統 / 代幣」
- 新增元件、變體或代幣,或更改現有項目。
- 「讓這些畫面一致」、「標準化」、「稽核指南」,或畫面中存在鬆散的十六進位顏色值和一次性元件。
不應使用的情況
- 關於某個值的問題(「我們的主色是什麼?」):直接回答它。
- 使用者準確描述的一個小編輯(一個值、一個標籤、一個尺寸),即使是在共享元件上:在其定義處更改一次,並說明影響哪些畫面。不需要狀態矩陣,也無需停止。
開始之前
- 如果專案根目錄存在
DESIGN.md,請閱讀它:這是專案的設計簡報。 - 找出已存在的內容:代幣、指南、元件、畫面和程式碼。現有的指南在視覺外觀上具有最高權威。 即使與下面的預設值不同,也要遵循其規則,並指出差異一次。
- 在
references/adapters/中選擇你工具的轉接器(paper.md、figma.md、html.md)。如果沒有轉接器符合你的工具,請在你的工具中執行相同的操作,並說明哪些是你手動映射的。如果完全沒有設計工具,則使用 HTML 構建(html.md)。如果你只有一張圖片,請說明從中讀取的值均為估計值。 - 決定模式:建立、新增或更改,或稽核。
步驟 · 建立
-
基礎草稿:
- 顏色角色(參見 代幣角色);
- 字體比例;
- 間距;
- 圓角;
- 陰影(最多兩個);
- 佈局寬度;
- 動畫持續時間;
- 簡短的「寫作風格」部分。
依照角色命名代幣(如
text-muted、border-hover、danger-bg),絕不要僅按值命名(如gray-500)。 -
互動規則(一次設定): 針對有邊框元件、無邊框元件和主要操作,寫下其懸停、按下、焦點(僅限鍵盤)、禁用、載入和選中狀態的外觀。每個元件都應遵循這些規則,而不是各自發明一套。
-
停下來,向使用者展示基礎草稿和互動規則。 在獲得批准前,不要構建元件。
-
一次一個元件,按照第一個畫面所需的順序。 每個元件在指南中都應有一個章節,內容包含元件解剖:包含規則及其原因的圖例、範例,以及一個 變體 × 狀態 的狀態矩陣。將每個元件加入元件索引中。
步驟 · 新增或更改元件
- 檢查現有元件加上一個變體是否能滿足需求。優先考慮重用,而非建立一次性元件。
- 使用解剖結構繪製它,包括完整的狀態矩陣。新的顏色、尺寸或圖示應立即成為代幣或圖示集條目,而不是以後再說。
- 列出所有使用該元件的畫面和程式碼位置。
- 停下來,向使用者展示這個變更和那份清單。
- 獲得批准後,進行傳播:
- 更新清單上的每個畫面;
- 更新程式碼(如果有的話);
- 更新元件索引;
- 報告哪些地方發生了什麼變更。
步驟 · 稽核
- 對指南、畫面及任何程式碼執行稽核檢查清單。
- 撰寫報告:按嚴重性排序調查結果,每個結果需說明位置、重要性以及建議的修復方法。
- 停下來,向使用者展示報告。在他們指定要修復哪些問題之前,不要更改任何檔案。 保存原始檔案的副本並不能使編輯它們變得可接受。
規則
嚴格規則(任何專案均適用):
| 規則 | 原因 |
|---|---|
| 所有顏色都是代幣;畫面和程式碼中不得有鬆散的十六進位值 | 鬆散的值會逐漸變成近似的重複項,導致無法一次性更改 |
| 僅使用一個圖示集 | 混用圖示集看起來像混合了不同的產品 |
| 設計與程式碼同步更改,且設計優先 | 否則指南會在一週內失去真實性 |
| 每個互動元件都須有狀態矩陣 | 臨時繪製的狀態永遠無法協調一致 |
| 對共享元件的更改,在傳播前需列出受影響的畫面 | 否則一次「小」更改會悄無聲息地重新設計二十個畫面 |
預設值(現有指南可覆蓋它們):
| 預設值 | 原因 |
|---|---|
| 懸停時,有邊框元件僅加深邊框顏色 | 卡片和欄位上的背景變化會顯得很沉重 |
| 懸停效果應比選中效果更微妙 | 當懸停看起來像選中時,使用者會以為選了兩個東西 |
| 選中時切勿改變字體粗細 | 粗細變化會改變文字的寬度 |
| 佔位文字比淺色文字更淺 | 否則佔位文字會被誤讀為已輸入的文字 |
| 堆疊列表和選單中的項目應有細微間距,不可相連 | 相連的選中高亮會合併成一個色塊 |
| 焦點環僅在鍵盤操作時出現 | 滑鼠點擊後出現焦點環看起來像一個錯誤 |
| 載入狀態保持元素原有尺寸 | 避免佈局偏移 |
| 陰影僅用於浮動元素(選單、彈出視窗、對話框、提示訊息),分為兩種強度 | 到處使用陰影會破壞它們本應創造的層級 |
| 每個畫面最多一個主要操作按鈕 | 兩個主要按鈕表示畫面沒有做出決定 |
完成條件
- 建立: 基礎和互動規則已獲批准;每個元件都有其解剖結構、狀態矩陣和索引條目。
- 更改: 清單上的每個畫面和程式碼位置都已更新,並且索引也已更新。
- 稽核: 已交付一份分級報告,且未更改任何檔案。
常見錯誤
| 想法 | 現實 |
|---|---|
| 「我會一次性建立整個指南:代幣和十個元件」 | 在未經批准的基礎上建立十個元件意味著十次重做。先建立基礎,得到批准,再建立元件。 |
| 「稽核發現了問題,我直接修復就好了」 | 使用者可能不同意其中一半的修復方案。先報告,停下來,只修復他們選擇的。 |
| 「我把原始檔案備份了,所以修復是安全的」 | 備份並不能讓使用者同意你的修復。先報告。 |
| 「按鈕有懸停和禁用狀態,夠了」 | 狀態矩陣應包含每個狀態 × 每個變體:普通、懸停、按下、焦點、禁用、載入、選中。 |
「--teal-600 就是一個代幣」 | 它只是一個值。元件需要角色(如 --color-primary),這樣值才能在一處修改。 |
| 「這個畫面需要一個略有不同的卡片」 | 將其製作為卡片的變體,或者直接使用卡片。一次性元件是偏離的開始。 |