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 开源社区
loading

何时使用

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

代码演示

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可跳转步骤条内容最大宽度MaxWidth<string | number> | undefinedunset
全局 Token如何定制?
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 控制大小。

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
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
面板式步骤

面板类型的步骤条。

Login
Verification
Pay
Done
带图标的步骤条

通过设置 items 的 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 显示进度。

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.
点状步骤条

包含步骤点的进度条。

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
导航步骤

导航类型的步骤条。

  • 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
内联步骤

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

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 进行对齐。

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
codepen icon
External Link Icon
Expand Icon
6.0.0
CodeSandbox Icon
Hitu Icon
codepen icon
External Link Icon
Expand Icon
Hitu Icon
CodeSandbox Icon
Hitu Icon
codepen icon
External Link Icon
Expand Icon
CodeSandbox Icon
Hitu Icon
codepen icon
External Link Icon
Expand Icon
CodeSandbox Icon
Hitu Icon
codepen icon
External Link Icon
Expand Icon
CodeSandbox Icon
Hitu Icon
codepen icon
External Link Icon
Expand Icon
CodeSandbox Icon
Hitu Icon
codepen icon
External Link Icon
Expand Icon
CodeSandbox Icon
Hitu Icon
codepen icon
External Link Icon
Expand Icon
CodeSandbox Icon
Hitu Icon
codepen icon
External Link Icon
Expand Icon
Hitu Icon