# statistic (w-statistic)

- **Import**: `WStatistic` from `win-design-next`
- **Tag**: `<w-statistic>`
- **说明**: Statistic 统计组件
- **分类**: data-display
- **Skill 版本**: V1.1.0
- **适配组件库**: win-design-next 1.2.2
- **API 来源**: `docs/zh-CN/component/statistic.md`、`docs/zh-CN/component/status.md`

## API

## Statistic API

### Attributes

| Attribute         | 描述             | 类型                                                                | 默认值 |
| ----------------- | ---------------- | ------------------------------------------------------------------- | ------ |
| value             | 数字内容         | ^[number]                                                           | 0      |
| decimal-separator | 设置小数点符号   | ^[string]                                                           | .      |
| formatter         | 自定义数字格式化 | ^[Function]`(value: number) => string \| number`                    | —      |
| group-separator   | 设置千分位标识符 | ^[string]                                                           | ,      |
| precision         | 数字精度         | ^[number]                                                           | 0      |
| prefix            | 设置数字的前缀   | ^[string]                                                           | —      |
| suffix            | 设置数字的后缀   | ^[string]                                                           | —      |
| title             | 数字标题         | ^[string]                                                           | —      |
| value-style       | 数字样式         | ^[string] / ^[object]`CSSProperties \| CSSProperties[] \| string[]` | —      |

### Slots

| 插槽名 | 详情       |
| ------ | ---------- |
| prefix | 数字区之前 |
| suffix | 数字区之后 |
| title  | 数字标题   |

### Exposes

| 名称         | 描述       | 类型           |
| ------------ | ---------- | -------------- |
| displayValue | 当前显示值 | ^[object]`Ref` |

## Statistic API

### Attributes

| 参数       | 说明                                             | 类型    | 可选值                                                               | 默认值    | Version |
| ---------- | ------------------------------------------------ | ------- | -------------------------------------------------------------------- | --------- | ------- |
| circle     | 是否为圆形前缀标志                               | Boolean | —                                                                    | true      |
| common     | 文本与 icon 同色                                 | Boolean | —                                                                    | false     |
| icon-color | 自定义 icon 颜色（此时 type 与 common 参数失效） | String  | —                                                                    | —         |
| size       | 大小                                             | String  | 'large' \| 'medium' \| 'default' \| 'mini'                           | 'default' |
| text-color | 自定义文本颜色（此时 type 与 common 参数失效）   | String  | —                                                                    | —         |
| type       | 类型                                             | String  | 'primary' \| 'success' \| 'info' \| 'warning' \| 'error' \| 'danger' | 'primary' |
