展示操作的当前进度。
在操作需要较长时间才能完成时,为用户显示该操作的当前进度和状态。
import React from 'react';
import { Progress } from 'antd';
const App: React.FC = () => (
<>
<Progress percent={30} />
<Progress percent={50} status="active" />
<Progress percent={70} status="exception" />
<Progress percent={100} />
<Progress percent={50} showInfo={false} />
</>
);
export default App;
import React from 'react';
import { Progress } from 'antd';
const App: React.FC = () => (
<div style={{ width: 170 }}>
<Progress percent={30} size="small" />
<Progress percent={50} size="small" status="active" />
<Progress percent={70} size="small" status="exception" />
<Progress percent={100} size="small" />
</div>
);
export default App;
import React from 'react';
import { Progress, Space } from 'antd';
const App: React.FC = () => (
<Space wrap>
<Progress type="circle" percent={30} size={80} />
<Progress type="circle" percent={70} size={80} status="exception" />
<Progress type="circle" percent={100} size={80} />
</Space>
);
export default App;
import React, { useState } from 'react';
import { MinusOutlined, PlusOutlined } from '@ant-design/icons';
import { Button, Progress } from 'antd';
const App: React.FC = () => {
const [percent, setPercent] = useState<number>(0);
const increase = () => {
setPercent((prevPercent) => {
const newPercent = prevPercent + 10;
if (newPercent > 100) {
return 100;
}
return newPercent;
});
};
const decline = () => {
setPercent((prevPercent) => {
const newPercent = prevPercent - 10;
if (newPercent < 0) {
return 0;
}
return newPercent;
});
};
return (
<>
<Progress percent={percent} />
<Button.Group>
<Button onClick={decline} icon={<MinusOutlined />} />
<Button onClick={increase} icon={<PlusOutlined />} />
</Button.Group>
</>
);
};
export default App;
import React from 'react';
import { Progress, Space } from 'antd';
const App: React.FC = () => (
<Space wrap>
<Progress type="dashboard" percent={75} />
<Progress type="dashboard" percent={75} gapDegree={30} />
</Space>
);
export default App;
import React from 'react';
import { Progress, Space } from 'antd';
const App: React.FC = () => (
<>
<Progress strokeLinecap="butt" percent={75} />
<Space wrap>
<Progress strokeLinecap="butt" type="circle" percent={75} />
<Progress strokeLinecap="butt" type="dashboard" percent={75} />
</Space>
</>
);
export default App;
import React from 'react';
import { Progress } from 'antd';
import { red, green } from '@ant-design/colors';
const App: React.FC = () => (
<>
<Progress percent={50} steps={3} />
<br />
<Progress percent={30} steps={5} />
<br />
<Progress percent={100} steps={5} size="small" strokeColor={green[6]} />
<br />
<Progress percent={60} steps={5} strokeColor={[green[6], green[6], red[5]]} />
</>
);
export default App;
import React from 'react';
import { Progress, Space } from 'antd';
const App: React.FC = () => (
<Space wrap>
<Progress type="circle" percent={75} />
<Progress type="circle" percent={70} status="exception" />
<Progress type="circle" percent={100} />
</Space>
);
export default App;
import React from 'react';
import { Progress } from 'antd';
const App: React.FC = () => (
<>
<Progress
type="circle"
trailColor="#e6f4ff"
percent={60}
strokeWidth={20}
size={14}
format={(number) => `进行中,已完成${number}%`}
/>
<span style={{ marginLeft: 8 }}>代码发布</span>
</>
);
export default App;
import React, { useState } from 'react';
import { MinusOutlined, PlusOutlined } from '@ant-design/icons';
import { Button, Progress } from 'antd';
const App: React.FC = () => {
const [percent, setPercent] = useState<number>(0);
const increase = () => {
setPercent((prevPercent) => {
const newPercent = prevPercent + 10;
if (newPercent > 100) {
return 100;
}
return newPercent;
});
};
const decline = () => {
setPercent((prevPercent) => {
const newPercent = prevPercent - 10;
if (newPercent < 0) {
return 0;
}
return newPercent;
});
};
return (
<>
<Progress type="circle" percent={percent} style={{ marginRight: 8 }} />
<Button.Group>
<Button onClick={decline} icon={<MinusOutlined />} />
<Button onClick={increase} icon={<PlusOutlined />} />
</Button.Group>
</>
);
};
export default App;
import React from 'react';
import { Progress, Space } from 'antd';
const App: React.FC = () => (
<Space wrap>
<Progress type="circle" percent={75} format={(percent) => `${percent} Days`} />
<Progress type="circle" percent={100} format={() => 'Done'} />
</Space>
);
export default App;
import React from 'react';
import { Progress, Tooltip, Space } from 'antd';
const App: React.FC = () => (
<>
<Tooltip title="3 done / 3 in progress / 4 to do">
<Progress percent={60} success={{ percent: 30 }} />
</Tooltip>
<Space wrap>
<Tooltip title="3 done / 3 in progress / 4 to do">
<Progress percent={60} success={{ percent: 30 }} type="circle" />
</Tooltip>
<Tooltip title="3 done / 3 in progress / 4 to do">
<Progress percent={60} success={{ percent: 30 }} type="dashboard" />
</Tooltip>
</Space>
</>
);
export default App;
import React from 'react';
import { Progress, Space } from 'antd';
const App: React.FC = () => (
<>
<Progress percent={99.9} strokeColor={{ '0%': '#108ee9', '100%': '#87d068' }} />
<Progress percent={99.9} status="active" strokeColor={{ from: '#108ee9', to: '#87d068' }} />
<Space wrap>
<Progress type="circle" percent={90} strokeColor={{ '0%': '#108ee9', '100%': '#87d068' }} />
<Progress type="circle" percent={100} strokeColor={{ '0%': '#108ee9', '100%': '#87d068' }} />
</Space>
</>
);
export default App;
import { Progress, Space } from 'antd';
import React from 'react';
const App: React.FC = () => (
<>
<Space direction="vertical">
<Progress percent={50} />
<Progress percent={50} size="small" />
<Progress percent={50} size={[300, 20]} />
</Space>
<br />
<br />
<Space size={30}>
<Progress type="circle" percent={50} />
<Progress type="circle" percent={50} size="small" />
<Progress type="circle" percent={50} size={20} />
</Space>
<br />
<br />
<Space size={30}>
<Progress type="dashboard" percent={50} />
<Progress type="dashboard" percent={50} size="small" />
<Progress type="dashboard" percent={50} size={20} />
</Space>
<br />
<br />
<Space size={30} wrap>
<Progress steps={3} percent={50} />
<Progress steps={3} percent={50} size="small" />
<Progress steps={3} percent={50} size={20} />
<Progress steps={3} percent={50} size={[20, 30]} />
</Space>
</>
);
export default App;
各类型共用的属性。
属性 | 说明 | 类型 | 默认值 | 版本 |
---|---|---|---|---|
format | 内容的模板函数 | function(percent, successPercent) | (percent) => percent + % | - |
percent | 百分比 | number | 0 | - |
showInfo | 是否显示进度数值或状态图标 | boolean | true | - |
status | 状态,可选:success exception normal active (仅限 line) | string | - | - |
strokeColor | 进度条的色彩 | string | - | - |
strokeLinecap | 进度条的样式 | round | butt | square ,区别详见 stroke-linecap | round | - |
success | 成功进度条相关配置 | { percent: number, strokeColor: string } | - | - |
trailColor | 未完成的分段的颜色 | string | - | - |
type | 类型,可选 line circle dashboard | string | line | - |
size | 进度条的尺寸 | number | [number, number] | "small" | "default" | "default" | v5.3.0 |
type="line"
属性 | 说明 | 类型 | 默认值 | 版本 |
---|---|---|---|---|
steps | 进度条总共步数 | number | - | - |
strokeColor | 进度条的色彩,传入 object 时为渐变。当有 steps 时支持传入一个数组。 | string | string[] | { from: string; to: string; direction: string } | - | 4.21.0: string[] |
type="circle"
属性 | 说明 | 类型 | 默认值 | 版本 |
---|---|---|---|---|
strokeColor | 圆形进度条线的色彩,传入 object 时为渐变 | string | object | - | - |
strokeWidth | 圆形进度条线的宽度,单位是进度条画布宽度的百分比 | number | 6 | - |
type="dashboard"
属性 | 说明 | 类型 | 默认值 | 版本 |
---|---|---|---|---|
gapDegree | 仪表盘进度条缺口角度,可取值 0 ~ 295 | number | 75 | - |
gapPosition | 仪表盘进度条缺口位置 | top | bottom | left | right | bottom | - |
strokeWidth | 仪表盘进度条线的宽度,单位是进度条画布宽度的百分比 | number | 6 | - |