项目正在快速迭代中,API 与视觉细节可能随版本调整,请勿用于生产环境。

设计规范 ​

中后台界面的视觉基准:色彩、间距、字体、圆角与阴影、动效。开发直接使用对应的 --eb-* 令牌,改令牌即改主题(含暗色自动跟随);令牌完整清单可用 pnpm tokens:export 导出为 JSON。

色彩 ​

品牌与语义色 ​

令牌值用途
--eb-color-primary#175DFF主操作、选中态、链接
--eb-color-success#16a34a成功、通过、在线
--eb-color-warning#d97706警告、待处理、风险提示
--eb-color-danger#dc2626错误、失败、危险操作
--eb-color-info#64748b中性信息、说明

每个语义色带 light-3 / light-5 / light-7 / light-8 / light-9 浅色梯度(Tag / Alert / 进度等组件的内层用色)与 -rgb 三元组(透明度派生用)。运行时换色用 setPrimaryColor(hex) / setSemanticColors(),全库梯度自动重派生。

中性色 ​

层级令牌值
正文主色--eb-text-color-primary#111827
正文常规--eb-text-color-regular#374151
次要文字--eb-text-color-secondary#6b7280
占位文字--eb-text-color-placeholder#9ca3af
禁用文字--eb-text-color-disabled#d1d5db
页面底--eb-bg-color-page#f9fafb
容器底--eb-bg-color#ffffff
边框(常规 / 轻 / 重)--eb-border-color(-light/-dark)#e0e3ea / #e8ebf1 / #d6d9e0

文字层级按「越重要越深」取用;对比度实测数据见「无障碍与对比度」。

扩展分类色 ​

数据可视化、状态分类标签可用 8 个扩展色:ext-cyan / teal / violet / magenta / indigo / lime / amber / slate。相邻分类取色相间隔开的两色,避免同屏出现明度接近的相邻色。

间距 ​

4px 网格,--eb-space-1 到 --eb-space-12(4 / 8 / 12 / 16 / 20 / 24 / 28 / 32 / 40 / 48px)。

  • 组件内元素间距:space-1 ~ space-3(4–12px)
  • 组件与组件:space-4 ~ space-6(16–24px)
  • 区块之间:space-8 起(32px+)
  • 页面留白:容器两侧 space-6 ~ space-8,禁止 0 边距贴边

字体 ​

字族:--eb-font-family(Inter + 系统栈,中文回退 PingFang SC / Microsoft YaHei)。

令牌值用途
--eb-font-size-xs12px辅助说明、表单错误提示
--eb-font-size-sm13px次要信息、标签
--eb-font-size-base14px正文、控件默认字号
--eb-font-size-md16px小标题、强调正文
--eb-font-size-lg20px区块标题
--eb-font-size-xl ~ 3xl24–40px页面级标题、数据大屏

字重三档:regular 400(正文)/ medium 500(控件、强调)/ semibold 600(标题)。行高:紧凑 1.3(标题)、常规 1.57(正文)、宽松 1.8(说明段落)。数字统计场景用 font-variant-numeric: tabular-nums(表格与统计组件已内置)。

圆角与阴影 ​

令牌值用途
--eb-radius-sm4px小控件(checkbox、tag)
--eb-radius-md6px输入框、按钮(默认)
--eb-radius-lg8px卡片、面板
--eb-radius-xl12px弹窗、大容器
--eb-radius-full9999px胶囊

阴影五档(--eb-shadow-1 ~ 5),克制不抢内容:1–2 档给卡片悬浮,3 档给下拉浮层,4–5 档给模态弹窗。暗色下阴影整体加深,令牌自动重映射。

动效 ​

令牌值用途
--eb-duration-fast0.1shover / 边框 / 底色反馈
--eb-duration-base0.2s展开、位移过渡
--eb-duration-slow0.3s弹层进出场
--eb-duration-slower0.45s大面积区块、抽屉

缓动默认 --eb-ease-out(快进慢收);弹性场景(徽标弹入、轻抬)用 --eb-ease-out-back。系统开启「减弱动态效果」时,动效组件自动关闭,无需逐个处理。