Ordo UI
Foundations

概览

Ordo UI 的基础 token:颜色、排印、间距、圆角、动效、层级与阴影

Foundations 是组件外观的底层契约。所有 token 的唯一真相源是:

packages/ui/src/styles/theme.css

颜色预设数据在 packages/ui/src/theme/base-colors.json,由 scripts/gen-base-colors.mjs 生成,再由 scripts/gen-themes.mjs 生成 styles/themes/*.css。

十个基础面

页面内容
Color语义色、baseColor 预设、tone、图表色
Typography字阶、字重、字体族、中文下限
Spacing4px 网格、语义间距、弹窗尺寸
Densitycompact / comfortable / spacious 与控件高度
Radius单根 --radius 与派生公式
Motionduration / ease / reduced-motion
Contrastnormal / high 与 WCAG 验收
Accessibility高对比度、forced-colors、en-XA 伪语言
Z-index七档层级
Elevation阴影政策与 shadow-xs

使用原则

  • 组件只消费语义 token,不写原生色板类、任意色、任意阴影。
  • 主题定制优先走 ThemeConfig,不要在业务页面复制 token。
  • 新增 token 必须同时满足:有消费方、有文档、有护栏可校验。