Steps 步骤条

定义/Definition

一种操作步骤的任务引导和进度显示。

规则 / Rule

建议三步以上,五步以内。可提供个性化定制,可用于购买流程等。

代码演示

基本用法

简单的步骤条。

  1. import { Steps, WingBlank, WhiteSpace } from 'antd-mobile';
  2. const Step = Steps.Step;
  3. const steps = [{
  4. title: '已完成',
  5. }, {
  6. title: '进行中',
  7. }, {
  8. title: '待运行',
  9. }].map((s, i) => <Step key={i} title={s.title} description={s.description} />);
  10. ReactDOM.render(
  11. <div className="stepsExample">
  12. <WhiteSpace size={20} />
  13. <WingBlank size={20}>
  14. <Steps current={1} size="point">{steps}</Steps>
  15. </WingBlank>
  16. </div>
  17. , mountNode);

竖直方向的步骤条

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

  1. import { Steps, WingBlank, WhiteSpace } from 'antd-mobile';
  2. const Step = Steps.Step;
  3. const steps = [{
  4. title: '已完成',
  5. description: '这里是信息的描述',
  6. }, {
  7. title: '进行中',
  8. description: '这里是信息的描述',
  9. }, {
  10. title: '待运行',
  11. description: '这里是信息的描述',
  12. }, {
  13. title: '又一个待运行',
  14. description: '这里是信息的描述',
  15. }].map((s, i) => <Step key={i} title={s.title} description={s.description} />);
  16. ReactDOM.render(
  17. <div className="stepsExample">
  18. <WhiteSpace size={20} />
  19. <WingBlank size={20}>
  20. <Steps direction="vertical" current={1}>{steps}</Steps>
  21. </WingBlank>
  22. </div>
  23. , mountNode);

带图标的步骤条

通过设置 Steps.Stepicon 属性,可以启用自定义图标。

  1. import { Steps, WingBlank, WhiteSpace } from 'antd-mobile';
  2. const Step = Steps.Step;
  3. ReactDOM.render(
  4. <div className="stepsExample">
  5. <WhiteSpace size={20} />
  6. <WingBlank size={20}>
  7. <Steps>
  8. <Step status="finish" title="步骤1" icon="cloud" />
  9. <Step status="process" title="步骤2" icon="apple" />
  10. <Step status="wait" title="步骤3" icon="github" />
  11. </Steps>
  12. </WingBlank>
  13. </div>
  14. , mountNode);

点状的步骤条

点状的步骤条。

  1. import { Steps, WingBlank, WhiteSpace } from 'antd-mobile';
  2. const Step = Steps.Step;
  3. ReactDOM.render(
  4. <div className="stepsExample">
  5. <WhiteSpace size={20} />
  6. <WingBlank size={20}>
  7. <Steps size="pointer">
  8. <Step status="finish" title="步骤1" icon="pointer" />
  9. <Step status="process" title="步骤2" icon="pointer" />
  10. <Step status="wait" title="步骤3" icon="pointer" />
  11. </Steps>
  12. </WingBlank>
  13. </div>
  14. , mountNode);

Steps步骤条 - 图1

API

  1. <Steps>
  2. <Step title="第一步" />
  3. <Step title="第二步" />
  4. <Step title="第三步" />
  5. </Steps>

Steps

整体步骤条。
参数说明类型默认值
current指定当前步骤,从 0 开始记数。在子 Step 元素中,可以通过 status 属性覆盖状态number0
status指定当前步骤的状态,可选 waitprocessfinisherrorstringprocess
size指定大小,目前支持普通(default)、迷你(small)和点状(pointerstringdefault
direction指定步骤条方向。目前支持水平和竖直(vertical)两种方向,默认水平方向)string-

Steps.Step

步骤条内的每一个步骤。
参数说明类型默认值
status指定状态。当不配置该属性时,会使用 Steps 的 current 来自动指定状态。可选:waitprocessfinisherrorstringwait
title标题React.Element-
description步骤的详情描述,可选React.Element-
icon步骤图标,可选string-