Skip to content

设计 Token 与状态规范

Wbbb UI 的视觉决策均由可替换 Token 驱动。组件与 Playground 不应直接写入散落的色值。

语义色

类型使用场景典型组件
primary主操作、选中态、链接Button、Tabs、Progress
success完成、成功反馈Tag、Notify、Steps
warning风险提示、需要注意的操作NoticeBar、Form 提示
danger失败、删除、校验错误Input、Upload、Dialog
info中性说明与辅助反馈Text、Timeline、Badge
neutral容器、分割线、低强调信息Card、Cell、Skeleton

每种语义色同时包含实体色、前景色、浅底、边框、hover 与按下层级;亮色和深色主题均有显式映射。

控件状态

  • 可操作控件至少区分默认、焦点、按压、选中和禁用。
  • 输入类控件额外提供已填写、只读、校验错误和边界值。
  • 加载、禁用与只读状态不会触发点击或按压反馈。
  • H5 遵循 prefers-reduced-motion,减少循环、缩放和大范围位移动效。

Token 用法

scss
@use 'wbbb-ui/theme' with (
  $wbbb-color-primary: #0f7c66
);

主题通过既有的 setTheme() API 切换;不需要为单个组件维护另一套主题逻辑。

需要检查全部语义色与状态组合时,请在 Playground 的“设计色板与状态规范”页面验收。

Wbbb UI · 为 uni-app 产品体验而生