Croprix 品牌手册规范文件

品牌手册 · 下载 · Tokens 接入说明

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

单位

接入

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 章的色彩表一致。