Progress进度条

展示操作的当前进度。

何时使用

在操作需要较长时间才能完成时，为用户显示该操作的当前进度和状态。

当一个操作会打断当前界面，或者需要在后台运行，且耗时可能超过 2 秒时；
当需要显示一个操作完成的百分比时。

代码演示

30%

50%

进度条

标准的进度条。

TypeScript
JavaScript
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;

30%

50%

小型进度条

适合放在较狭窄的区域内。

TypeScript
JavaScript
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;

30%

小型进度圈

小一号的圈形进度。

TypeScript
JavaScript
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;

动态展示

会动的进度条才是好进度条。

TypeScript
JavaScript
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;

75%

仪表盘

通过设置 type=dashboard，可以很方便地实现仪表盘样式的进度条。若想要修改缺口的角度，可以设置 gapDegree 为你想要的值。

TypeScript
JavaScript
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;

75%

边缘形状

通过设定 strokeLinecap="butt" 可以调整进度条边缘的形状为方形，详见 stroke-linecap。

TypeScript
JavaScript
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;

50%

30%

60%

步骤进度条

带步骤的进度条。

TypeScript
JavaScript
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;

75%

进度圈

圈形的进度。

TypeScript
JavaScript
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;

代码发布

响应式进度圈

响应式的圈形进度，当 width 小于等于 20 的时候，进度信息将不会显示在进度圈里面，而是以 Tooltip 的形式显示。

TypeScript
JavaScript
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;

进度圈动态展示

会动的进度条才是好进度条。

TypeScript
JavaScript
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;

75 Days

Done

自定义文字格式

format 属性指定格式。

TypeScript
JavaScript
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;

60%

分段进度条

标准的进度条。type="circle|dashboard" 时不支持分段颜色。

TypeScript
JavaScript
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;

99.9%

90%

自定义进度条渐变色

linear-gradient 的封装。推荐只传两种颜色。

TypeScript
JavaScript
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;

50%

尺寸

进度条尺寸。

TypeScript
JavaScript
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;

API

各类型共用的属性。

属性	说明	类型	默认值	版本
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	-

Ant Design

Progress进度条

Ant Design

Progress进度条

何时使用

代码演示

API

`type="line"`

`type="circle"`

`type="dashboard"`

何时使用

代码演示

API

`type="line"`

`type="circle"`

`type="dashboard"`