Skip to content
Material Design 3
Main Navigation
v3
v2
v1

繁體中文

English
简体中文
Español
Français
Русский
Português – Brasil
Deutsch
日本語
한국어
Italiano
Polski
Türkçe
čeština
magyar

繁體中文

English
简体中文
Español
Français
Русский
Português – Brasil
Deutsch
日本語
한국어
Italiano
Polski
Türkçe
čeština
magyar

外觀

Sidebar Navigation

基礎

無障礙

總覽:原則

概覽:輔助技術

設計:總覽

設計:色彩對比

設計:結構

設計:流程

設計:元素

寫作與文字:最佳實務

撰寫與文字:文字截斷

撰寫與文字:文字縮放

為所有人打造:使用者需求

為所有人打造:共同設計

內容設計

總覽

替代文字

全球寫作:總覽

全球寫作:用詞選擇

通知

樣式指南:UX 寫作最佳實務

樣式指南:用詞選擇

風格指南:文法與標點

自訂 Material

裝置

手錶設計:總覽

手錶設計:基礎

手錶設計:樣式

手錶設計:版面配置

XR

沉浸式 XR 設計:總覽

沉浸式 XR 設計:互動

沉浸式 XR 設計:版面配置

為沉浸式 XR 設計:無障礙

XR 元件:總覽

XR 元件:應用程式列

XR 元件:對話方塊

XR 元件:導覽列

XR 元件:導覽軌

XR 元件:工具列

設計 token:總覽

設計 token:如何使用 token

互動

手勢

輸入裝置:基礎

選取:總覽

狀態:總覽

狀態:狀態層

狀態:套用狀態

版面配置

版面配置總覽:總覽

版面概覽:版面的組成部分

版面配置概覽:自適應設計

Scaffold: 概述

Scaffold:列

Scaffold:導軌

Scaffold:窗格

網格與間距:總覽

網格與間距:網格

網格與間距:間距

格線與間距:密度

中斷點:總覽

中斷點:精簡

中斷點:中型

中斷點:展開式

中斷點:大型與超大型

雙向性與 RTL

標準版面配置範例:總覽

標準版面配置範例:資訊流

標準版面配置範例:清單-詳細資料

標準版面配置範例:輔助窗格

易用性:總覽

可用性:應用 M3 Expressive

Material A-Z

樣式

色彩

色彩系統:總覽

色彩系統:系統的運作方式

色彩角色

配色方案

選擇色彩方案

靜態色彩配色方案:Baseline

靜態色彩配色方案:自訂品牌

動態配色:選擇來源色

動態色彩配色方案:使用者產生的來源

動態色彩配色方案:基於內容的來源

進階自訂:總覽

進階自訂:套用色彩

進階自訂:定義新色彩

進階自訂:調整現有色彩

色彩資源

高度:總覽

高度:套用高度

高度:token

圖示:總覽

圖示:設計圖示

圖示:套用圖示

動態效果

動態物理系統:運作方式

動態物理系統:規格

緩動與持續時間:套用緩動與持續時間

緩動與持續時間:token 與規格

轉場:轉場模式

轉場:套用轉場

形狀:總覽與原則

形狀:圓角半徑尺度

形狀:形狀變形

間距:總覽

間距:套用間距

間距:token

字體排印:總覽

字體排印:字體

字體排印:字階與 token

字體排印:套用字體樣式

字體排印:編輯式處理

元件

應用程式列:總覽

應用程式列:規格

應用程式列:指南

應用程式列:無障礙功能

徽章:總覽

徽章:規格

徽章:指南

徽章:無障礙

按鈕

所有按鈕

按鈕群組:總覽

按鈕群組:規格

按鈕群組:指南

按鈕群組:無障礙

按鈕:總覽

按鈕:規格

按鈕:指南

按鈕:無障礙

擴充 FAB:總覽

擴充 FAB:規格

擴充 FAB:指南

擴充 FAB:無障礙

FAB 選單:總覽

FAB 選單:規格

FAB 選單:指南

FAB 選單:無障礙

浮動操作按鈕(FAB):總覽

浮動操作按鈕 (FAB):規格

浮動操作按鈕(FAB):指南

浮動操作按鈕(FAB):無障礙

圖示按鈕:總覽

圖示按鈕:規格

圖示按鈕:指南

圖示按鈕:無障礙

分段按鈕:總覽

分段按鈕:規格

分段按鈕:指南

分段按鈕:無障礙

分割按鈕:總覽

分割按鈕:規格

分割按鈕:指南

分割按鈕:無障礙

卡片:總覽

卡片:規格

卡片:指南

卡片:無障礙

輪播:總覽

輪播:規格

輪播:指南

輪播:無障礙

核取方塊:總覽

核取方塊:規格

核取方塊:指南

核取方塊:無障礙

晶片:總覽

晶片:規格

晶片:指南

晶片:無障礙

日期與時間選擇器

日期選擇器:總覽

日期選擇器:規格

日期選擇器:指南

日期選擇器:無障礙設計

時間選擇器:總覽

時間選擇器:規格

時間選擇器:指南

時間選擇器:無障礙功能

對話方塊:總覽

對話方塊:規格

對話方塊:指南

對話方塊:無障礙

分隔線:總覽

分隔線:規格

分隔線:指南

分隔線:無障礙

清單:總覽

清單:規格

清單:指南

清單:無障礙

載入與進度

載入指示器:總覽

載入指示器:規格

載入指示器:指引

載入指示器:無障礙

進度指示器:總覽

進度指示器:規格

進度指示器:指南

進度指示器:無障礙

選單:總覽

選單:規格

選單:指南

選單:無障礙

導覽

導覽列:總覽

導覽列:規格

導覽列:指南

導覽列:無障礙

導覽匣:總覽

導覽匣:規格

導覽匣:指南

導覽匣:無障礙

導覽軌:總覽

導覽軌:規格

導覽軌:指南

導覽軌:無障礙

選項按鈕:總覽

選項按鈕:規格

選項按鈕:指南

選項按鈕:無障礙

搜尋:總覽

搜尋:規格

搜尋:指南

搜尋:無障礙

工作表

底部工作表:總覽

底部工作表:規格

底部工作表:指南

底部工作表:無障礙

側邊工作表:總覽

側邊工作表:規格

側邊工作表:指南

側邊工作表:無障礙

滑桿:總覽

滑桿:規格

滑桿:指南

滑桿:無障礙

提示條:總覽

提示條: 規格

提示條:指南

提示條:無障礙功能

開關:總覽

開關:規格

開關:指南

開關:無障礙

分頁標籤:總覽

分頁標籤:規格

分頁標籤:指南

分頁標籤:無障礙

文字欄位:總覽

文字欄位:規格

文字欄位:指南

文字欄位:無障礙

工具列:總覽

工具列:規格

工具列:指南

工具列:無障礙功能

工具提示:總覽

工具提示:規格

工具提示:指南

工具提示:無障礙

本頁導覽

設計 token:總覽 ​

設計 token 是所有 UI 元素的建構基礎。設計、工具與程式碼皆使用相同的 token。


  • token 會指向樣式值,例如色彩、字體與度量值
  • 使用設計 token,而非硬編碼值
  • 每個 token 會依其用途或套用位置命名(例如 md.comp.fab.primary.container.color 會設定 FAB 的容器色彩)
  • 即使 token 的最終值變更,其名稱與用途仍維持不變
  • Material Design 有三類 token:參照 token、系統 token 與 元件 token
設計稿、程式碼與產品中的 FAB 容器色彩 token
使用設計 token 取代硬編碼值,可簡化以設計系統建置、維護及擴充產品的工作

資源 ​

類型連結狀態
設計設計套件(Figma)可用
Material Theme Builder Figma 外掛程式可用
實作Material 基準主題與 token(DSP)可用

什麼是設計 token? ​

設計 token 是構成設計系統視覺風格且可重複使用的小型設計決策。token 以能說明用途的名稱取代靜態值。

設計 token 由兩部分組成:

  1. 類似程式碼的名稱,例如 md.ref.palette.secondary90
  2. 對應的值,例如 #E8DEF8

token 的值可以是色彩、字體、度量值,甚至另一個 token。

token md.ref.palette.secondary90,箭頭指向淡紫色色票 #E8DEF8。
參照 token 及其色彩值範例

設計 token 可為原本缺乏明確關聯的樣式選擇建立有意義的連結。

例如,若設計稿與工程實作都參照同一個代表「secondary container color」的 token,設計師與工程師就能確保兩處使用相同色彩;即使該 token 的十六進位色值日後更新,也不例外。

FAB 圖解,標示系統 token:表面色彩使用 secondary,圖示色彩使用 on secondary
FAB 的容器與圖示分別使用 secondary 與 on secondary 色彩角色 token 的範例

為什麼 token 很重要? ​

token 讓設計系統擁有單一事實來源:一個記錄樣式選擇並可追蹤變更的儲存庫。

由於 token 可重複使用且以用途為導向,因此能定義全系統的主題與情境式更新。例如,你可以使用 token 系統性地套用高對比調色盤來提升可見度,或變更字級,以確保文字在電視螢幕上清晰可讀。

在設計與實作中使用 token,樣式更新便能一致地套用到整個產品或系列產品。token 也能協助設計師與工程師使用共同的語言,減少從設計交付到實作過程中的混淆。

示意圖,說明變更 token 值如何從設計系統串聯至產品領域與 3 項產品
隨著設計系統演進,某些值會改變。透過設計 token,我們可以追蹤變更,並確保所有產品維持一致。

判斷 token 是否適合你 ​

token 在以下情況最有幫助:

  • 你計畫更新產品設計,或正從零開始建置產品
  • 你的設計系統會套用到一系列產品或平台
  • 你希望未來能輕鬆維護或更新樣式
  • 你想充分發揮 Material Design 系統的效益,包括動態色彩等功能

token 在以下情況幫助較小:

  • 你的現有應用程式採用硬編碼值,且未來一兩年內不太可能變更
  • 你的產品沒有設計系統

token 與 Material Design ​

過去,Material 樣式是透過設計指南、設計檔案、工具,以及各平台專屬的元件庫來傳達。

現在,透過設計 token,你可以下載、自訂並套用 Material 樣式,並將這些樣式整合至設計與開發流程中。

token 能以平台無關且可共用的格式記錄設計決策。

設計 token 連接至設計工具與平台程式碼的示意圖
設計 token 為設計選擇提供中央儲存庫,並為工程師與設計師提供多個整合點

在本網站中,token 會列於互動式模組中。

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

色彩系統的 token 模組,包含主要色彩組的 4 個色票。
token 模組範例

你也會在元件文章的「規格」分頁標籤中看到 token。

token 會先依狀態分組(啟用、停用、懸停等),再依元素分組;元素是 token 或值所套用到的元件部位,例如容器或標籤文字。

欄位包括:

  • 名稱 – token 所套用的元件樣式屬性,例如色彩或字體
  • token ID – 定義元件樣式屬性的 token
  • 說明 – 選填的描述資訊
  • 情境/值 – token 針對指定情境所儲存的值
浮起式按鈕的 token 模組,依狀態(啟用、停用等)分組,再依元素(容器、標籤文字)分組。
浮起式按鈕的示意圖與 token 模組

如何使用 token 模組

假設你需要確認填滿按鈕標籤文字所使用的色彩角色。

前往「一般按鈕」 > 「規格」,找到填滿按鈕的 token 模組,並在「元素」分類下尋找「標籤文字」token。

複製色彩 token 並貼到程式碼中,或與 Figma 中的色彩角色進行比對。

如何找到標籤文字的色彩 token。
填滿按鈕標籤色彩的示意圖與 token 表

token 名稱的組成部分 ​

token 名稱的各個部分以句點分隔,並由最通用的資訊(「md」)依序排列至最具體的資訊(「on-secondary」)。

  1. 設計系統中的所有 token 名稱都以系統名稱開頭(例如 Material Design 的「md」)
  2. token 類別的縮寫:參照 token 使用「ref」、系統 token 使用「sys」、元件 token 使用「comp」
  3. token 名稱結尾為描述性詞彙,用來說明 token 的角色
設計 token 名稱 3 個部分的示意圖:系統前綴、token 類型與角色說明
  1. 標示所屬設計系統
  2. 標示 token 類別
  3. 說明 token 用途

token 類別 ​

Material 中有三類 token:

  1. 參照 token
    所有可用的 token 及其對應值。
  2. 系統 token
    賦予設計系統特色的決策與角色,涵蓋色彩、字體排印、高度與形狀。
  3. 元件 token
    指派給元件中各元素的設計屬性,例如按鈕圖示的色彩。

透過這三類 token,團隊可以全域更新設計決策,或只對單一元件套用變更。

色彩值儲存在參照 token、系統 token 與元件 token 中,並顯示為 FAB 的容器色彩
按鈕透過由三個 token 組成的系統取得容器色彩;這些 token 定義可擴充的色彩值。色彩 token 會指向特定十六進位色碼,該色碼可輕易變更,而不會影響 token 語法。

參照 token

這些 token 構成設計系統中所有可用的樣式選項。

這些 token 通常指向靜態值,例如十六進位色碼或字體大小,但也可以指向其他參照 token。參照 token 不會隨情境而改變。

參照 token 提供選項清單,讓團隊能以經核可的色彩、字體排印、度量值等作為起點。

所有參照 token 都以前綴 ref 開頭。

token md.ref.palette.secondary90 指向 #E8DEF8。token md.ref.typeface.plain-medium 指向 Roboto Medium
色彩與字體排印的參照 token 及其值

系統 token

這些 token 會將特定主題或情境的設計語言系統化。

系統 token 定義參照 token 在 UI 中的使用目的與角色。

主題設定即在此進行。系統 token 可依情境(例如淺色或深色主題)指向不同的參照 token。

系統 token 應盡可能指向參照 token,而非靜態值。

所有系統 token 都以前綴 sys 開頭。

系統 token md.sys.color.secondary-container 指向 token md.ref.palette.secondary90,再指向 #E8DEF8。系統 token md.sys.typescale.label-medium.font 指向 token md.ref.typeface.plain-medium,再指向 Roboto Medium
系統 token、參照 token 及其值

元件 token(開發中) ​

這些 token 代表構成元件所需的元素,例如容器、標籤文字、圖示與狀態,以及對應的值,例如大小、形狀、色彩或高度。

元件 token 應盡可能指向系統 token 或參照 token,且不應包含十六進位色碼等硬編碼值。

並非元件中的每項樣式選擇都能以 token 表示;但當某項設計選擇適用於多個用途相近的元件時,就應使用 token。

所有元件 token 都以前綴 comp 開頭。

擴充 FAB 的元件 token(容器色彩與標籤文字)指向系統 token,再指向參照 token,最後指向解析後的值
元件 token、系統 token、參照 token 及其值

情境 ​

token 可依一組條件指向不同的值。這些條件稱為情境,其產生的值稱為情境值。

不同情境的範例包括:裝置外型、深色主題、高密度版面配置,以及由右至左的書寫系統。

你可以將情境視為一種標籤。若某個 token 值標記為深色主題,該值便會在深色主題情境中覆寫預設 token 值。

背景色彩的系統 token 依主題情境指向不同值的示意圖
同一個背景色彩系統 token,可依情境(淺色或深色主題)指向不同的參照 token
Pager
上一頁XR 元件:工具列
下一頁設計 token:如何使用 token

以 Apache 2.0 授權條款 或 CC BY 4.0 發布。

版權所有 © 2018-Present Google

https://m3.material.io/foundations/design-tokens/overview

以 Apache 2.0 授權條款 或 CC BY 4.0 發布。

版權所有 © 2018-Present Google