Steps 步骤条
定义/Definition
一种操作步骤的任务引导和进度显示。
规则 / Rule
建议三步以上,五步以内。可提供个性化定制,可用于购买流程等。
代码演示
基本用法
简单的步骤条。
import { Steps, WingBlank, WhiteSpace } from 'antd-mobile';
const Step = Steps.Step;
const steps = [{
title: '已完成',
}, {
title: '进行中',
}, {
title: '待运行',
}].map((s, i) => <Step key={i} title={s.title} description={s.description} />);
ReactDOM.render(
<div className="stepsExample">
<WhiteSpace size={20} />
<WingBlank size={20}>
<Steps current={1} size="point">{steps}</Steps>
</WingBlank>
</div>
, mountNode);
竖直方向的步骤条
简单的竖直方向的步骤条。
import { Steps, WingBlank, WhiteSpace } from 'antd-mobile';
const Step = Steps.Step;
const steps = [{
title: '已完成',
description: '这里是信息的描述',
}, {
title: '进行中',
description: '这里是信息的描述',
}, {
title: '待运行',
description: '这里是信息的描述',
}, {
title: '又一个待运行',
description: '这里是信息的描述',
}].map((s, i) => <Step key={i} title={s.title} description={s.description} />);
ReactDOM.render(
<div className="stepsExample">
<WhiteSpace size={20} />
<WingBlank size={20}>
<Steps direction="vertical" current={1}>{steps}</Steps>
</WingBlank>
</div>
, mountNode);
带图标的步骤条
通过设置 Steps.Step
的 icon
属性,可以启用自定义图标。
import { Steps, WingBlank, WhiteSpace } from 'antd-mobile';
const Step = Steps.Step;
ReactDOM.render(
<div className="stepsExample">
<WhiteSpace size={20} />
<WingBlank size={20}>
<Steps>
<Step status="finish" title="步骤1" icon="cloud" />
<Step status="process" title="步骤2" icon="apple" />
<Step status="wait" title="步骤3" icon="github" />
</Steps>
</WingBlank>
</div>
, mountNode);
点状的步骤条
点状的步骤条。
import { Steps, WingBlank, WhiteSpace } from 'antd-mobile';
const Step = Steps.Step;
ReactDOM.render(
<div className="stepsExample">
<WhiteSpace size={20} />
<WingBlank size={20}>
<Steps size="pointer">
<Step status="finish" title="步骤1" icon="pointer" />
<Step status="process" title="步骤2" icon="pointer" />
<Step status="wait" title="步骤3" icon="pointer" />
</Steps>
</WingBlank>
</div>
, mountNode);
API
<Steps>
<Step title="第一步" />
<Step title="第二步" />
<Step title="第三步" />
</Steps>
Steps
整体步骤条。
参数 | 说明 | 类型 | 默认值 |
---|
current | 指定当前步骤,从 0 开始记数。在子 Step 元素中,可以通过 status 属性覆盖状态 | number | 0 |
status | 指定当前步骤的状态,可选 wait process finish error | string | process |
size | 指定大小,目前支持普通(default )、迷你(small )和点状(pointer ) | string | default |
direction | 指定步骤条方向。目前支持水平和竖直(vertical )两种方向,默认水平方向) | string | - |
Steps.Step
步骤条内的每一个步骤。
参数 | 说明 | 类型 | 默认值 |
---|
status | 指定状态。当不配置该属性时,会使用 Steps 的 current 来自动指定状态。可选:wait process finish error | string | wait |
title | 标题 | React.Element | - |
description | 步骤的详情描述,可选 | React.Element | - |
icon | 步骤图标,可选 | string | - |