設計 token:總覽
設計 token 是所有 UI 元素的建構基礎。設計、工具與程式碼皆使用相同的 token。
- token 會指向樣式值,例如色彩、字體與度量值
- 使用設計 token,而非硬編碼值
- 每個 token 會依其用途或套用位置命名(例如 md.comp.fab.primary.container.color 會設定 FAB 的容器色彩)
- 即使 token 的最終值變更,其名稱與用途仍維持不變
- Material Design 有三類 token:參照 token、系統 token 與 元件 token

資源
| 類型 | 連結 | 狀態 |
|---|---|---|
| 設計 | 設計套件(Figma) | 可用 |
| Material Theme Builder Figma 外掛程式 | 可用 | |
| 實作 | Material 基準主題與 token(DSP) | 可用 |
什麼是設計 token?
設計 token 是構成設計系統視覺風格且可重複使用的小型設計決策。token 以能說明用途的名稱取代靜態值。
設計 token 由兩部分組成:
- 類似程式碼的名稱,例如 md.ref.palette.secondary90
- 對應的值,例如 #E8DEF8
token 的值可以是色彩、字體、度量值,甚至另一個 token。

設計 token 可為原本缺乏明確關聯的樣式選擇建立有意義的連結。
例如,若設計稿與工程實作都參照同一個代表「secondary container color」的 token,設計師與工程師就能確保兩處使用相同色彩;即使該 token 的十六進位色值日後更新,也不例外。

為什麼 token 很重要?
token 讓設計系統擁有單一事實來源:一個記錄樣式選擇並可追蹤變更的儲存庫。
由於 token 可重複使用且以用途為導向,因此能定義全系統的主題與情境式更新。例如,你可以使用 token 系統性地套用高對比調色盤來提升可見度,或變更字級,以確保文字在電視螢幕上清晰可讀。
在設計與實作中使用 token,樣式更新便能一致地套用到整個產品或系列產品。token 也能協助設計師與工程師使用共同的語言,減少從設計交付到實作過程中的混淆。

判斷 token 是否適合你
token 在以下情況最有幫助:
- 你計畫更新產品設計,或正從零開始建置產品
- 你的設計系統會套用到一系列產品或平台
- 你希望未來能輕鬆維護或更新樣式
- 你想充分發揮 Material Design 系統的效益,包括動態色彩等功能
token 在以下情況幫助較小:
- 你的現有應用程式採用硬編碼值,且未來一兩年內不太可能變更
- 你的產品沒有設計系統
token 與 Material Design
過去,Material 樣式是透過設計指南、設計檔案、工具,以及各平台專屬的元件庫來傳達。
現在,透過設計 token,你可以下載、自訂並套用 Material 樣式,並將這些樣式整合至設計與開發流程中。
token 能以平台無關且可共用的格式記錄設計決策。

在本網站中,token 會列於互動式模組中。
這些模組可讓你快速查閱 token 針對色彩、字體、字體大小、字體粗細等所儲存的預設基準值,也會顯示角色、其系統 token、參照 token 與所儲存預設值之間的關係。

你也會在元件文章的「規格」分頁標籤中看到 token。
token 會先依狀態分組(啟用、停用、懸停等),再依元素分組;元素是 token 或值所套用到的元件部位,例如容器或標籤文字。
欄位包括:
- 名稱 – token 所套用的元件樣式屬性,例如色彩或字體
- token ID – 定義元件樣式屬性的 token
- 說明 – 選填的描述資訊
- 情境/值 – token 針對指定情境所儲存的值

如何使用 token 模組
假設你需要確認填滿按鈕標籤文字所使用的色彩角色。
前往「一般按鈕」 > 「規格」,找到填滿按鈕的 token 模組,並在「元素」分類下尋找「標籤文字」token。
複製色彩 token 並貼到程式碼中,或與 Figma 中的色彩角色進行比對。

token 名稱的組成部分
token 名稱的各個部分以句點分隔,並由最通用的資訊(「md」)依序排列至最具體的資訊(「on-secondary」)。
- 設計系統中的所有 token 名稱都以系統名稱開頭(例如 Material Design 的「md」)
- token 類別的縮寫:參照 token 使用「ref」、系統 token 使用「sys」、元件 token 使用「comp」
- token 名稱結尾為描述性詞彙,用來說明 token 的角色

- 標示所屬設計系統
- 標示 token 類別
- 說明 token 用途
token 類別
Material 中有三類 token:
- 參照 token
所有可用的 token 及其對應值。 - 系統 token
賦予設計系統特色的決策與角色,涵蓋色彩、字體排印、高度與形狀。 - 元件 token
指派給元件中各元素的設計屬性,例如按鈕圖示的色彩。
透過這三類 token,團隊可以全域更新設計決策,或只對單一元件套用變更。

參照 token
這些 token 構成設計系統中所有可用的樣式選項。
這些 token 通常指向靜態值,例如十六進位色碼或字體大小,但也可以指向其他參照 token。參照 token 不會隨情境而改變。
參照 token 提供選項清單,讓團隊能以經核可的色彩、字體排印、度量值等作為起點。
所有參照 token 都以前綴 ref 開頭。

系統 token
這些 token 會將特定主題或情境的設計語言系統化。
系統 token 定義參照 token 在 UI 中的使用目的與角色。
主題設定即在此進行。系統 token 可依情境(例如淺色或深色主題)指向不同的參照 token。
系統 token 應盡可能指向參照 token,而非靜態值。
所有系統 token 都以前綴 sys 開頭。

元件 token(開發中)
這些 token 代表構成元件所需的元素,例如容器、標籤文字、圖示與狀態,以及對應的值,例如大小、形狀、色彩或高度。
元件 token 應盡可能指向系統 token 或參照 token,且不應包含十六進位色碼等硬編碼值。
並非元件中的每項樣式選擇都能以 token 表示;但當某項設計選擇適用於多個用途相近的元件時,就應使用 token。
所有元件 token 都以前綴 comp 開頭。

情境
token 可依一組條件指向不同的值。這些條件稱為情境,其產生的值稱為情境值。
不同情境的範例包括:裝置外型、深色主題、高密度版面配置,以及由右至左的書寫系統。
你可以將情境視為一種標籤。若某個 token 值標記為深色主題,該值便會在深色主題情境中覆寫預設 token 值。
