Design-Tokens - Jim的独立博客

1338 字

7 分钟

Design-Tokens

2024-05-27

前端

/

设计

什么是 Design Tokens ？#

Design Tokens 是指在设计系统中使用的可重复使用的属性和值。它们通常用于定义颜色、字体、间距、边框等设计元素的属性和值。

Design Tokens 提供了一种在设计系统中组织和管理样式的方法。它们可以通过集中的样式文件或使用专门的 Design Token 工具来进行管理。使用 Design Tokens 可以提高样式的可维护性和可扩展性，使设计系统的样式更加一致，并且可以方便地进行主题切换。

举个例子，对于颜色，可以使用 Design Tokens 来定义各种颜色的属性和值，如主色、文字颜色、背景色等。当需要修改某个颜色时，只需要修改 Design Tokens 中的对应属性和值，就可以自动应用到整个系统的样式中，避免了逐个修改样式的麻烦。

Design Tokens 的优势在于它们的可重复使用性和一致性，帮助设计师和开发人员更好地协作，提高工作效率，并且可以轻松地进行样式的扩展和调整。

在编写样式代码时，项目存在的可优化的空间#

公司内不少的前端项目使用开源或自研的组件库进行二次开发。在对于样式的管理上，其实已经抽象出如间距、字体大小、颜色、动画等的一些常量值，但这些抽象出来的常量值的管理通常如下原因导致往往难以达到理想的效果：

UI 设计师的 UI 迭代未考虑当前版本或上一版本 UI 定下的设计规范来进行设计；
UI 设计师使用的 UI 协作设计工具（比如 Figma、蓝湖、MasterGo）及相关插件有过变更，存在隐性的信息丢失情况及增加前端开发的学习成本等问题；
部分前端开发工程师出于如下若干原因，在新开发的功能模块内，未使用抽象出来的样式常量：
1. 文档缺失
2. 部门内信息沟通不畅
3. 无代码评审机制
4. 需要自己在脑海里将基于 UI 协作设计工具自动生成的样式代码，转换为项目里抽象后的常量值

一个理想的应用 Design Tokens 的工作流及注意事项#

UI 设计师#

先进行梯度的色版、间距、文字大小的设计，给出其定义的具体的基础常量值及其命名
使用语义化的方式（就是前端开发工程师容易识别出是在哪个组件或者说是在哪种场景下使用）重新定义这些常量值（就是 Design Tokens 了），再在这些常量值的基础上设计出各类基础组件及复合组件
在事先协商好的 UI 协作设计工具上使用自有功能或第三方插件将基础常量值及 Design Tokens 的清单（可以是 css、json 等文件，取决于前端开发工程师所需的文件格式）进行导出，并发送给前端开发工程师
如需进行设计上的变动，需要进行相关的基础常量值及 Design Tokens 的变更，再重新导出一份清单发送给前端开发工程师
UI 协作设计工具的自动生成的样式代码，需基于定义的 Design Tokens ，便于前端开发工程师进行复制粘贴

前端开发工程师#

在项目中全局引用这份清单文件
在开发的过程中，可以使用 UI 协作设计工具的自动生成的样式代码
如需进行设计上的变动，换一份 UI 设计师设计并导出的新的清单文件即可

例子#

梯度色版清单#

1
--Colorpalette-Blue-blue-50: #EBF6FE;
2
--Colorpalette-Blue-blue-100: #C2E2FC;
3
--Colorpalette-Blue-blue-200: #A4D4FA;
4
--Colorpalette-Blue-blue-300: #7BC0F8;
5
--Colorpalette-Blue-blue-400: #61B4F6;
6
--Colorpalette-Blue-blue-500: #39A1F4;
7
--Colorpalette-Blue-blue-600: #3593DE;
8
--Colorpalette-Blue-blue-700: #2A71AD;
9
--Colorpalette-Blue-blue-800: #215986;
10
--Colorpalette-Blue-blue-900: #184466;
11
--Colorpalette-Brand-brand-50: #EBF4FE;
12
--Colorpalette-Brand-brand-100: #C0DCFC;
13
--Colorpalette-Brand-brand-200: #A1CBFB;
14
--Colorpalette-Brand-brand-300: #76B3F9;
15
--Colorpalette-Brand-brand-400: #5BA5F8;
16
--Colorpalette-Brand-brand-500: #328EF6;
17
--Colorpalette-Brand-brand-600: #2E81E0;
18
--Colorpalette-Brand-brand-700: #2465AF;
19
--Colorpalette-Brand-brand-800: #1D4E87;
20
--Colorpalette-Brand-brand-900: #153C67;
21
--Colorpalette-Green-green-50: #E6F8ED;
22
--Colorpalette-Green-green-100: #B0E9C7;
23
--Colorpalette-Green-green-200: #8ADEAB;
24
--Colorpalette-Green-green-300: #54CF85;
25
--Colorpalette-Green-green-400: #33C66D;
26
--Colorpalette-Green-green-500: #02B849;
27
--Colorpalette-Green-green-600: #01A741;
28
--Colorpalette-Green-green-700: #008334;
29
--Colorpalette-Green-green-800: #006528;
30
--Colorpalette-Green-green-900: #024D1F;
31
--Colorpalette-Grey-grey-50: #FAFAFA;
32
--Colorpalette-Grey-grey-100: #F0EFEF;
33
--Colorpalette-Grey-grey-200: #E7E8E8;
34
--Colorpalette-Grey-grey-300: #DCDDDE;
35
--Colorpalette-Grey-grey-400: #D5D6D7;
36
--Colorpalette-Grey-grey-500: #CBCCCD;
37
--Colorpalette-Grey-grey-600: #B9BABB;
38
--Colorpalette-Grey-grey-700: #909192;
39
--Colorpalette-Grey-grey-800: #707071;
40
--Colorpalette-Grey-grey-900: #555656;
41
--Colorpalette-Red-red-50: #FFECEC;
42
--Colorpalette-Red-red-100: #FFC4C5;
43
--Colorpalette-Red-red-200: #FFA9A9;
44
--Colorpalette-Red-red-300: #FF8282;
45
--Colorpalette-Red-red-400: #FF6969;
46
--Colorpalette-Red-red-500: #FF4344;
47
--Colorpalette-Red-red-600: #E83E3F;
48
--Colorpalette-Red-red-700: #B53130;
49
--Colorpalette-Red-red-800: #8C2425;
50
--Colorpalette-Red-red-900: #6B1D1D;
51
--Colorpalette-Yellow-yellow-50: #FFF8E9;
52
--Colorpalette-Yellow-yellow-100: #FEE9BB;
53
--Colorpalette-Yellow-yellow-200: #FEDE9B;
54
--Colorpalette-Yellow-yellow-300: #FDCF6C;
55
--Colorpalette-Yellow-yellow-400: #FDC651;
56
--Colorpalette-Yellow-yellow-500: #FCB825;
57
--Colorpalette-Yellow-yellow-600: #E5A722;
58
--Colorpalette-Yellow-yellow-700: #B3831B;
59
--Colorpalette-Yellow-yellow-800: #8B6515;
60
--Colorpalette-Yellow-yellow-900: #6A4E10;
61
--Colorpalette-black: #000000;
62
--Colorpalette-font-font-50: #E9E9E9;
63
--Colorpalette-font-font-100: #BABABB;
64
--Colorpalette-font-font-200: #98999A;
65
--Colorpalette-font-font-300: #6A6A6C;
66
--Colorpalette-font-font-400: #4D4E50;
67
--Colorpalette-font-font-500: #202123;
68
--Colorpalette-white: #FFFFFF;

Design Tokens 清单#

1
--Designtoken-background-color-bg-1: var(--Colorpalette-white);
2
--Designtoken-background-color-bg-2: var(--Colorpalette-Grey-grey-50);
3
--Designtoken-background-color-bg-3: var(--Colorpalette-Grey-grey-100);
4
--Designtoken-background-color-bg-4: var(--Colorpalette-Brand-brand-500);
5
--Designtoken-background-color-bg-disable: var(--Colorpalette-Grey-grey-100);
6
--Designtoken-background-color-bg-label-1: var(--Colorpalette-Blue-blue-50);
7
--Designtoken-background-color-bg-scroll: var(--Colorpalette-Grey-grey-600);
8
--Designtoken-background-color-erro: var(--Colorpalette-Red-red-500);
9
--Designtoken-background-color-info: var(--Colorpalette-Blue-blue-500);
10
--Designtoken-background-color-sucess-label: var(--Colorpalette-Green-green-50);
11
--Designtoken-background-color-sucess: var(--Colorpalette-Green-green-500);
12
--Designtoken-background-color-warning: var(--Colorpalette-Yellow-yellow-500);
13
--Designtoken-button-color-button-bg-primary-default: var(--Colorpalette-Brand-brand-500);
14
--Designtoken-button-color-button-bg-primary-disable: var(--Colorpalette-Brand-brand-200);
15
--Designtoken-button-color-button-bg-primary-hover: var(--Colorpalette-Brand-brand-400);
16
--Designtoken-button-color-button-bg-primary-selected: var(--Colorpalette-Brand-brand-600);
17
--Designtoken-button-color-dangerbutton-default: var(--Colorpalette-Red-red-500);
18
--Designtoken-button-color-dangerbutton-hover: var(--Colorpalette-Red-red-400);
19
--Designtoken-button-color-dangerbutton-selected: var(--Colorpalette-Red-red-600);
20
--Designtoken-button-color-datebutton-bg-selected: var(--Colorpalette-Brand-brand-50);
21
--Designtoken-button-color-linebutton-bg-disable: var(--Colorpalette-Grey-grey-50);
22
--Designtoken-button-color-linebutton-default: var(--Colorpalette-Grey-grey-400);
23
--Designtoken-button-color-linebutton-hover: var(--Colorpalette-Brand-brand-400);
24
--Designtoken-button-color-linebutton-selected: var(--Colorpalette-Brand-brand-600);
25
--Designtoken-button-color-textbutton-bg-hover: var(--Colorpalette-Grey-grey-50);
26
--Designtoken-button-color-textbutton-bg-selected: var(--Colorpalette-Grey-grey-100);
27
--Designtoken-icon-color-icon-1: var(--Colorpalette-Brand-brand-500);
28
--Designtoken-icon-color-icon-2: var(--Colorpalette-font-font-400);
29
--Designtoken-icon-color-icon-3: var(--Colorpalette-Grey-grey-700);
30
--Designtoken-icon-color-icon-4: var(--Colorpalette-white);
31
--Designtoken-icon-color-icon-disable: var(--Colorpalette-Grey-grey-300);
32
--Designtoken-line-color-alert-info: var(--Colorpalette-Brand-brand-300);
33
--Designtoken-line-color-alert-success: var(--Colorpalette-Green-green-300);
34
--Designtoken-line-color-erro: var(--Colorpalette-Red-red-500);
35
--Designtoken-line-color-input-line-default: var(--Colorpalette-Grey-grey-400);
36
--Designtoken-line-color-input-line-hover: var(--Colorpalette-Brand-brand-500);
37
--Designtoken-line-color-line-1: var(--Colorpalette-Grey-grey-100);
38
--Designtoken-line-color-line-dividing-1: var(--Colorpalette-Grey-grey-50);
39
--Designtoken-line-color-line-dividing-2: var(--Colorpalette-Grey-grey-100);
40
--Designtoken-line-color-success: var(--Colorpalette-Green-green-500);
41
--Designtoken-text-color-text-1: var(--Colorpalette-font-font-500);
42
--Designtoken-text-color-text-2: var(--Colorpalette-font-font-400);
43
--Designtoken-text-color-text-3: var(--Colorpalette-font-font-300);
44
--Designtoken-text-color-text-4: var(--Colorpalette-font-font-200);
45
--Designtoken-text-color-text-5: var(--Colorpalette-font-font-100);
46
--Designtoken-text-color-text-6: var(--Colorpalette-Brand-brand-500);
47
--Designtoken-text-color-text-7: var(--Colorpalette-white);
48
--Designtoken-text-color-text-err: var(--Colorpalette-Red-red-500)