UI Design System
build dev

Status

表达运行、审核或业务状态。中文惯用名:状态。
稳定本期新增已接入

元信息

字段值
规范 IDcomponent.status
名称Status
二级分类通用(general)
用途表达运行、审核或业务状态
描述中文惯用名:状态。

预览

静态结构:<span data-slot="status"> 行内组合——状态点(data-slot="status-dot",size-2 圆点,success/processing/error/warning/default 分别映射 bg-success / bg-info / bg-destructive / bg-warning / bg-muted-foreground)+ 文本(data-slot="status-text");processing 态在圆点下叠加同色系 animate-ping 扩散层(motion-reduce 时退化为静态点)。

DSL 结构

DslNode
{
  "type": "Status",
  "props": {
    "status": "processing",
    "text": "同步中"
  }
}

何时用

何时使用

  • 表达运行、审核或业务状态:服务运行中、任务处理中、审批通过 / 驳回。
  • 需要状态点 + 文本的紧凑组合:列表行、详情页头部、统计卡片脚注。
  • processing 态需要「进行中」动感:内置 ping 扩散动画。

何时不用

  • 纯分类标记、可移除条件:使用 Tag。
  • 数量提醒或未读计数:使用 Badge。
  • 需要图标 + 大标题的整页结果:使用 Result。

变体

变体视觉形态适用场景
success绿色状态点运行正常、审核通过
processing蓝色状态点 + 扩散动画任务进行中、同步中
error红色状态点运行异常、审核驳回
warning橙色状态点存在风险、即将过期
default灰色状态点未启用、已下线等中性态

API 属性

属性类型默认值说明
status`'success''processing''error'
textstring—状态文本
className / stylestring / CSSProperties—通用:根节点 class 合并 / 内联样式

使用规范

  • 状态文本与状态点语义必须一致(error 配「失败 / 驳回」类文案,不写中性词)。
  • 同一页面的状态枚举保持同一套五态映射,不自定义第六种颜色。
  • processing 仅用于真实进行中的状态,不做装饰性动效。

正例

  • ✓ 服务列表:每行 Status 展示「运行中 / 已停止 / 异常」,processing 表示部署中。
  • ✓ 审批详情头部:Status 展示当前审批结论,旁置时间戳辅助文本。

反例

  • ✕ 用 Status 标记商品分类(应使用 Tag)。
  • ✕ processing 状态长期停留不做超时收敛(应有终态流转)。

Design Token 映射

不适用:组件 tokenRefs 为空:样式 Token 数据尚未接入,三层映射(Primitive → Semantic → Component)待样式 Token 接入后回填。