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 组件:工具栏

设计令牌:概述

设计令牌:如何使用令牌

交互

手势

输入:基础

选择:概述

状态:概览

状态:状态层

状态:应用状态

布局

布局概览:概述

布局概览:布局的组成部分

布局概览:自适应设计

Scaffold:概览

Scaffold:栏

Scaffold: 轨道

Scaffold:窗格

网格与间距:概述

网格与间距:网格

网格与间距:间距

网格与间距:密度

断点:概览

断点:紧凑

断点:中等

断点:扩展型

断点:大尺寸与超大尺寸

双向性与 RTL

规范布局示例:概览

规范布局示例:信息流

规范布局示例:列表-详情

规范布局示例:辅助窗格

可用性:概览

可用性:应用 M3 表现力设计

Material 术语 A-Z

样式

颜色

色彩系统:概览

色彩系统:工作原理

颜色角色

配色方案

选择配色方案

静态配色方案:Baseline

静态配色方案:自定义品牌

动态配色方案:选择来源

动态配色方案:用户生成源色

动态配色方案:基于内容的取色源

高级自定义:概览

高级自定义:应用颜色

高级自定义:定义新颜色

高级自定义:调整现有颜色

颜色资源

海拔:概览

海拔:应用海拔

海拔:令牌

图标:概览

图标:设计图标

图标:图标的运用

动效

动效物理系统:工作原理

动效物理系统:规格

缓动和时长:应用缓动与时长

缓动和时长:令牌与规格

过渡:过渡模式

过渡:应用过渡

形状:概览与原则

形状:圆角半径刻度

形状:形状变形

间距:概览

间距:应用间距

间距:令牌

字体排印:概述

字体排印:字体

字体排印:字阶与令牌

字体排印:应用字体样式

字体排印:编辑式处理

组件

应用栏:概览

应用栏:规格

应用栏:指南

应用栏:无障碍

徽标:概览

徽标:规格

徽标:指南

徽标:无障碍

按钮

所有按钮

按钮组:概览

按钮组:规格

按钮组:指南

按钮组:无障碍

按钮:概览

按钮:规格

按钮:指南

按钮:无障碍

扩展 FAB:概览

扩展 FAB:规格

扩展 FAB:指南

扩展浮动操作按钮:无障碍

FAB 菜单:概述

FAB 菜单:规格

FAB 菜单:指南

FAB 菜单:无障碍

浮动操作按钮(FABs):概览

浮动操作按钮(FAB):规格

浮动操作按钮 (FAB):指南

浮动操作按钮 (FAB):无障碍

图标按钮:概述

图标按钮:规格

图标按钮:指南

图标按钮:无障碍

分段按钮:概览

分段按钮:规格

分段按钮:指南

分段按钮:无障碍

拆分按钮:概览

拆分按钮:规格

拆分按钮:指南

拆分按钮:无障碍

卡片:概览

卡片:规格

卡片:指南

卡片:无障碍

轮播:概览

轮播:规格

轮播:指南

轮播:无障碍

复选框:概览

复选框:规格

复选框:指南

复选框:无障碍

芯片:概览

芯片:规格

芯片:指南

芯片:无障碍

日期和时间选择器

日期选择器:概览

日期选择器:规格

日期选择器:指南

日期选择器:无障碍

时间选择器:概览

时间选择器:规格

时间选择器:指南

时间选择器:无障碍

对话框:概览

对话框:规格

对话框:指南

对话框:无障碍

分隔线:概览

分隔线:规格

分隔线:指南

分隔线:无障碍

列表:概览

列表:规格

列表:指南

列表:无障碍

加载和进度

加载指示器:概览

加载指示器:规格

加载指示器:指南

加载指示器:无障碍

进度指示器:概览

进度指示器:规格

进度指示器:指南

进度指示器:无障碍

菜单:概览

菜单:规格

菜单:指南

菜单:无障碍

导航

导航栏:概述

导航栏:规格

导航栏:指南

导航栏:无障碍

导航抽屉:概览

导航抽屉:规格

导航抽屉:指南

导航抽屉:无障碍

导航轨道:概览

导航轨道:规格

导航轨道:指南

导航轨道:无障碍

单选按钮:概述

单选按钮:规格

单选按钮:指南

单选按钮:无障碍

搜索:概览

搜索:规格

搜索:指南

搜索:无障碍

工作表

底部工作表:概览

底部工作表:规格

底部工作表:指南

底部工作表:无障碍

侧边工作表:概览

侧边工作表:规格

侧边工作表:指南

侧边工作表:无障碍

滑块:概览

滑块:规格

滑块:指南

滑块:无障碍

提示条:概览

提示条:规格

提示条:指南

提示条:无障碍

开关:概览

开关:规格

开关:指南

开关:无障碍

标签页:概览

标签页:规格

标签页:指南

标签页:无障碍

文本框:概览

文本框:规格

文本框:指南

文本框:无障碍

工具栏:概览

工具栏:规格

工具栏:指南

工具栏:无障碍

工具提示:概览

工具提示:规格

工具提示:指南

工具提示:无障碍

页面导航

设计令牌:概述 ​

设计令牌是所有 UI 元素的基础构建单元。同一套令牌贯穿设计、工具和代码。


  • 设计令牌指向样式值,例如颜色、字体和度量值
  • 使用设计令牌代替硬编码值
  • 每个令牌的名称都反映其用途或使用位置(例如,md.comp.fab.primary.container.color 设置 FAB 的容器颜色)
  • 即使令牌的最终值发生变化,其名称和用途也保持不变
  • Material Design 有三类设计令牌:引用令牌、系统令牌 和 组件令牌
设计稿、代码和产品中的 FAB 容器颜色令牌
使用设计令牌而非硬编码值,可以简化借助设计系统构建、维护和扩展产品的工作

资源 ​

类型链接状态
设计Design Kit(Figma)可用
Material Theme Builder Figma 插件可用
实现Material 基线主题与令牌(DSP)可用

什么是设计令牌? ​

设计令牌是构成设计系统视觉风格的小型、可复用设计决策。令牌以含义明确的名称代替静态值。

一个设计令牌由两部分组成:

  1. 类似代码的名称,例如 md.ref.palette.secondary90
  2. 关联值,例如 #E8DEF8

令牌值可以是颜色、字体、度量值,甚至另一个令牌。

令牌 md.ref.palette.secondary90 通过箭头指向淡紫色色块 #E8DEF8。
引用令牌及其颜色值的示例

设计令牌能将原本缺乏明确关联的样式选择以有意义的方式联系起来。

例如,如果设计师的设计稿和工程师的实现都引用同一个表示“次色容器颜色”的令牌,那么他们就能确信设计与实现使用的是同一种颜色。即使分配给该令牌的十六进制值发生更新,这一点依然成立。

显示 FAB 系统令牌的示意图:表面颜色使用 secondary,图标颜色使用 on secondary
为 FAB 容器和图标分别指定 secondary 与 on secondary 颜色角色的令牌示例

为什么设计令牌很重要? ​

设计令牌使设计系统能够拥有单一可信来源——一个记录样式选择并可跟踪变更的仓库。

由于令牌可复用且以用途为导向,它们可以为主题和上下文定义系统级更新。例如,你可以使用令牌系统化地应用高对比度配色方案以提高可视性,或调整字阶以确保文本在电视屏幕上清晰可读。

通过在设计和实现中使用令牌,样式更新会在整个产品或产品系列中一致传播。令牌还帮助设计师和工程师“说同一种语言”,减少从设计移交到实现过程中的误解。

显示更改令牌值如何从设计系统传播到产品层面和三个产品的示意图
随着设计系统发展,某些值会发生变化。借助设计令牌,可以跟踪变更并确保各产品之间的一致性。

判断设计令牌是否适合你 ​

设计令牌在以下情况下最有用:

  • 你计划更新产品设计,或正在从零开始构建产品
  • 你的设计系统应用于一系列产品或平台
  • 你希望日后能轻松维护或更新样式
  • 你希望充分利用 Material Design 系统,包括动态色彩等功能

设计令牌在以下情况下用处较小:

  • 你的现有应用使用硬编码值,且未来一两年内不太可能更改
  • 你的产品没有设计系统

设计令牌与 Material Design ​

过去,Material 样式主要通过指南、设计文件、工具和平台专属组件库来传递。

借助设计令牌,你现在可以下载、自定义和应用 Material 样式,并将其集成到设计和开发流程中。

设计令牌以平台无关、可共享的格式记录设计决策。

设计令牌连接到设计工具和平台代码的示意图
设计令牌为设计选择提供集中式存储,并为工程师和设计师提供多种集成方式

本网站会在交互式模块中列出令牌。

这些模块让你快速查询令牌中存储的颜色、字体、字号、字重等默认基准值。它们还展示角色、对应的系统令牌、引用令牌与存储的预设值之间的关系。

色彩系统的令牌模块,包含主色集的四个色块。
令牌模块的示例

你还会在组件文档的规格标签页中看到令牌。

令牌首先按状态(启用、禁用、悬停等)分组,然后按元素分组。元素是指令牌或值所应用到的组件部位,例如容器或标签文本。

表格包含以下列:

  • 名称——令牌适用的组件样式属性,例如颜色或字体
  • 令牌 ID——定义组件样式属性的令牌
  • 描述——可选的补充说明
  • 上下文/值——令牌在特定上下文中存储的值
凸起按钮的令牌模块,先按状态(启用、禁用等)再按元素(容器、标签文本)组织。
凸起按钮的示意图和令牌模块

如何使用令牌模块

假设你需要验证填充按钮标签文本的颜色角色。

导航到“常见按钮 > 规格”,找到填充按钮的令牌模块,并在“元素”下搜索“标签文本”令牌。

复制颜色令牌并粘贴到代码中,或将其与 Figma 中的颜色角色进行比较。

如何查找标签文本颜色令牌。
填充按钮标签颜色的示意图和令牌表

令牌名称的组成部分 ​

令牌名称的各个部分用点号分隔,并按从最通用信息(“md”)到最具体信息(“on-secondary”)的顺序排列。

  1. 设计系统中的所有令牌名称都以系统名称开头(例如 Material Design 的“md”)
  2. 令牌类别的缩写:“ref”表示引用令牌,“sys”表示系统令牌,“comp”表示组件令牌
  3. 令牌以描述性词语结尾,说明令牌的用途
设计令牌名称的三个组成部分示意图:系统前缀、令牌类型和角色说明
  1. 标识所属设计系统
  2. 标识令牌类别
  3. 说明令牌用途

设计令牌类别 ​

Material 中的设计令牌分为三类:

  1. 引用令牌
    所有可用令牌及其关联值。
  2. 系统令牌
    决定设计系统整体特征的决策与角色,涵盖从颜色和字体体系到海拔与形状。
  3. 组件令牌
    分配给组件中元素的设计属性,例如按钮图标的颜色。

借助三类设计令牌,团队可以全局更新设计决策,也可以将更改应用于单个组件。

颜色值存储在引用令牌中,引用令牌存储在系统令牌中,系统令牌存储在组件令牌中,并作为 FAB 的容器颜色呈现
一个按钮通过由三个令牌组成的系统获得容器颜色,这些令牌定义了可扩展的颜色值。颜色令牌指向特定十六进制值,该值可轻松更改而不影响令牌语法。

引用令牌

这些令牌构成设计系统中所有可用的样式选项。

它们通常指向静态值——例如十六进制颜色代码或字号——但也可以指向其他引用令牌。引用令牌不会因上下文而改变。

引用令牌以选项列表的形式,为团队提供一套经过认可的颜色、字体体系、度量值等,作为设计起点。

所有引用令牌都以 ref 为前缀。

令牌 md.ref.palette.secondary90 指向 #E8DEF8。令牌 md.ref.typeface.plain-medium 指向 Roboto Medium
颜色和字体体系的引用令牌及其值

系统令牌

系统令牌是使设计语言针对特定主题或上下文系统化的决策。

系统令牌定义引用令牌在 UI 中的用途。

主题定制正是在这一层实现的。系统令牌可以根据上下文(例如浅色或深色主题)指向不同的引用令牌。

系统令牌应尽可能指向引用令牌,而不是静态值。

所有系统令牌都以 sys 为前缀。

系统令牌 md.sys.color.secondary-container 指向令牌 md.ref.palette.secondary90,再指向 #E8DEF8。系统令牌 md.sys.typescale.label-medium.font 指向令牌 md.ref.typeface.plain-medium,再指向 Roboto Medium
系统令牌、引用令牌及其值

组件令牌(开发中) ​

组件令牌表示构成组件所需的元素(如容器、标签文本、图标、状态)及其对应的值(如尺寸、形状、颜色或海拔)。

组件令牌应尽可能指向系统令牌或引用令牌,而不包含十六进制代码等硬编码值。

并非组件的每个样式选择都能表达为令牌,但只要某个设计选择适用于多个用途相似的组件,就应将其定义为令牌。

所有组件令牌都以 comp 为前缀。

扩展型 FAB 的组件令牌(用于容器颜色和标签文本)依次指向系统令牌、引用令牌和解析后的值
组件令牌、系统令牌、引用令牌及其值

上下文 ​

设计令牌可以根据一组条件指向不同的值。这些条件称为上下文,其生成的值称为上下文相关值。

不同上下文的示例包括:设备形态、深色主题、紧凑布局和从右到左的书写系统。

你可以将上下文视为一种标签。如果某个令牌值被标记为深色主题,那么在深色主题上下文中,该值将覆盖默认令牌值。

背景颜色的系统令牌根据主题上下文指向不同值的示意图
同一个背景色彩系统令牌可以根据上下文(浅色主题或深色主题)指向不同的引用令牌
Pager
上一页XR 组件:工具栏
下一页设计令牌:如何使用令牌

基于 Apache 2.0 许可证 或 CC BY 4.0 发布。

Copyright © 2018-Present Google

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

基于 Apache 2.0 许可证 或 CC BY 4.0 发布。

Copyright © 2018-Present Google