logoAnt Design

⌘ K
  • 设计
  • 研发
  • 组件
  • 博客
  • 资源
  • 国内镜像
6.0.0-alpha.3
  • 组件总览
  • 更新日志
    v6.0.0-alpha.3
  • 通用
    • Button按钮
    • FloatButton悬浮按钮
      5.0.0
    • Icon图标
    • Typography排版
  • 布局
    • Divider分割线
    • Flex弹性布局
      5.10.0
    • Grid栅格
    • Layout布局
    • Masonry瀑布流
      6.0.0
    • Space间距
    • Splitter分隔面板
      5.21.0
  • 导航
    • Anchor锚点
    • Breadcrumb面包屑
    • Dropdown下拉菜单
    • Menu导航菜单
    • Pagination分页
    • Steps步骤条
    • Tabs标签页
  • 数据录入
    • AutoComplete自动完成
    • Cascader级联选择
    • Checkbox多选框
    • ColorPicker颜色选择器
      5.5.0
    • DatePicker日期选择框
    • Form表单
    • Input输入框
    • InputNumber数字输入框
    • Mentions提及
    • Radio单选框
    • Rate评分
    • Select选择器
    • Slider滑动输入条
    • Switch开关
    • TimePicker时间选择框
    • Transfer穿梭框
    • TreeSelect树选择
    • Upload上传
  • 数据展示
    • Avatar头像
    • Badge徽标数
    • Calendar日历
    • Card卡片
    • Carousel走马灯
    • Collapse折叠面板
    • Descriptions描述列表
    • Empty空状态
    • Image图片
    • List列表
      废弃
    • Popover气泡卡片
    • QRCode二维码
      5.1.0
    • Segmented分段控制器
    • Statistic统计数值
    • Table表格
    • Tag标签
    • Timeline时间轴
    • Tooltip文字提示
    • Tour漫游式引导
      5.0.0
    • Tree树形控件
  • 反馈
    • Alert警告提示
    • Drawer抽屉
    • Message全局提示
    • Modal对话框
    • Notification通知提醒框
    • Popconfirm气泡确认框
    • Progress进度条
    • Result结果
    • Skeleton骨架屏
    • Spin加载中
    • Watermark水印
      5.1.0
  • 其他
    • Affix固钉
    • App包裹组件
      5.1.0
    • ConfigProvider全局化配置
    • Util工具类
何时使用
代码演示
基本用法
步骤运行错误
竖直方向的步骤条
可点击
面板式步骤
带图标的步骤条
标签放置位置与进度
点状步骤条
导航步骤
内联步骤
内联样式组合
自定义各种语义结构的样式和类
API
Steps
StepItem
Semantic DOM
Steps
StepItem
主题变量(Design Token)

Steps
步骤条

引导用户按照流程完成任务的导航条。
使用import { Steps } from "antd";
源码components/steps
文档
编辑此页
文档贡献者
Pagination分页Tabs标签页

相关资源

Ant Design X
Ant Design Charts
Ant Design Pro
Pro Components
Ant Design Mobile
Ant Design Mini
Ant Design Web3
Ant Design Landing-首页模板集
Scaffolds-脚手架市场
Umi-React 应用开发框架
dumi-组件/文档研发工具
qiankun-微前端框架
Ant Motion-设计动效
国内镜像站点 🇨🇳

社区

Awesome Ant Design
Medium
X
yuque logoAnt Design 语雀专栏
Ant Design 知乎专栏
体验科技专栏
seeconf logoSEE Conf-蚂蚁体验科技大会
加入我们

帮助

GitHub
更新日志
常见问题
报告 Bug
议题
讨论区
StackOverflow
SegmentFault

Ant XTech logo更多产品

yuque logo语雀-构建你的数字花园
AntV logoAntV-数据可视化解决方案
Egg logoEgg-企业级 Node.js 框架
Kitchen logoKitchen-Sketch 工具集
Galacean logoGalacean-互动图形解决方案
WeaveFox logoWeaveFox-前端智能研发
xtech logo蚂蚁体验科技
主题编辑器
Made with ❤ by
蚂蚁集团和 Ant Design 开源社区

何时使用

当任务复杂或者存在先后关系时,将其分解成一系列步骤,从而简化任务。

代码演示

Finished
This is a content.
2
In Progress
Left 00:00:08
This is a content.
3
Waiting
This is a content.
Finished
This is a content.
2
In Progress
Left 00:00:08
This is a content.
3
Waiting
This is a content.
Finished
This is a content.
2
In Progress
Left 00:00:08
This is a content.
3
Waiting
This is a content.
Finished
This is a content.
2
In Progress
Left 00:00:08
This is a content.
3
Waiting
This is a content.
基本用法

简单的步骤条,使用 variant 属性来设置不同的样式,使用 size 控制大小。

CodeSandbox Icon
Hitu Icon
codepen icon
External Link Icon
Expand Icon
Finished
This is a content
In Process
This is a content
3
Waiting
This is a content
步骤运行错误

使用 Steps 的 status 属性来指定当前步骤的状态。

CodeSandbox Icon
Hitu Icon
codepen icon
External Link Icon
Expand Icon
Finished
This is a content.
2
In Progress
This is a content.
3
Waiting
This is a content.
Finished
This is a content.
2
In Progress
This is a content.
3
Waiting
This is a content.
竖直方向的步骤条

简单的竖直方向的步骤条。

CodeSandbox Icon
Hitu Icon
codepen icon
External Link Icon
Expand Icon
1
Step 1
This is a content.
2
Step 2
This is a content.
3
Step 3
This is a content.
1
Step 1
This is a content.
2
Step 2
This is a content.
3
Step 3
This is a content.
可点击

设置 onChange 后,Steps 变为可点击状态。

CodeSandbox Icon
Hitu Icon
codepen icon
External Link Icon
Expand Icon
1
Step 1
00:00
This is a content.
Arrow
Step 2
This is a content.
Arrow
3
Step 3
This is a content.
Arrow
1
Step 1
00:00
This is a content.
Arrow
Step 2
This is a content.
Arrow
3
Step 3
This is a content.
Arrow
面板式步骤

面板类型的步骤条。

CodeSandbox Icon
Hitu Icon
codepen icon
External Link Icon
Expand Icon
Login
Verification
Pay
Done
带图标的步骤条

通过设置 items 的 icon 属性,可以启用自定义图标。

CodeSandbox Icon
Hitu Icon
codepen icon
External Link Icon
Expand Icon
Finished
This is a content.
2
In Progress
This is a content.
3
Waiting
This is a content.

Finished
This is a content.
Progress2
In Progress
This is a content.
3
Waiting
This is a content.

Finished
This is a content.
Progress2
In Progress
This is a content.
3
Waiting
This is a content.
标签放置位置与进度

使用 titlePlacement 设置标签位置,通过 percent 显示进度。

CodeSandbox Icon
Hitu Icon
codepen icon
External Link Icon
Expand Icon
Finished
This is a content.
In Progress
This is a content.
Waiting
This is a content.
Finished
This is a content.
In Progress
This is a content.
Waiting
This is a content.
Finished
This is a content.
In Progress
This is a content.
Waiting
This is a content.
Finished
This is a content.
In Progress
This is a content.
Waiting
This is a content.
点状步骤条

包含步骤点的进度条。

CodeSandbox Icon
Hitu Icon
codepen icon
External Link Icon
Expand Icon
Step 1
00:00:05
This is a content.
2
Step 2
00:01:02
This is a content.
3
Step 3
waiting for longlong time
This is a content.
Step 1
2
Step 2
3
Step 3
4
Step 4
finish 1
finish 2
3
current process
4
wait
导航步骤

导航类型的步骤条。

CodeSandbox Icon
Hitu Icon
codepen icon
External Link Icon
Expand Icon
  • Ant Design Title 1

    Ant Design, a design language for background applications, is refined by Ant UED Team
    Step 1
    This is Step 1
    Step 2
    This is Step 2
    Step 3
    This is Step 3
  • Ant Design Title 2

    Ant Design, a design language for background applications, is refined by Ant UED Team
    Step 1
    This is Step 1
    Step 2
    This is Step 2
    Step 3
    This is Step 3
  • Ant Design Title 3

    Ant Design, a design language for background applications, is refined by Ant UED Team
    Step 1
    This is Step 1
    Step 2
    This is Step 2
    Step 3
    This is Step 3
  • Ant Design Title 4

    Ant Design, a design language for background applications, is refined by Ant UED Team
    Step 1
    This is Step 1
    Step 2
    This is Step 2
    Step 3
    This is Step 3
内联步骤

内联类型的步骤条,适用于列表内容场景中展示对象所在流程、当前状态的情况。

CodeSandbox Icon
Hitu Icon
codepen icon
External Link Icon
Expand Icon
Step 1
Sub Title
This is Step 1
Step 2
Sub Title
This is Step 2
Step 3
Sub Title
This is Step 3
Step 4
Sub Title
This is Step 4
Step 5
Sub Title
This is Step 5
Step 1
Sub Title
This is Step 1
Step 2
Sub Title
This is Step 2
Step 3
Sub Title
This is Step 3
Step 4
Sub Title
This is Step 4
Step 5
Sub Title
This is Step 5
Step 3
Sub Title
This is Step 3
Step 4
Sub Title
This is Step 4
Step 5
Sub Title
This is Step 5
内联样式组合

内联步骤条修改样式,通过 offset 进行对齐。

CodeSandbox Icon
Hitu Icon
codepen icon
External Link Icon
Expand Icon
Finished
This is a content.
2
In Progress
This is a content.
3
Waiting
This is a content.
Finished
This is a content.
2
In Progress
This is a content.
3
Waiting
This is a content.
自定义各种语义结构的样式和类

通过 classNames 和 styles 传入对象/函数可以自定义 Steps 的语义化结构样式。

CodeSandbox Icon
Hitu Icon
codepen icon
External Link Icon
Expand Icon
6.0.0

API

通用属性参考:通用属性

Steps

整体步骤条。

参数说明类型默认值版本
classNames用于自定义组件内部各语义化结构的 class,支持对象或函数Record<SemanticDOM, string> | (info: { props })=> Record<SemanticDOM, string>-
current指定当前步骤,从 0 开始记数。在子 Step 元素中,可以通过 status 属性覆盖状态number0
direction指定步骤条方向。目前支持水平(horizontal)和竖直(vertical)两种方向stringhorizontal
iconRender自定义渲染图标,请优先使用 items.icon(oriNode, info: { index, active, item }) => ReactNode-
initial起始序号,从 0 开始记数number0
labelPlacement指定标签放置位置,默认水平放图标右侧,可选 vertical 放图标下方stringhorizontal
orientation指定步骤条方向。目前支持水平(horizontal)和竖直(vertical)两种方向stringhorizontal
percent当前 process 步骤显示的进度条进度(只对基本类型的 Steps 生效)number-4.5.0
progressDot点状步骤条,可以设置为一个 function,titlePlacement 将强制为 verticalboolean | (iconDot, { index, status, title, content }) => ReactNodefalse
responsive当屏幕宽度小于 532px 时自动变为垂直模式booleantrue
size指定大小,目前支持普通(default)和迷你(small)stringdefault
status指定当前步骤的状态,可选 wait process finish errorstringprocess
styles用于自定义组件内部各语义化结构的行内 style,支持对象或函数Record<SemanticDOM, CSSProperties> | (info: { props })=> Record<SemanticDOM, CSSProperties>-
titlePlacement指定标签放置位置,默认水平放图标右侧,可选 vertical 放图标下方stringhorizontal
type步骤条类型,可选 default dot inline navigation panelstringdefault
variant设置样式变体filled | outlinedfilled
onChange点击切换步骤时触发(current) => void-
items配置选项卡内容StepItem[]4.24.0

StepItem

步骤条内的每一个步骤。

参数说明类型默认值版本
content步骤的详情描述,可选ReactNode-
description步骤的详情描述,可选ReactNode-
disabled禁用点击booleanfalse
icon步骤图标的类型,可选ReactNode-
status指定状态。当不配置该属性时,会使用 Steps 的 current 来自动指定状态。可选:wait process finish errorstringwait
subTitle子标题ReactNode-
title标题ReactNode-

Semantic DOM

Steps

Step 1
00:00
This is a content.
2
Step 2
00:01
This is a content.
3
Step 3
00:02
This is a content.
Step 1
00:00
This is a content.
Arrow
2
Step 2
00:01
This is a content.
Arrow
3
Step 3
00:02
This is a content.
Arrow
  • root
    根元素,包含 flex 布局、禁止换行、对齐方式、CSS 变量等步骤条容器的基础样式
  • item
    步骤项元素,包含 flex 布局、相对定位等单个步骤项的基础容器样式
  • itemWrapper
    步骤项内裹元素,包含 flex 布局、禁止换行、顶部内边距等步骤项内容的包装样式
  • itemIcon
    步骤项图标元素,包含图标的尺寸、定位、字体大小等图标显示相关样式
  • itemHeader
    步骤项头部元素,包含 flex 布局、禁止换行、对齐方式等头部区域的布局样式
  • itemTitle
    步骤项标题元素,包含颜色、字体大小、行高、文字换行、过渡动画等标题文字样式
  • itemSubtitle
    步骤项副标题元素,包含颜色、字体权重、字体大小、行高、外边距、文字换行等副标题样式
  • itemSection
    步骤项区域元素,包含步骤项内容区域的布局和样式
  • itemContent
    步骤项内容元素,包含颜色、字体大小、行高、文字换行、过渡动画等内容文字样式
  • itemRail
    步骤项连接线元素,包含边框样式、边框宽度、过渡动画等连接线的样式

StepItem

Step 1
00:00
This is a content.
2
Step 2
00:01
This is a content.
3
Step 3
00:02
This is a content.
Step 1
00:00
This is a content.
Arrow
2
Step 2
00:01
This is a content.
Arrow
3
Step 3
00:02
This is a content.
Arrow
  • root
    根元素
  • wrapper
    步骤项内裹元素
  • icon
    步骤项图标元素
  • header
    步骤项头部元素
  • title
    步骤项标题元素
  • subtitle
    步骤项副标题元素
  • section
    步骤项区域元素
  • content
    步骤项内容元素
  • rail
    步骤项连接线元素

主题变量(Design Token)

组件 Token如何定制?
Token 名称描述类型默认值
customIconFontSize自定义图标大小number24
customIconSize自定义图标容器尺寸number32
customIconTop自定义图标 topnumber0
dotCurrentSize点状步骤点当前大小number10
dotSize点状步骤点大小number8
iconFontSize图标大小number14
iconSize图标容器尺寸number32
iconSizeSM小号步骤条图标大小number24
iconTop图标 topnumber-0.5
navArrowColor可跳转步骤条箭头颜色stringrgba(0,0,0,0.25)
navContentMaxWidth可跳转步骤条内容最大宽度undefined | MaxWidth<string | number>unset
全局 Token如何定制?