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 | 字阶、字重、字体族、中文下限 |
| Spacing | 4px 网格、语义间距、弹窗尺寸 |
| Density | compact / comfortable / spacious 与控件高度 |
| Radius | 单根 --radius 与派生公式 |
| Motion | duration / ease / reduced-motion |
| Contrast | normal / high 与 WCAG 验收 |
| Accessibility | 高对比度、forced-colors、en-XA 伪语言 |
| Z-index | 七档层级 |
| Elevation | 阴影政策与 shadow-xs |
使用原则
- 组件只消费语义 token,不写原生色板类、任意色、任意阴影。
- 主题定制优先走
ThemeConfig,不要在业务页面复制 token。 - 新增 token 必须同时满足:有消费方、有文档、有护栏可校验。