简介
数据统计组件用于在表格头部展示统计数据,以卡片形式呈现关键指标。
用法示例
基础用法
use plugin\xbCode\builder\Builder;
// 创建表格
Builder::crud(function($builder) {
// 添加统计组件
$builder->addHeaderCount('总用户数', 1000);
$builder->addHeaderCount('今日新增', 50);
$builder->addHeaderCount('活跃用户', 800);
});
自定义配置
Builder::crud(function($builder) {
// 使用回调函数自定义统计卡片
$builder->addHeaderCount('销售额', 158000)->unit('元')->color('success');
$builder->addHeaderCount('订单数', 520)->icon('fa fa-shopping-cart');
$builder->addHeaderCount('待处理', 25)->color('warning')->url('/orders?status=pending');
});组件示例图

组件参数
| 参数名 | 类型 | 默认值 | 说明 |
|---|---|---|---|
| title | string | 必填 | 统计项标题 |
| value | int|float | 必填 | 统计数值 |
统计组件属性
| 属性名 | 类型 | 默认值 | 说明 |
|---|---|---|---|
| title | string | - | 统计项标题 |
| value | int|float | - | 统计数值 |
| unit | string | - | 单位(如:元、个、人) |
| icon | string | - | 图标类名 |
| color | string | - | 颜色:'primary'、'success'、'warning'、'danger'、'info' |
| url | string | - | 点击跳转的链接地址 |
| prefix | string | - | 数值前缀 |
| suffix | string | - | 数值后缀 |
使用场景
- 数据概览展示
- 关键指标统计
- 实时数据展示
- 业务数据汇总
注意事项
- 统计卡片会显示在表格顶部
- 默认每行显示6个统计项(可通过 countCol 属性调整)
- 支持点击跳转到详细页面
- 可以设置不同颜色突出显示重要指标
- 数值支持整数和浮点数