示例代码中的 [, $label] ，表示这个参数可以省略，比如 $table->column('title'[, $label]) 则表示 $label 参数为可选参数。

Encore\Admin\Table 类用于生成基于数据模型的表格，下面以 movies 表为例：

movies
    id          - integer
    title       - string
    director    - integer
    describe    - string
    rate        - tinyint
    released    - enum(0, 1)
    release_at  - timestamp
    created_at  - timestamp
    updated_at  - timestamp

对应的数据模型为 App\Models\Movie ，用下面的代码生成表 movies 的数据表格：

use App\Models\Movie; use Encore\Admin\Table; $table = new Table(new Movie); // 第一列显示id字段，并将这一列设置为可排序列 $table->column('id', 'ID')->sortable(); // 第二列显示title字段，由于title字段名和Table对象的title方法冲突，所以用Table的column()方法代替 $table->column('title'); // 第三列显示director字段，通过display($callback)方法设置这一列的显示内容为users表中对应的用户名 $table->column('director')->display(function($userId) { return User::find($userId)->name; // 第四列显示为describe字段 $table->column('describe'); // 第五列显示为rate字段 $table->column('rate'); // 第六列显示released字段，通过display($callback)方法来格式化显示输出 $table->column('released', '上映?')->display(function ($released) { return $released ? '是' : '否'; // 下面为三个时间字段的列显示 $table->column('release_at'); $table->column('created_at'); $table->column('updated_at'); // filter($callback)方法用来设置表格的简单搜索框 $table->filter(function ($filter) { // 设置created_at字段的范围查询 $filter->between('created_at', 'Created Time')->datetime();

模型表格有以下的一些基础方法

// 效果和上面一样 $table->column('username', '用户名'); // 显示JSON内嵌字段 $table->column('profile->mobile', '手机号'); // 添加多列 $table->columns('email', 'username' ...);

添加数据查询条件

默认情况下，表格的数据没有任何查询条件，可以使用 model() 方法来给当前表格数据添加查询条件：

$table->model()->where('id', '>', 100);
$table->model()->whereIn('id', [1, 2, 3]);
$table->model()->whereBetween('votes', [1, 100]);
$table->model()->whereColumn('updated_at', '>', 'created_at');
$table->model()->orderBy('id', 'desc');
$table->model()后面可以直接调用Eloquent的查询方法来给表格数据添加查询条件，更多查询方法参考文档.
设置每页显示行数
// 默认为每页20条
$table->paginate(15);
修改显示输出
$table->column('text')->display(function($text) {
    return str_limit($text, 30, '...');
$table->column('name')->display(function ($name) {
    return "<span class='label'>$name</span>";
$table->column('email')->display(function ($email) {
    return "mailto:$email";
// 添加不存在的字段
$table->column('column_not_in_table')->display(function () {
    return 'blablabla....';
display()方法接收的匿名函数绑定了当前行的数据对象，可以在里面调用当前行的其它字段数据
$table->column('first_name');
$table->column('last_name');
// 不存的字段列
$table->column('full_name')->display(function () {
    return $this->first_name.' '.$this->last_name;
不要在display回调函数中进行数据库查询、外部api调用等耗时操作，因为表格中每一行都将会执行display回调函数，这将会产生性能问题
禁用创建按钮
$table->disableCreateButton();
禁用分页条
$table->disablePagination();
禁用查询过滤器
$table->disableFilter();
禁用导出数据按钮
$table->disableExport();
禁用行选择checkbox
$table->disableRowSelector();
禁用行操作列
$table->disableActions();
禁用行选择器
$table->disableColumnSelector();
设置默认隐藏列
$table->hideColumns('name', 'title', 'desc');
设置分页选择器选项
$table->perPages([10, 20, 30, 40, 50]);
模态框打开创建和编辑表单
$table->modalForm();
users表和profiles表通过profiles.user_id字段生成一对一关联
    id      - integer 
    name    - string
    email   - string
profiles
    id      - integer 
    user_id - integer 
    age     - string
    gender  - string
对应的数据模分别为:
class User extends Model
    public function profile()
        return $this->hasOne(Profile::class);
class Profile extends Model
    public function user()
        return $this->belongsTo(User::class);
通过下面的代码可以关联在一个table里面:
$table = new Table(new User);
$table->column('id', 'ID')->sortable();
$table->column('name');
$table->column('email');
$table->column('profile.age');
$table->column('profile.gender');
$table->profile()->age();
$table->profile()->gender();
posts表和comments表通过comments.post_id字段生成一对多关联
posts
    id      - integer 
    title   - string
    content - text
comments
    id      - integer 
    post_id - integer 
    content - string
对应的数据模分别为:
class Post extends Model
    public function comments()
        return $this->hasMany(Comment::class);
class Comment extends Model
    public function post()
        return $this->belongsTo(Post::class);
通过下面的代码可以让两个模型在table里面互相关联:
$table = new Table(new Post);
$table->column('id', 'id')->sortable();
$table->column('title');
$table->column('content');
$table->column('comments', '评论数')->display(function ($comments) {
    $count = count($comments);
    return "<span class='label label-warning'>{$count}</span>";
return $table;
$table = new Table(new Comment);
$table->column('id');
$table->column('post.title');
$table->column('content');
return $table;
users和roles表通过中间表role_users产生多对多关系
users
    id       - integer 
    username - string
    password - string
    name     - string 
roles
    id      - integer 
    name    - string
    slug    - string
role_users
    role_id - integer 
    user_id - integer 
对应的数据模分别为:
class User extends Model
    public function roles()
        return $this->belongsToMany(Role::class);
class Role extends Model
    public function users()
        return $this->belongsToMany(User::class);
通过下面的代码可以让两个模型在table里面互相关联:
$table = new Table(new User);
$table->column('id', 'ID')->sortable();
$table->column('username');
$table->column('name');
$table->column('roles')->display(function ($roles) {
    $roles = array_map(function ($role) {
        return "<span class='label label-success'>{$role['name']}</span>";
    }, $roles);
    return join('&nbsp;', $roles);