设置列为可排序 (sortable)

  1. <?php
  2. $grid->column('id')->sortable();

表格字段支持关联关系表字段以及json字段的排序

注意,关联关系仅支持hasOne以及belongsTo两种类型的字段排序,并且不支持多层级嵌套!

<?php

// 关联关系表字段排序
$grid->column('profile.age')->sortable();

// 指定需要排序的字段名称
$grid->column('my_age')->sortable('profile.age');

// json字段排序
$grid->column('options.price')->sortable('options->price');
// 关联关系表的 json 字段排序
$grid->column('profile.options.price')->sortable('profile.options->price');

支持MySqlorder by cast({field}as {type})用法

<?php

$grid->column('profile.age')->sortable(null, 'SIGNED');

$grid->column('profile.options.price')->sortable('profile.options->price', 'SIGNED');

设置默认排序

<?php

$grid->model()->orderBy('id', 'desc');

这个功能也支持关联关系表字段排序,注意这里仅支持一对一以及一对多关联关系

<?php

$grid->model()->orderBy('profile.age');

设置列的宽度 (width)

设置列的宽度,当字段内容过长时可以使用这个方法限制列宽度

<?php

// px
$grid->column('long_text')->width('300px');
// 百分比
$grid->column('long_text')->width('15%');

固定列 (fixColumns)

通过 fixColumns 方法可以给表格设置固定列,第一个参数表示固定从头开始的前三列,第二个参数表示固定从后往前数的两列,(第二个参数可不传,默认为-1)

<?php

$grid->fixColumns(2, -2);

效果

列的使用和扩展 - 图1

获取行序号 (index)

序号从 0 开始计算

<?php

// 在 display 回调中使用
$grid->column('序号')->display(function () {
    return $this->_index + 1;
});


// 在行操作 action 中使用
$grid->actions(function ($actions) {
    $index = $this->_index;

    ...
});

设置td标签HTML属性 (setAttributes)

<?php

$grid->column('email')->setAttributes(['name' => '...'])

设置表格头HTML属性 (setHeaderAttributes)

设标题的html属性

<?php

// 修改颜色
$grid->column('name')->setHeaderAttributes(['style' => 'color:#5b69bc']);

设置列选择器 (字段显示或隐藏 showColumnSelector)

此功能默认不启用

<?php

// 开启字段选择器功能
$grid->showColumnSelector();

// 设置默认隐藏字段
$grid->hideColumns(['field1', ...]);

列的使用和扩展 - 图2

存储驱动 (持久化)

在配置文件config/admin.php可以配置存储列选择器状态的方式,支持的存储方式如下

  • Dcat\Admin\Grid\ColumnSelector\SessionStore 列选择器状态数据保存在session中,仅在登陆状态中有效
  • Dcat\Admin\Grid\ColumnSelector\CacheStore 列选择器状态数据保存在Laravel Cache缓存系统中,最长可保存300天,并可以通过admin.grid.column_selector.store_params.driver可以配置缓存驱动,默认为file
<?php

    'grid' => [

        ...

        'column_selector' => [
            'store' => Dcat\Admin\Grid\ColumnSelector\SessionStore::class,
            'store_params' => [
                'driver' => 'file',
            ],
        ],
    ],

设置列提示信息 (help)

Grid\Column::help参数:

  • $help string 提示内容
  • $style string 提示窗背景颜色,支持greenblueredpurple
  • $placement string 提示窗位置,支持topleftrightbottom

列的使用和扩展 - 图3

<?php

$grid->column('id')->help('提示信息');

设置列搜索 (filter)

通过Grid\Column::filter方法可以给列设置一个过滤器,可以很方便的根据这一列进行数据表格过滤操作,具体使用方法请参考列过滤器

列的使用和扩展 - 图4

扩展列功能

通过Grid\Column::macro方法可以扩展列方法。

app/Admin/bootstrap.php 中添加以下代码

<?php

use Dcat\Admin\Grid;

// $value 是当前字段的值
// $p1、$p2 是自定义参数
Grid\Column::macro('myHeader', function ($value, $p1, $p2 = null) {
    // MyHeader 需要实现 Illuminate\Contracts\Support\Renderable 接口
    // 当然这里也可以直接传字符串
    return $this->addHeader(new MyHeader($this, $p1, $p2));
});

MyHeader

<?php

use Dcat\Admin\Grid\Column;
use Illuminate\Contracts\Support\Renderable;

class MyHeader implements Renderable
{
    public function __construct(Column $column, $p1, $p2)
    {
        ...
    }

    public function render()
    {
        ...
    }
}

使用

<?php

$grid->column('user')->myHeader($p1, $p2);

$grid->column('first_name')->myHeader($p1);