Progress进度条
展示操作的当前进度。
何时使用#
在操作需要较长时间才能完成时,为用户显示该操作的当前进度和状态。
当一个操作会打断当前界面,或者需要在后台运行,且耗时可能超过2秒时;
当需要显示一个操作完成的百分比时。
代码演示
import { Progress } from 'antd';
ReactDOM.render(
<div>
<Progress percent={30} />
<Progress percent={50} status="active" />
<Progress percent={70} status="exception" />
<Progress percent={100} />
<Progress percent={50} showInfo={false} />
</div>
, mountNode);
import { Progress } from 'antd';
ReactDOM.render(
<div style={{ width: 170 }}>
<Progress percent={30} strokeWidth={5} />
<Progress percent={50} strokeWidth={5} status="active" />
<Progress percent={70} strokeWidth={5} status="exception" />
<Progress percent={100} strokeWidth={5} />
</div>
, mountNode);
0%
import { Progress, Button } from 'antd';
const ButtonGroup = Button.Group;
class App extends React.Component {
state = {
percent: 0,
}
increase = () => {
let percent = this.state.percent + 10;
if (percent > 100) {
percent = 100;
}
this.setState({ percent });
}
decline = () => {
let percent = this.state.percent - 10;
if (percent < 0) {
percent = 0;
}
this.setState({ percent });
}
render() {
return (
<div>
<Progress type="circle" percent={this.state.percent} />
<ButtonGroup>
<Button onClick={this.decline} icon="minus" />
<Button onClick={this.increase} icon="plus" />
</ButtonGroup>
</div>
);
}
}
ReactDOM.render(<App />, mountNode);
75 Days
Done
import { Progress } from 'antd';
ReactDOM.render(
<div>
<Progress type="circle" percent={75} format={percent => `${percent} Days`} />
<Progress type="circle" percent={100} format={() => 'Done'} />
</div>
, mountNode);
75%
import { Progress } from 'antd';
ReactDOM.render(
<div>
<Progress type="circle" percent={75} />
<Progress type="circle" percent={70} status="exception" />
<Progress type="circle" percent={100} />
</div>
, mountNode);
30%
import { Progress } from 'antd';
ReactDOM.render(
<div>
<Progress type="circle" percent={30} width={80} />
<Progress type="circle" percent={70} width={80} status="exception" />
<Progress type="circle" percent={100} width={80} />
</div>
, mountNode);
import { Progress, Button } from 'antd';
const ButtonGroup = Button.Group;
class App extends React.Component {
state = {
percent: 0,
}
increase = () => {
let percent = this.state.percent + 10;
if (percent > 100) {
percent = 100;
}
this.setState({ percent });
}
decline = () => {
let percent = this.state.percent - 10;
if (percent < 0) {
percent = 0;
}
this.setState({ percent });
}
render() {
return (
<div>
<Progress percent={this.state.percent} />
<ButtonGroup>
<Button onClick={this.decline} icon="minus" />
<Button onClick={this.increase} icon="plus" />
</ButtonGroup>
</div>
);
}
}
ReactDOM.render(<App />, mountNode);
75%
import { Progress } from 'antd';
ReactDOM.render(<Progress type="dashboard" percent={75} />, mountNode);
API#
属性 | 说明 | 类型 | 默认值 |
---|---|---|---|
format | 内容的模板函数 | function(percent) | percent => percent + '%' |
gapDegree (type=circle) | 圆形进度条缺口角度,可取值 0 ~ 360 | number | 0 |
gapPosition (type=circle) | 圆形进度条缺口位置 | Enum{ 'top', 'bottom', 'left', 'right' } | top |
percent | 百分比 | number | 0 |
showInfo | 是否显示进度数值或状态图标 | boolean | true |
status | 状态,可选:success exception active | string | - |
strokeWidth (type=line) | 进度条线的宽度,单位 px | number | 10 |
strokeWidth (type=circle) | 圆形进度条线的宽度,单位是进度条画布宽度的百分比 | number | 6 |
type | 类型,可选 line circle dashboard | string | line |
width (type=circle) | 圆形进度条画布宽度,单位 px | number | 132 |