跳至主要内容

Figma 设计套件

使用相同的设计令牌进行设计 您的应用运行于

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

组件
每个 DWC 组件及其主题、范围和状态
令牌
色板、排版、间距和阴影,均作为 Figma 变量和样式
模式
浅色和深色模式(webforJ 26 及更高版本中的应用渲染效果)

变量

套件中的值 这些值在代码中吗?

该套件将 DWC 令牌作为 Figma 变量保存。在应用中,它们是 CSS 自定义属性。以下内容均取自此页面所用的 --dwc-* 变量,并显示浏览器解析出的值。将网站切换为深色模式后,它们也会随之变化,就像套件的深色模式一样。

颜色

--dwc-color-{palette}-{step}

七种色板,每种包含 19 个色阶,均由一个种子色生成。第 5 阶始终最暗,第 95 阶最亮。选择一个色块进行查看。

Aa
令牌
--dwc-color-primary-50
已解析值
上面的文字
--dwc-color-on-primary-text-50
primary您的品牌颜色
default中性色,带有主色调
success状态
warning状态
danger状态
info次要强调
gray纯灰色,无色调

排版

--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指派司机
  • Agthin
  • Aglighter
  • Aglight
  • Agnormal
  • Agmedium
  • Agsemibold
  • Agbold
  • Agbolder
  • Agblack

间距与尺寸

--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
  • 3xs
  • 2xs
  • xs
  • s
  • m
  • l
  • xl
  • 2xl
  • 3xl

半径

--dwc-border-radius-{size}

每个级别都基于同一个种子值缩放:--dwc-border-radius-seed。更改种子值,整个圆角系统都会随之变化。

  • 2xs
  • xs
  • s
  • m
  • l
  • xl
  • 2xl
  • 3xl
  • 4xl

阴影与表面

--dwc-shadow-{size} --dwc-surface-{level}

阴影显示哪些内容位于上层。三个表面层级构建从页面到对话框的层次结构,并均适配浅色和深色模式。

  • xs
  • s
  • m
  • l
  • xl
  • 2xl
--dwc-surface-1页面和主体背景
--dwc-surface-2工具栏、菜单栏、卡片
--dwc-surface-3窗口、菜单、弹出层、对话框

从工具包到应用

使用该套件设计, 由 webforJ 组件构建

本页顶部的界面使用该工具包设计。使用该工具包设计的界面会采用应用实际渲染的组件和设计令牌,因此从设计稿到 Java 代码无需将一种视觉语言转换为另一种。

逐步浏览展示内容

设计师和开发者

一次交接, 已映射一次

Tokens 是设计与代码之间的契约。设计师从套件中交付品牌色和字号比例。开发者只需将它们映射到 seed 和字号 token,之后每个界面都会继承这些设置。

  1. 在 Figma 中品牌色在代码中--dwc-color-primary-seed调色板的全部 19 个色阶均由此生成。
  2. 在 Figma 中字号比例在代码中--dwc-font-size-{size}尺寸单位为 rem,m 为默认值。
  3. 在 Figma 中间距节奏在代码中--dwc-space-{size}组件间距(单位:rem)
  4. 在 Figma 中浅色和深色在代码中@AppTheme("system")遵循操作系统偏好设置。

在套件中

  • webforJ 26 及更高版本中每个 DWC 组件的外观,包括其主题、尺寸和状态。
  • 以 Figma 变量和样式提供的配色、字体、间距和阴影设计令牌。
  • 组件和令牌的浅色与深色模式
  • 精准的间距与无障碍色彩对比,让界面组件行为更可预测。

在应用中

只需设置一次品牌种子色。按钮、链接和焦点环都会沿用它,因为它们使用主色板。

brand.css
:root {
--dwc-color-primary-seed: #2563eb;
}

html[data-app-theme="dark"] {
--dwc-color-primary-seed: #a855f7;
}

注册浅色和深色主题,并让 webforJ 跟随用户的操作系统设置。

MyApp.java
@AppTheme("system")
@AppLightTheme("light")
@AppDarkTheme("dark")
class MyApp extends App {
// app code
}

使用 AI 构建

来自 Figma 画板 前往 Java 界面

将 Figma 和 webforJ 的两个 MCP 服务器连接到你的编程助手:一个读取设计,另一个了解框架,助手在两者之间协作。

  1. 01Figma MCP server

    读取设计

    它会将你指定的画板交给助手,包括布局、组件和变量。素材库中的变量沿用 DWC 令牌名称,让设计与代码语言相通。

    var(--dwc-space-s)
  2. 02webforJ MCP server

    对照 webforJ 检查

    它会基于真实框架回答:该使用哪个组件、可自定义哪些样式,以及 CSS 中的每个令牌是否都存在。

    styles_validate_tokens
  3. 03您的助手

    使用 Java 编写界面

    连接两者后,它会使用 webforJ 组件和设计师使用的相同设计令牌构建视图,您可以对照设计稿检查结果。

    OrdersView.java
起始提示词

使用 webforJ MCP 服务器读取 Figma 框架,选择组件,并在完成前验证每个 --dwc-* 令牌。

获取工具包

开始下一屏 在 Figma 中

DWC Design Kit 已上线 Figma Community。webforJ 是面向企业级 Web 应用的全栈 Java 框架:整个应用,包括界面,都可以用 Java 构建。

  1. 1
    打开套件在 Figma Community 中查找 DWC Design Kit。
  2. 2
    设计界面使用其组件和变量,并检查浅色和深色模式下的每个屏幕。
  3. 3
    使用 Java 构建它们 在 webforJ 中使用相同的组件,并用一个种子设置品牌。