设计 Tokens
@ruanno-ui/tokens 是全库样式的单一数据源:packages/tokens/src/tokens.json 一处定义,构建生成 CSS 变量(dist/tokens.css 的 :root)、主题覆盖(dist/themes.css 的 [data-rn-theme])与 TS 对象。所有组件只消费 --rn-* 变量,不硬编码颜色 / 间距 / 字号 / 圆角——这也是主题系统与自定义能力的基础。
在业务中使用
css
.card {
padding: var(--rn-spacing-4);
border: 1px solid var(--rn-color-border);
border-radius: var(--rn-radius-md);
box-shadow: var(--rn-shadow-sm);
color: var(--rn-color-text);
background: var(--rn-color-bg);
}TS 侧(断点像素值等):
ts
import { breakpointPx } from "@ruanno-ui/tokens";uni-app 端引入方式:
vue
<style>
@import "@ruanno-ui/uniapp/styles"; /* 内含 tokens 变量与主题 */
</style>颜色(--rn-color-*)
品牌与语义
| 变量 | 默认值 | 说明 |
|---|---|---|
--rn-color-primary | #3b6ef6 | 品牌主色 |
--rn-color-primary-hover | #5c85f8 | 主色悬停态 |
--rn-color-primary-active | #2f5ad6 | 主色按下态 |
--rn-color-primary-soft | #e8effe | 主色浅底(选中背景、浅色 Tag) |
--rn-color-success | #22a06b | 成功 |
--rn-color-success-soft | #e6f6ef | 成功浅底 |
--rn-color-warning | #e2a03f | 警告 |
--rn-color-warning-soft | #fbf0dd | 警告浅底 |
--rn-color-danger | #e5484d | 危险 / 错误 |
--rn-color-danger-hover | #ec5f63 | 危险悬停态 |
--rn-color-danger-soft | #fdecec | 危险浅底 |
--rn-color-info | #6b7a90 | 信息 |
--rn-color-info-soft | #eceff3 | 信息浅底 |
文本 / 背景 / 边框
| 变量 | 默认值 | 说明 |
|---|---|---|
--rn-color-text | #1f2430 | 主文本 |
--rn-color-text-secondary | #5a6474 | 次要文本 |
--rn-color-text-placeholder | #9aa3b2 | 占位 / 禁用文本 |
--rn-color-text-inverse | #ffffff | 深色底上的文本 |
--rn-color-bg | #ffffff | 页面 / 卡片背景 |
--rn-color-bg-soft | #f5f6f8 | 次级背景(表头、输入框禁用底) |
--rn-color-bg-mask | rgba(15,20,30,.5) | 弹层遮罩 |
--rn-color-border | #dde1e8 | 常规边框 / 分割线 |
--rn-color-border-strong | #c3c9d4 | 强调边框 |
图表色板
--rn-color-chart-1 ~ --rn-color-chart-8:#3b6ef6 / #22a06b / #e2a03f / #e5484d / #8b5cf6 / #06b6d4 / #ec4899 / #14b8a6。
间距(--rn-spacing-*)
| 变量 | 值 | 变量 | 值 | |
|---|---|---|---|---|
--rn-spacing-0 | 0 | --rn-spacing-4 | 16px | |
--rn-spacing-1 | 4px | --rn-spacing-5 | 20px | |
--rn-spacing-2 | 8px | --rn-spacing-6 | 24px | |
--rn-spacing-3 | 12px | --rn-spacing-8 | 32px | |
--rn-spacing-10 / 12 | 40px / 48px |
字体(--rn-font-*)
- 字族
--rn-font-family:系统字体栈(含 PingFang / 微软雅黑回退) - 字号
--rn-font-size-xs/sm/md/lg/xl/2xl/3xl:12 / 13 / 14 / 16 / 20 / 24 / 30px - 字重
--rn-font-weight-regular/medium/semibold/bold:400 / 500 / 600 / 700 - 行高
--rn-font-line-height-tight/normal/loose:1.25 / 1.5 / 1.75
圆角与阴影
| 变量 | 值 | 变量 | 值 | |
|---|---|---|---|---|
--rn-radius-none | 0 | --rn-shadow-sm | 0 1px 2px rgba(15,20,30,.08) | |
--rn-radius-sm | 4px | --rn-shadow-md | 0 4px 12px rgba(15,20,30,.10) | |
--rn-radius-md | 8px | --rn-shadow-lg | 0 8px 24px rgba(15,20,30,.14) | |
--rn-radius-lg | 12px | |||
--rn-radius-full | 9999px |
其他
| 组 | 变量 | 值 |
|---|---|---|
| 断点 | sm / md / lg / xl | 640 / 768 / 1024 / 1280px(TS:breakpointPx) |
| 层级 | --rn-z-index-dropdown / overlay / dialog / toast | 1000 / 2000 / 2100 / 3000 |
| 动效时长 | --rn-duration-fast / normal / slow | 120ms / 200ms / 320ms |
| 控件高度 | --rn-size-control-sm / md / lg | 28 / 36 / 44px |
修改 Tokens(组件库仓库内)
基础 tokens 只改 packages/tokens/src/tokens.json,然后:
bash
pnpm --filter @ruanno-ui/tokens build产物为 dist/tokens.css(:root 变量)与 dist/themes.css(各主题的 [data-rn-theme] 覆盖)。新增主题见 主题定制。