---
url: /components/statistic.md
---
# Statistic 统计数值

展示统计数值：千分位、精度、前后缀、自定义 formatter 与 loading 占位。适用于仪表盘、看板、详情页的指标区块。

## 基础用法

## 精度与千分位

`precision` 控制小数位（四舍五入），`separator` 自定义千分位符号（传空字符串关闭分组）：

## 前缀 / 后缀 / 数值样式

支持 `prefix` / `suffix` 属性或同名插槽（可放图标）；`value-style` 级联到整个数值区：

## 自定义 formatter

传入 `formatter` 后内建的千分位/精度不再生效，完全由函数决定展示：

## loading 与数值翻动

`loading` 用占位点替代数值（拉取接口时）；`flip` 在数值变化时播放上下翻动过渡，适合大屏轮询刷新：

## Statistic API

### Props

| 名称 | 类型 | 默认值 | 说明 |
| --- | --- | --- | --- |
| value | Number / String | `0` | 数值；字符串原样展示（如单号） |
| precision | Number | — | 小数位精度 |
| separator | String | `','` | 千分位符号；`''` 关闭分组 |
| prefix / suffix | String | `''` | 前后缀（同名插槽优先） |
| title | String | `''` | 标题（`title` 插槽优先） |
| value-style | Object | — | 作用于数值区的样式（字号/颜色等） |
| formatter | Function | — | 自定义格式化 `(value) => string`，设置后 separator/precision 失效 |
| loading | Boolean | `false` | 加载占位 |
| flip | Boolean | `false` | 数值变化时的翻动过渡 |

### Slots

| 名称 | 说明 |
| --- | --- |
| title | 标题 |
| prefix / suffix | 前后缀（可放图标） |

## 配套工具

配合 [format 工具](/utils/format) 的 `formatNumber` / `formatDuration` / `formatPercent` 使用；指标区块布局可搭配业务组件 `EbStatCard` / `EbStatRow`。