綁定至設計系統庫
產品畫面必須使用專案的設計系統,而非僅依賴圖層本機設定。
選擇預設配置
每個設計系統都有一個預設配置,位於 presets/ 中。詢問使用者專案使用哪個系統,或檢查專案的依賴項(例如,如果專案依賴於設計 token 套件,則使用匹配的預設)。有關格式,請參閱 presets/README.md。如果沒有預設,請按照下方「自動綁定運作方式」一次性查找,然後將結果儲存為新的預設。如果專案沒有庫,請寫入「無」並在報告中說明。
開始之前,請使用 get_libraries 確認每個庫都已存在於 libraries_added_to_file 中。對於任何缺失的庫,請使用者在 Figma 中的「Assets › Libraries」下新增它們;在新增完成之前不要繼續。
綁定規則
與其改變畫面,不如保留未綁定的狀態。此工具僅執行以下操作;其餘部分保持本機狀態並在報告中列出。
| 類型 | 規則 | 不要做 |
|---|---|---|
| 顏色 | 僅在完全匹配時綁定,包括透明度。半透明顏色需要一個具有該透明度的 token,因為 Figma 在綁定時會將不透明度重置為 1 | 不要捕捉到最接近的顏色 |
| 圓角、描邊、間距、字級尺寸 | 僅在數值完全相等時綁定 | 不要將 3px 改為 2px 或 4px |
| 別名 token | 指向另一個 token(原始 token 之上的語意 token)的 token,以其鏈結末端的最終值為準。當一個值同時擁有兩者時,擁有自身值的 token 優先;僅在其他值都沒有時才使用別名 | 不要透過猜測在兩個具有相同值的語意 token 之間選擇;請報告此情況 |
| 文字樣式 | 僅在字體、字級和行高全部相等時綁定 | 如果字體不同,僅綁定字級 |
| 圖示 | 僅在庫中存在相同名稱的元件時才進行替換;僅接受已確認具有相同用途的舊名稱映射 | 不要使用意義相似但外觀不同的圖示 |
| 元件 | 僅在庫元件外觀與產品相同時才進行替換;保留產品的大小 | 如果外觀不同,保留本機元件且不更改產品畫面 |
為什麼不捕捉最接近的值:匹配的值並不代表匹配的意義,而且會導致狀態面板與程式碼不一致。沒有匹配 token 的值是設計系統中的一個缺口;將其列出供設計決定,而不是讓工具自行選擇。
自動綁定運作方式
如果已有預設,請在 al-capture.cjs 配置中設定 preset,並將預設名稱作為第四個引數傳遞給 al-pack.py;畫面在構建時會自動綁定。僅在沒有預設的情況下,請按照以下流程操作,然後將結果儲存為 presets/<name>.json:libs 是綁定配置,extract 是在提取過程中使用的精靈映射。
- 提取佈局樹後,列出 JSON 中的每個
lib(圖示名稱) - 對於每個名稱,使用
search_design_system搜尋圖示系統:system:cross映射到icon / system / cross。僅接受完全匹配的名稱 - 使用
search_design_system尋找元件集,放置幾個實例,截取螢幕截圖,將其外觀與產品進行比較,然後決定buttons.rules - 組裝
opts.libs。先建立 3-4 張卡片並檢查log.drift和螢幕截圖;僅在外觀正確時才批次處理
const libs = {
tokens: ['My DS - Foundation'], // 從這些庫讀取變數
icons: { 'system:cross': '<componentKey>' },
buttons: {
set: '<componentSetKey>',
rules: { FFE13A: { Type: 'primary', Size: 'medium', Compact: 'false', Status: 'default' } }, // key 是按鈕背景顏色
},
words: { value: 'Price' }, // 重新命名文字屬性以匹配團隊的術語
};
al-capture.cjs 的輸出包含 unmappedIcons,列出了本次使用但預設尚未映射的圖示。使用 search_design_system 查找它們,並將完全匹配的名稱新增到預設中;下次它們會自動綁定,因此預設會隨著使用而變得更完整。
__alBuild 返回的 stat 具有綁定結果:boundColors、boundLayout、libIcons、dsButtons、unboundColors、localIcons。
綁定現有畫面
al-bind.js 可以單獨使用。它僅綁定 token,不會替換圖示或元件。將整個腳本貼到 use_figma 中(或使用 eval 載入),然後呼叫:
return await __alBind(['<frame id>'], { tokens: ['<library name>'] });
它會返回 boundColors、boundLayout 和 unboundColors(沒有 token 的顏色)。skippedText 統計了無法載入字體的文字數量,因此其字級保持未綁定狀態。
當使用 __alBuild 構建畫面時,token 表會快取在 _registry 中,因此後續畫面無需再次匯入每個變數。當預設列出了不同的 token 庫時,它會重新建立。在庫發布新的或更改的 token 後,請將 refreshTokens: true 傳遞給下一個 __alBuild 呼叫。
元件
- 使用自動佈局居中:不要使用內邊距或文字框寬度,以免更改文字時位移
- 容器不是元件:一個已經包含元件的重複結構只是一個容器
- 狀態是變體:選中和禁用必須透過屬性切換,而不是透過覆蓋實例顏色
- 將小型元件拆分為屬性:兩個變體屬性
Type和State;將文字設為元件屬性 - 主元件必須完整:不要將被視口裁切的元素製作成元件
報告
始終列出:
- 綁定比率:顏色、佈局數值
- 替換為庫版本的圖示和元件數量
- 沒有 token 的顏色(前幾個),供設計決定
- 保留在本機的圖示和元件及其原因