Steps 设计文档

步骤条,引导用户按流程完成任务。组合式 API(<Steps><Steps.Step/></Steps>),严格全量对齐 Semi Design:文件结构(basicStep/basicSteps/fillStep/fillSteps/navStep/navSteps)、物理属性 CSS、具名图标、fill 型 Row/Col 栅格与三型差异化 props 边界均逐一对齐;纯受控 current(无 defaultCurrent)。

← API 文档

使用建议

步骤条,引导用户按流程完成任务。组合式 API(<Steps><Steps.Step/></Steps>),严格全量对齐 Semi Design:文件结构(basicStep/basicSteps/fillStep/fillSteps/navStep/navSteps)、物理属性 CSS、具名图标、fill 型 Row/Col 栅格与三型差异化 props 边界均逐一对齐;纯受控 current(无 defaultCurrent)。

Accessibility

ARIA role:none

  • div 结构(严格对齐 Semi,无 ol/li 列表语义、无 nav 地标包裹)
  • 可点击(fill/basic + onChange)时每步 tabIndex=0 + onKeyDown 处理 Enter;非原生 button,不处理 Space(对齐 Semi)
  • 每步固定 aria-current="step"(对齐 Semi,不区分是否为当前步)
  • 连接线为纯装饰性伪元素(::after),不生成额外 DOM

设计变量

变量
默认值
用法
--cd-transition-delay-steps-item-backgroundcolor var(--cd-motion-delay-none) 步骤条 item 背景色-延迟时间
--cd-transition-delay-steps-item-title-icon var(--cd-motion-delay-none) 步骤条图标颜色-延迟时间
--cd-transition-delay-steps-item-title-text var(--cd-motion-delay-none) 步骤条标题文本颜色-延迟时间
--cd-transition-duration-steps-item-backgroundcolor var(--cd-motion-duration-none) 步骤条 item 背景色-动画持续时间
--cd-transition-duration-steps-item-title-icon var(--cd-motion-duration-none) 步骤条图标颜色-动画持续时间
--cd-transition-duration-steps-item-title-text var(--cd-motion-duration-none) 步骤条标题文本颜色-动画持续时间
--cd-transition-function-steps-item-backgroundcolor var(--cd-motion-ease-in) 步骤条 item 背景色-过渡曲线
--cd-transition-function-steps-item-title-icon var(--cd-motion-ease-in) 步骤条图标颜色-过渡曲线
--cd-transition-function-steps-item-title-text var(--cd-motion-ease-in) 步骤条标题文本颜色-过渡曲线
显示第 1 条-第 9 条,共 9 条
  • 1