跳到主要内容

设计 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-maskrgba(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-00--rn-spacing-416px
--rn-spacing-14px--rn-spacing-520px
--rn-spacing-28px--rn-spacing-624px
--rn-spacing-312px--rn-spacing-832px
--rn-spacing-10 / 1240px / 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-none0--rn-shadow-sm0 1px 2px rgba(15,20,30,.08)
--rn-radius-sm4px--rn-shadow-md0 4px 12px rgba(15,20,30,.10)
--rn-radius-md8px--rn-shadow-lg0 8px 24px rgba(15,20,30,.14)
--rn-radius-lg12px
--rn-radius-full9999px

其他 ​

组变量值
断点sm / md / lg / xl640 / 768 / 1024 / 1280px(TS:breakpointPx)
层级--rn-z-index-dropdown / overlay / dialog / toast1000 / 2000 / 2100 / 3000
动效时长--rn-duration-fast / normal / slow120ms / 200ms / 320ms
控件高度--rn-size-control-sm / md / lg28 / 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] 覆盖)。新增主题见 主题定制。