配置列表字段,展示到表格(table)的每一行的每一列(td)中; 不同类型的值,需要配置不同的字段;

#project\app\admin\controller\Category.php

namespace app\admin\controller;

use easyadmin\app\columns\lists\ListText;
use easyadmin\app\columns\lists\ListSwitch;
use easyadmin\app\columns\lists\ListSelect;
use easyadmin\app\columns\lists\ListImage;
use easyadmin\app\columns\lists\ListDateTime;
use easyadmin\app\libs\ListField;

class Category extends \easyadmin\controller\Admin
{
    protected function configListField(ListField $list)
    {
        $list
            //文本字段
            ->addField('field', '字段名称', ListText::class,[
                //options 选项
            ])

            //开关字段
            ->addField('field', '字段名称', ListSwitch::class,[[
                //options 选项
            ])

            //下来选择字段
            ->addField('field', '字段名称', ListSelect::class,[[
                //options 选项
            ])

            //图片字段
            ->addField('field', '字段名称', ListImage::class,[[
                //options 选项
            ])

            //日期时间字段
            ->addField('field', '字段名称', ListDateTime::class,[[
                //options 选项
            ]);
    }

}
        

1. 1. 不同的字段,只是在 options 选项上的不同;
2. 2. configListField方法表示配置列表;详见列表页面配置

展示为一行文本

文本字段的options 适用于所有其他字段

'format' => function ($val,$row) {
    // $val 是当前列的值
    // $row 是当前行的数组
    // 格式化后返回界面
    return $val;
}
        

#project\app\admin\controller\Category.php

namespace app\admin\controller;

use easyadmin\app\columns\lists\ListText;
use easyadmin\app\libs\ListField;

class Category extends \easyadmin\controller\Admin
{

    protected function configListField(ListField $list)
    {
        $list
            //文本字段
            ->addField('field', '字段名称', ListText::class,[
                //options 选项
                'class'=>'test_class_name',
                'attr'=>'disabled=disabled checked=checked data-id=345',
                'default'=>'顶级分类',
                'template'=>'test:test' //需要放在当前的模块的 views 目录中
            ])
    }

}
        

展示为时间格式的文本

'format' => function ($val,$row) {
    // $val 是当前列的值
    // $row 是当前行的数组
    // 格式化后返回界面
    return $val;
}
        

#project\app\admin\controller\Category.php

namespace app\admin\controller;

use easyadmin\app\columns\lists\ListDateTime;
use easyadmin\app\libs\ListField;

class Category extends \easyadmin\controller\Admin
{

    protected function configListField(ListField $list)
    {
        $list
            //日期时间字段
            ->addField('field', '字段名称', ListDateTime::class,[
                //options 选项 , text 文本字段 的属性也都是可用的

                // 用 date 函数格式化,  传入格式化参数, 这是默认的
                'format'=>'Y-m-d H:i:s',

                //自定义函数处理
                'format' => function ($val) {
                    return date('Y/m/d H:i:s', $val);
                },

                //关闭格式化 (默认)
                'format' => null,

            ])
    }

}
        

展示为一张图片,点击可放大

'format' => function ($val,$row) {
    // $val 是当前列的值
    // $row 是当前行的数组
    // 格式化后返回界面
    return $val;
}
        

#project\app\admin\controller\Category.php

namespace app\admin\controller;

use easyadmin\app\columns\lists\ListImage;
use easyadmin\app\libs\ListField;

class Category extends \easyadmin\controller\Admin
{

    protected function configListField(ListField $list)
    {
        $list
            //图片字段
            ->addField('field', '字段名称', ListImage::class,[ ])
    }

}
        

从定义好的一个数组中,选择一个值进行展示; 常用于状态展示; 例如: 是否开启 ; 是否删除 等 多个状态

'format' => function ($val,$row) {
    // $val 是当前列的值
    // $row 是当前行的数组
    // 格式化后返回界面
    return $val;
}
        

#project\app\admin\controller\Category.php

namespace app\admin\controller;

use easyadmin\app\columns\lists\ListImage;
use easyadmin\app\libs\ListField;

class Category extends \easyadmin\controller\Admin
{

    protected function configListField(ListField $list)
    {
        $list
            //选择字段
             ->addField('name', '分类名称', ListSelect::class,[
                'options'=>[
                    ['key' => 'php', 'text' => '后端语言', 'color' => '#5FB878'],
                    ['key' => 'javascript', 'text' => '前端语言', 'color' => 'cyan'],
                ]
            ])
    }

}
        

一个 switch 开关 , 可直接 ajax 控制状态

'format' => function ($val,$row) {
    // $val 是当前列的值
    // $row 是当前行的数组
    // 格式化后返回界面
    return $val;
}
        

#project\app\admin\controller\Category.php

namespace app\admin\controller;

use easyadmin\app\columns\lists\ListSwitch;
use easyadmin\app\libs\ListField;

class Category extends \easyadmin\controller\Admin
{

    protected function configListField(ListField $list)
    {
        $list
            //选择字段
             ->addField('name', '分类名称', ListSwitch::class,[
                'success' => 1, //正确,开启的值  默认 1
                'error' => 0, //错误,关闭的值  默认 0
                'text' => 'YES|NO',//开关文字 , 竖线分隔, 前面是开的显示文本,后面是关的显示文本  默认   YES|NO
                'url' => 'enable',//请求URL , 会使用 thinkphp6 的 url() 函数 生成url  默认 enable
                'params' => ['test'=>1],//请求参数的额外参数.  默认  []
            ])
    }

}