简介

数字组件用于在表格列中展示数字类型的数据，支持格式化显示和数值计算。

用法示例

基础用法

use plugin\xbCode\builder\Builder;

// 创建表格
Builder::crud(function($builder) {
  // 添加数字列
  $builder->addColumnNumber('price', '价格');
});

自定义配置

Builder::crud(function($builder) {
  // 使用回调函数自定义配置
  $builder->addColumnNumber('amount', '金额', function($component) {
    $component->precision(2); // 小数点精度
    $component->prefix('¥'); // 前缀符号
    $component->width(120);
  });
  
  // 使用数组方式配置
  $builder->addColumnNumber('quantity', '数量', [
    'precision' => 0,
    'width' => 80
  ]);
});

组件参数

参数名	类型	默认值	说明
name	string	必填	字段名称，对应数据库字段
label	string	必填	列标题，显示在表格头部
option	callable\|array	[]	配置选项，可以是回调函数或数组

数字组件属性

属性名	类型	默认值	说明
precision	int	-	小数点精度
prefix	string	-	前缀符号（如：¥、$）
suffix	string	-	后缀符号（如：元、个）
kilobitSeparator	bool	-	千分位分隔符
className	string	-	CSS 类名
width	int\|string	-	列宽度
align	string	-	水平对齐方式
vAlign	string	-	垂直对齐方式

使用场景

价格金额展示
数量统计展示
百分比显示
评分展示

注意事项

适用于数值类型的数据展示
precision 控制小数位数
可以添加货币符号等前后缀
支持千分位分隔符显示