头部数据统计

简介

数据统计组件用于在表格头部展示统计数据,以卡片形式呈现关键指标。

用法示例

基础用法

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');
});

组件示例图

3.png

组件参数

参数名类型默认值说明
titlestring必填统计项标题
valueint|float必填统计数值

统计组件属性

属性名类型默认值说明
titlestring-统计项标题
valueint|float-统计数值
unitstring-单位(如:元、个、人)
iconstring-图标类名
colorstring-颜色:'primary'、'success'、'warning'、'danger'、'info'
urlstring-点击跳转的链接地址
prefixstring-数值前缀
suffixstring-数值后缀

使用场景

  • 数据概览展示
  • 关键指标统计
  • 实时数据展示
  • 业务数据汇总

注意事项

  1. 统计卡片会显示在表格顶部
  2. 默认每行显示6个统计项(可通过 countCol 属性调整)
  3. 支持点击跳转到详细页面
  4. 可以设置不同颜色突出显示重要指标
  5. 数值支持整数和浮点数