Figma 设计套件
使用相同的设计令牌进行设计 您的应用运行于
DWC 设计套件是用于设计 webforJ 应用的官方 Figma 资源,帮助设计师和开发者使用相同的设计令牌和组件。

1 / 21Freight Dispatch调度看板
- 组件
- 每个 DWC 组件及其主题、范围和状态
- 令牌
- 色板、排版、间距和阴影,均作为 Figma 变量 和样式
- 模式
- 浅色和深色模式(webforJ 26 及更高版本中的应用渲染效果)
变量
套件中的值 这些值在代码中吗?
该套件将 DWC 令牌作为 Figma 变量保存。在应用中,它们是 CSS 自定义属性。以下内容均取自此页面所用的 --dwc-* 变量,并显示浏览器解析出的值。将网站切换为深色模式后,它们也会随之变化,就像套件的深色模式一样。
集合
颜色
--dwc-color-{palette}-{step}七种色板,每种包含 19 个色阶,均由一个种子色生成。第 5 阶始终最暗,第 95 阶最亮。选择一个色块进行查看。
- 令牌
--dwc-color-primary-50- 已解析值
- 上面的文字
--dwc-color-on-primary-text-50
排版
--dwc-font-size-{size}以 rem 为单位的尺寸比例,其中 m 是大多数组件使用的标准尺寸;字重从纤细到特黑。
--dwc-font-size-3xs指派司机--dwc-font-size-2xs指派司机--dwc-font-size-xs指派司机--dwc-font-size-s指派司机--dwc-font-size-m指派司机--dwc-font-size-l指派司机--dwc-font-size-xl指派司机--dwc-font-size-2xl指派司机--dwc-font-size-3xl指派司机
- Ag
thin - Ag
lighter - Ag
light - Ag
normal - Ag
medium - Ag
semibold - Ag
bold - Ag
bolder - Ag
black
间距与尺寸
--dwc-space-{size} --dwc-size-{size}间距用于设置组件之间的距离。尺寸用于设置组件的宽度和高度,m 是几乎所有组件的标准尺寸。间距条按其尺寸的四倍绘制。
--dwc-space-3xs--dwc-space-2xs--dwc-space-xs--dwc-space-s--dwc-space-m--dwc-space-l--dwc-space-xl--dwc-space-2xl--dwc-space-3xl
3xs2xsxssmlxl2xl3xl
半径
--dwc-border-radius-{size}每个级别都基于同一个种子值缩放:--dwc-border-radius-seed。更改种子值,整个圆角系统都会随之变化。
2xsxssmlxl2xl3xl4xl
阴影与表面
--dwc-shadow-{size} --dwc-surface-{level}阴影显示哪些内容位于上层。三个表面层级构建从页面到对话框的层次结构,并均适配浅色和深色模式。
xssmlxl2xl
--dwc-surface-1页面和主体背景--dwc-surface-2工具栏、菜单栏、卡片--dwc-surface-3窗口、菜单、弹出层、对话框从工具包到应用
使用该套件设计, 由 webforJ 组件构建
本页顶部的界面使用该工具包设计。使用该工具包设计的界面会采用应用实际渲染的组件和设计令牌,因此从设计稿到 Java 代码无需将一种视觉语言转换为另一种。
逐步浏览展示内容设计师和开发者
一次交接, 已映射一次
Tokens 是设计与代码之间的契约。设计师从套件中交付品牌色和字号比例。开发者只需将它们映射到 seed 和字号 token,之后每个界面都会继承这些设置。
- 在 Figma 中品牌色在代码中
--dwc-color-primary-seed调色板的全部 19 个色阶均由此生成。 - 在 Figma 中字号比例在代码中
--dwc-font-size-{size}尺寸单位为 rem,m 为默认值。 - 在 Figma 中间距节奏在代码中
--dwc-space-{size}组件间距(单位:rem) - 在 Figma 中浅色和深色在代码中
@AppTheme("system")遵循操作系统偏好设置。
在套件中
- webforJ 26 及更高版本中每个 DWC 组件的外观,包括其主题、尺寸和状态。
- 以 Figma 变量和样式提供的配色、字体、间距和阴影设计令牌。
- 组件和令牌的浅色与深色模式
- 精准的间距与 无障碍色彩对比,让界面组件行为更可预测。
在应用中
只需设置一次品牌种子色。按钮、链接和焦点环都会沿用它,因为它们使用主色板。
:root {
--dwc-color-primary-seed: #2563eb;
}
html[data-app-theme="dark"] {
--dwc-color-primary-seed: #a855f7;
}
注册浅色和深色主题,并让 webforJ 跟随用户的操作系统设置。
@AppTheme("system")
@AppLightTheme("light")
@AppDarkTheme("dark")
class MyApp extends App {
// app code
}
使用 AI 构建
来自 Figma 画板 前往 Java 界面
将 Figma 和 webforJ 的两个 MCP 服务器连接到你的编程助手:一个读取设计,另一个了解框架,助手在两者之间协作。
- 01Figma MCP server
读取设计
它会将你指定的画板交给助手,包括布局、组件和变量。素材库中的变量沿用 DWC 令牌名称,让设计与代码语言相通。
var(--dwc-space-s) - 02webforJ MCP server
对照 webforJ 检查
它会基于真实框架回答:该使用哪个组件、可自定义哪些样式,以及 CSS 中的每个令牌是否都存在。
styles_validate_tokens - 03您的助手
使用 Java 编写界面
连接两者后,它会使用 webforJ 组件和设计师使用的相同设计令牌构建视图,您可以对照设计稿检查结果。
OrdersView.java
使用 webforJ MCP 服务器读取 Figma 框架,选择组件,并在完成前验证每个 --dwc-* 令牌。
获取工具包
开始下一屏 在 Figma 中
DWC Design Kit 已上线 Figma Community。webforJ 是面向企业级 Web 应用的全栈 Java 框架:整个应用,包括界面,都可以用 Java 构建。
- 1打开套件在 Figma Community 中查找 DWC Design Kit。
- 2设计界面使用其组件和变量,并检查浅色和深色模式下的 每个屏幕。
- 3使用 Java 构建它们 在 webforJ 中使用相同的组件,并用一个种子设置品牌。