Croprix design tokens
品牌视觉系统的设计 token:色彩、字体、间距、圆角、阴影、网格、断点、动效、层级。每个平台一份产物,值完全一致;改动只在源头进行,各平台产物随版本一起更新。
产物
| 文件 | 平台 |
|---|---|
dist/tokens.css |
Web::root 变量(亮色)+ [data-theme="dark"] + prefers-color-scheme 暗色 + 基础规则 |
dist/tokens.scss |
SCSS:$cx-* 变量与 $cx-colors / $cx-colors-dark map |
dist/tailwind.css |
Tailwind v4 @theme |
dist/tokens.figma.json |
Figma Tokens Studio(global / light / dark 三个 set) |
dist/Tokens.swift |
iOS / macOS(SwiftUI) |
dist/tokens.xml · dist/tokens-night.xml |
Android values / values-night |
dist/contrast-report.html |
WCAG 对比度核验结果 |
命名规则
CSS:--cx-<组>-<名>[-<阶>],camelCase 转 kebab;font.lineHeight.* → --cx-line-height-*,font.letterSpacing.* → --cx-letter-spacing-*(其余 font.* 保留 font- 前缀)。
| Token 路径 | CSS | SCSS | Tailwind v4 | Swift | Android |
|---|---|---|---|---|---|
color.navy.900 |
--cx-color-navy-900 |
$cx-color-navy-900 |
--color-navy-900 → bg-navy-900 |
CXColor.navy900 |
@color/cx_navy_900 |
color.bg.DEFAULT |
--cx-color-bg |
$cx-color-bg |
--color-bg → bg-bg |
CXColor.bg |
@color/cx_bg |
color.fg.muted |
--cx-color-fg-muted |
$cx-color-fg-muted |
--color-fg-muted |
CXColor.fgMuted |
@color/cx_fg_muted |
color.chart.1 |
--cx-color-chart-1 |
$cx-color-chart-1 |
--color-chart-1 |
CXColor.chart1 |
@color/cx_chart_1 |
font.family.cjk |
--cx-font-family-cjk |
$cx-font-family-cjk |
--font-cjk → font-cjk |
CXFont.familyCjk |
@string/cx_font_family_cjk |
font.size.md |
--cx-font-size-md |
$cx-font-size-md |
--text-md → text-md |
CXFont.sizeMd |
@dimen/cx_font_size_md |
font.lineHeight.cjk.md |
--cx-line-height-cjk-md |
$cx-line-height-cjk-md |
--leading-cjk-md |
CXFont.lineHeightCjkMd |
@dimen/cx_line_height_cjk_md |
font.letterSpacing.caps |
--cx-letter-spacing-caps |
$cx-letter-spacing-caps |
--tracking-caps |
CXFont.letterSpacingCaps |
@dimen/cx_letter_spacing_caps |
space.4 |
--cx-space-4 |
$cx-space-4 |
--spacing-4 → p-4 |
CXSpace.s4 |
@dimen/cx_space_4 |
radius.md |
--cx-radius-md |
$cx-radius-md |
--radius-md → rounded-md |
CXRadius.md |
@dimen/cx_radius_md |
shadow.md |
--cx-shadow-md |
$cx-shadow-md |
--shadow-md → shadow-md |
— | — |
motion.ease.standard |
--cx-motion-ease-standard |
$cx-motion-ease-standard |
--ease-standard |
— | @string/cx_motion_ease_standard |
单位
space.*、font.size.*:rem(1rem = 16px),跟随用户字号缩放。--cx-space-4 = 1rem。Figma / iOS / Android 产物按像素输出(16px / 16 / 16dp、字号 16sp)。radius.*、border.width.*、breakpoint.*、container.*:px(不应随字号缩放)。radius.icon = 22%是边长百分比(头像 / App 图标底);Swift 里是CXRadius.iconFraction = 0.22,Android 不输出。- 样式表(CSS / SCSS / Tailwind)里的 hex 小写;Figma、Swift 注释、Android 保持大写。
- 阴影颜色写
oklch(0.26 0.065 245 / α)(= navy.950),Figma 输出转成rgba()。 font.lineHeight.*:无单位倍数。font.weight.*:数字。motion.duration.*:ms。
接入
Web
/* 全局样式表第一行;路径按项目里存放 tokens.css 的位置调整 */
@import "tokens/dist/tokens.css";
tokens.css 已含基础规则:html { font-family: var(--cx-font-family-sans); font-variant-numeric: tabular-nums },:lang(zh|ja|ko|ar|fa|hi|th) 按文字系统切换字体族(包在 :where() 里,特异性为 0,组件与元素规则总能覆盖它),code/kbd/pre/samp 在任何语言下都用等宽,prefers-reduced-motion 时所有 --cx-motion-duration-* 归零。暗色两条路径:<html data-theme="dark"> 显式切换;无 data-theme 时跟随系统 prefers-color-scheme: dark;data-theme="light" 强制亮色。字体文件(@font-face)不在此,由字体包的 fonts.css 负责。
CJK 行高与字重不在基础规则里自动切换(会覆盖组件级行高):组件在 :lang(zh) 下自行取 --cx-line-height-cjk-*,标题字重取 500/600。
Tailwind v4
@import "tailwindcss";
@import "tokens/dist/tailwind.css";
tailwind.css 内部 @import "./tokens.css",所以不必再单独引 tokens.css。原始色在 @theme(静态 hex),语义色在 @theme inline 里指向 var(--cx-color-*),因此 bg-bg text-fg border-border 会随主题切换。字号 text-md 自带行高(--text-md--line-height)。--spacing-* 只声明品牌间距的 14 档,但 Tailwind v4 默认的 --spacing: 0.25rem 乘数与 4px 基准一致,其它数字仍可用。Tailwind 命名与 --cx-* 不同:--color-*、--font-*、--text-*、--font-weight-*、--leading-*、--tracking-*、--spacing-*、--radius-*、--shadow-*、--breakpoint-*、--container-*、--ease-*。
SCSS
@use "tokens/dist/tokens" as cx;
color: cx.$cx-color-fg;
background: map-get(cx.$cx-colors, "navy-900");
SCSS 只有亮色字面量;暗色语义值在 $cx-colors-dark map 里,主题切换请用 CSS 变量而不是 SCSS。
Figma(Tokens Studio)
Tokens Studio 插件 → Tools → Load from file / JSON → 选 dist/tokens.figma.json。三个 set:global(原始色、字体、间距等)、light、dark(语义色与阴影,值为对 global 的引用);$themes 已定义 Light / Dark 两个主题(global 为 source,light/dark 分别 enabled)。导出 Figma Variables 时会得到 color/bg/DEFAULT、color/bg/raised 这样的路径。字号 px、行高 %、字距 %、间距 px、阴影 dropShadow。
iOS / macOS
把 dist/Tokens.swift 加进 target:
Text("Croprix").foregroundStyle(CXColor.fg).font(CXFont.sans(CXFont.sizeMd, weight: CXFont.weightSemibold))
.padding(CXSpace.s4).background(CXColor.bgRaised, in: RoundedRectangle(cornerRadius: CXRadius.md))
语义色用文件末尾的 Color(light:dark:) 扩展,跟随系统外观(UIKit 走 UIColor(dynamicProvider:),AppKit 走 NSColor(name:dynamicProvider:))。字体名 CXFont.familySans = "Montserrat" 要求 App 已打包该字体。
Android
dist/tokens.xml → res/values/tokens.xml;dist/tokens-night.xml → res/values-night/tokens.xml(values-night 里文件名随意,同名覆盖即可)。语义色是 @color/ 引用,夜间自动切换。间距 dp、字号 sp、行高 / 字距为 float dimen、字重 / z / 时长为 integer、字体栈与缓动为 string。
对比度核验
对比度核验报告随每个 token 版本一起生成。门槛:正文角色 ≥ 4.5:1,大字 / 图形 / 装饰角色 ≥ 3:1。核验矩阵:fg、fg.muted、brand、link、success、warning、danger、info 各对 bg / bg.raised / bg.sunken(正文 4.5);fg.subtle 同三底(装饰 3.0);accent.fg 对 accent 与 accent.hover(4.5);white 对 accent(大字 3.0,仅亮色);fg.inverse 对 bg.inverse(4.5);chart.1–6 对 bg(图形 3.0);亮暗两套。另有两组“参考组合”只记录比值、不参与通过判定:accent 对 bg(填充块)、border.strong 对 bg(输入框描边),亮暗各一。
语义映射(fg.subtle=sand.600、success=leaf.800、warning=harvest.700、danger=crimson.700、chart.2/3/4/6 各深一阶)是按上述门槛核验后定稿的值,与品牌手册第 3 章的色彩表一致。