Statistic统计数值

展示统计数值。

何时使用

当需要突出某个或某组数字时。
当需要展示带描述的统计类数据时使用。

代码演示

Active Users

112,893

Account Balance (CNY)

112,893.00

Active Users

基本

简单的展示。

TypeScript
JavaScript
import React from 'react';
import { Button, Col, Row, Statistic } from 'antd';

const App: React.FC = () => (
  <Row gutter={16}>
    <Col span={12}>
      <Statistic title="Active Users" value={112893} />
    </Col>
    <Col span={12}>
      <Statistic title="Account Balance (CNY)" value={112893} precision={2} />
      <Button style={{ marginTop: 16 }} type="primary">
        Recharge
      </Button>
    </Col>
    <Col span={12}>
      <Statistic title="Active Users" value={112893} loading />
    </Col>
  </Row>
);

export default App;

Active Users

Account Balance (CNY)

动画效果

给数值添加动画进入效果，需要配合 react-countup。

TypeScript
JavaScript
import React from 'react';
import { Col, Row, Statistic } from 'antd';
import CountUp from 'react-countup';

const formatter = (value: number) => <CountUp end={value} separator="," />;

const App: React.FC = () => (
  <Row gutter={16}>
    <Col span={12}>
      <Statistic title="Active Users" value={112893} formatter={formatter} />
    </Col>
    <Col span={12}>
      <Statistic title="Account Balance (CNY)" value={112893} precision={2} formatter={formatter} />
    </Col>
  </Row>
);

export default App;

Countdown

48:00:29

Million Seconds

48:00:29:663

Day Level

2 天 0 时 0 分 29 秒

Countdown

00:00:09

倒计时

倒计时组件。

TypeScript
JavaScript
import React from 'react';
import { Col, Row, Statistic } from 'antd';
import type { StatisticProps } from 'antd';

const { Countdown } = Statistic;
const deadline = Date.now() + 1000 * 60 * 60 * 24 * 2 + 1000 * 30; // Dayjs is also OK

const App: React.FC = () => {
  const onFinish = () => {
    console.log('finished!');
  };

  const onChange = (val: StatisticProps['value']) => {
    if (val && 4.95 * 1000 < val && val < 5 * 1000) {
      console.log('changed!');
    }
  };

  return (
    <Row gutter={16}>
      <Col span={12}>
        <Countdown title="Countdown" value={deadline} onFinish={onFinish} />
      </Col>
      <Col span={12}>
        <Countdown title="Million Seconds" value={deadline} format="HH:mm:ss:SSS" />
      </Col>
      <Col span={24} style={{ marginTop: 32 }}>
        <Countdown title="Day Level" value={deadline} format="D 天 H 时 m 分 s 秒" />
      </Col>
      <Col span={12}>
        <Countdown title="Countdown" value={Date.now() + 10 * 1000} onChange={onChange} />
      </Col>
    </Row>
  );
};

export default App;

Feedback

1,128

Unmerged

93/ 100

单位

通过前缀和后缀添加单位。

TypeScript
JavaScript
import React from 'react';
import { LikeOutlined } from '@ant-design/icons';
import { Col, Row, Statistic } from 'antd';

const App: React.FC = () => (
  <Row gutter={16}>
    <Col span={12}>
      <Statistic title="Feedback" value={1128} prefix={<LikeOutlined />} />
    </Col>
    <Col span={12}>
      <Statistic title="Unmerged" value={93} suffix="/ 100" />
    </Col>
  </Row>
);

export default App;

Active

11.28%

Idle

9.30%

在卡片中使用

在卡片中展示统计数值。

TypeScript
JavaScript
import React from 'react';
import { ArrowDownOutlined, ArrowUpOutlined } from '@ant-design/icons';
import { Card, Col, Row, Statistic } from 'antd';

const App: React.FC = () => (
  <Row gutter={16}>
    <Col span={12}>
      <Card bordered={false}>
        <Statistic
          title="Active"
          value={11.28}
          precision={2}
          valueStyle={{ color: '#3f8600' }}
          prefix={<ArrowUpOutlined />}
          suffix="%"
        />
      </Card>
    </Col>
    <Col span={12}>
      <Card bordered={false}>
        <Statistic
          title="Idle"
          value={9.3}
          precision={2}
          valueStyle={{ color: '#cf1322' }}
          prefix={<ArrowDownOutlined />}
          suffix="%"
        />
      </Card>
    </Col>
  </Row>
);

export default App;

API

Statistic

参数	说明	类型	默认值	版本
decimalSeparator	设置小数点	string	`.`
formatter	自定义数值展示	(value) => ReactNode	-
groupSeparator	设置千分位标识符	string	`,`
loading	数值是否加载中	boolean	false	4.8.0
precision	数值精度	number	-
prefix	设置数值的前缀	ReactNode	-
suffix	设置数值的后缀	ReactNode	-
title	数值的标题	ReactNode	-
value	数值内容	string \| number	-
valueStyle	设置数值区域的样式	CSSProperties	-

Statistic.Countdown

参数	说明	类型	默认值	版本
format	格式化倒计时展示，参考 dayjs	string	`HH:mm:ss`
prefix	设置数值的前缀	ReactNode	-
suffix	设置数值的后缀	ReactNode	-
title	数值的标题	ReactNode	-
value	数值内容	number \| dayjs	-
valueStyle	设置数值区域的样式	CSSProperties	-
onFinish	倒计时完成时触发	() => void	-
onChange	倒计时时间变化时触发	(value: number) => void	-	4.16.0

import React from 'react'; import { Button, Col, Row, Statistic } from 'antd'; const App: React.FC = () => ( <Row gutter={16}> <Col span={12}> <Statistic title="Active Users" value={112893} /> </Col> <Col span={12}> <Statistic title="Account Balance (CNY)" value={112893} precision={2} /> <Button style={{ marginTop: 16 }} type="primary"> Recharge </Button> </Col> <Col span={12}> <Statistic title="Active Users" value={112893} loading /> </Col> </Row> ); export default App;

import React from 'react'; import { Col, Row, Statistic } from 'antd'; import CountUp from 'react-countup'; const formatter = (value: number) => <CountUp end={value} separator="," />; const App: React.FC = () => ( <Row gutter={16}> <Col span={12}> <Statistic title="Active Users" value={112893} formatter={formatter} /> </Col> <Col span={12}> <Statistic title="Account Balance (CNY)" value={112893} precision={2} formatter={formatter} /> </Col> </Row> ); export default App;

import React from 'react'; import { Col, Row, Statistic } from 'antd'; import type { StatisticProps } from 'antd'; const { Countdown } = Statistic; const deadline = Date.now() + 1000 * 60 * 60 * 24 * 2 + 1000 * 30; // Dayjs is also OK const App: React.FC = () => { const onFinish = () => { console.log('finished!'); }; const onChange = (val: StatisticProps['value']) => { if (val && 4.95 * 1000 < val && val < 5 * 1000) { console.log('changed!'); } }; return ( <Row gutter={16}> <Col span={12}> <Countdown title="Countdown" value={deadline} onFinish={onFinish} /> </Col> <Col span={12}> <Countdown title="Million Seconds" value={deadline} format="HH:mm:ss:SSS" /> </Col> <Col span={24} style={{ marginTop: 32 }}> <Countdown title="Day Level" value={deadline} format="D 天 H 时 m 分 s 秒" /> </Col> <Col span={12}> <Countdown title="Countdown" value={Date.now() + 10 * 1000} onChange={onChange} /> </Col> </Row> ); }; export default App;

import React from 'react'; import { LikeOutlined } from '@ant-design/icons'; import { Col, Row, Statistic } from 'antd'; const App: React.FC = () => ( <Row gutter={16}> <Col span={12}> <Statistic title="Feedback" value={1128} prefix={<LikeOutlined />} /> </Col> <Col span={12}> <Statistic title="Unmerged" value={93} suffix="/ 100" /> </Col> </Row> ); export default App;

import React from 'react'; import { ArrowDownOutlined, ArrowUpOutlined } from '@ant-design/icons'; import { Card, Col, Row, Statistic } from 'antd'; const App: React.FC = () => ( <Row gutter={16}> <Col span={12}> <Card bordered={false}> <Statistic title="Active" value={11.28} precision={2} valueStyle={{ color: '#3f8600' }} prefix={<ArrowUpOutlined />} suffix="%" /> </Card> </Col> <Col span={12}> <Card bordered={false}> <Statistic title="Idle" value={9.3} precision={2} valueStyle={{ color: '#cf1322' }} prefix={<ArrowDownOutlined />} suffix="%" /> </Card> </Col> </Row> ); export default App;

API

Statistic

参数	说明	类型	默认值	版本
decimalSeparator	设置小数点	string	`.`
formatter	自定义数值展示	(value) => ReactNode	-
groupSeparator	设置千分位标识符	string	`,`
loading	数值是否加载中	boolean	false	4.8.0
precision	数值精度	number	-
prefix	设置数值的前缀	ReactNode	-
suffix	设置数值的后缀	ReactNode	-
title	数值的标题	ReactNode	-
value	数值内容	string \| number	-
valueStyle	设置数值区域的样式	CSSProperties	-

Statistic.Countdown

参数	说明	类型	默认值	版本
format	格式化倒计时展示，参考 dayjs	string	`HH:mm:ss`
prefix	设置数值的前缀	ReactNode	-
suffix	设置数值的后缀	ReactNode	-
title	数值的标题	ReactNode	-
value	数值内容	number \| dayjs	-
valueStyle	设置数值区域的样式	CSSProperties	-
onFinish	倒计时完成时触发	() => void	-
onChange	倒计时时间变化时触发	(value: number) => void	-	4.16.0

Ant Design

Statistic统计数值

Ant Design

Statistic统计数值

何时使用

代码演示

API

Statistic

Statistic.Countdown

何时使用

代码演示

API

Statistic

Statistic.Countdown