# 表格组件

# 简介

通过 QuarkAdmin 的 Table 组件您可以创建一个漂亮、简洁、功能齐全的列表页。每个 Table 组件都可以对应一个「模型」用来与该表交互。你可以通过模型查询数据表中的数据，以及对数据的增、删、改、查。

# 效果预览

table

# 快速入门

QuarkAdmin 的各组件初始化相对比较统一，用法如下：

<?php

namespace App\Http\Controllers\Admin;

use App\Models\Link;
use Quark;
use QuarkCMS\QuarkAdmin\Http\Controllers\Controller;

class LinkController extends Controller
{
    protected function table()
    {
        $table = Quark::table(new Link)->title($this->title);
        ...
        return $table;
    }
}

在所有Table组件使用的文档里，示例控制器都应继承QuarkCMS\QuarkAdmin\Http\Controllers\Controller类，$table 是指 Quark::table() 得到的实例，这里就不在每个页面单独写了。

# 下面我们正式开启Table组件的使用旅程：

第一步、首先我们先创建一张数据表，下面以友情链接（links）表为例：

CREATE TABLE `links` (
  `id` int(10) unsigned NOT NULL AUTO_INCREMENT,
  `sort` int(11) DEFAULT '0',
  `title` varchar(255) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '标题',
  `url` varchar(255) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '访问地址',
  `cover_id` longtext COLLATE utf8mb4_unicode_ci COMMENT '封面图',
  `status` tinyint(1) NOT NULL DEFAULT '1',
  `created_at` timestamp NULL DEFAULT NULL,
  `updated_at` timestamp NULL DEFAULT NULL,
  PRIMARY KEY (`id`)
) ENGINE=InnoDB AUTO_INCREMENT=4 DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;

第二步、为对应的 links 数据表创建模型 App\Models\Link 示例代码 (opens new window)

第三步、用下面的代码生成友情链接表links的列表页示例代码 (opens new window)：

use App\Models\Link;
use Quark;

$table = Quark::table(new Link)->title($this->title);
$table->column('id','ID');
$table->column('title','标题')->editLink();
$table->column('sort','排序')->sorter()->editable()->width('80');
$table->column('url','链接');
$table->column('cover_id','图片')->image();
$table->column('created_at','添加时间');
$table->column('status','状态')->editable('switch',[
    'on'  => ['value' => 1, 'text' => '正常'],
    'off' => ['value' => 0, 'text' => '禁用']
])->width(100);

$table->model()->orderBy('sort', 'desc')->paginate(request('pageSize',10));

配置好相应的路由、菜单后，点开我们新添加的菜单就可以看到如下页面：

table

# 基本使用

# 初始化表格

你可以通过Quark门面快速实例化一个Table对象，如有必要你可以传入一个Model实例，来给表格组件绑定一个模型（注意：绑定模型并不是必须的，这取决于你是否使用了Table组件提供的增、删、改、查等行为操作）

Quark::table(new Link);

# 表格标题

可以通过title()方法来设置表格的标题

$table->title('友情链接');

# 配置工具栏

table

通过options()方法来控制表格的工具栏展示，设为 false 时不显示，工具栏默认设置为[ 'fullScreen' => true, 'reload' => true ,'setting' => true ]

// 不显示工具栏
$table->options(false);

// 不显示全屏
$table->options(['fullScreen' => false, 'reload' => true ,'setting' => true]);

# 设置Layout属性

表格元素的 table-layout 属性，设为 fixed 表示内容不会影响列的布局，参数：'-' | 'auto' | 'fixed'；

当列开启自动缩略时，需要设置 tableLayout 属性为 'fixed';

$table->tableLayout('fixed');

# 列值为空时默认显示

通过columnEmptyText()方法来控制表格列值为空时的默认展示，默认设置为'-'

$table->columnEmptyText('空');

# 设置表格滚动

通过scroll()方法来设置表格滚动固定

// 可水平滚动
$table->scroll(['x'=>240]);

// 可垂直滚动
$table->scroll(['y'=>1200]);

// 垂直水平均可滚动
$table->scroll(['x'=>240,'y'=>1200]);

# 设置表格显示斑马线样式

通过striped()方法来设置表格显示斑马线样式，即每一行的颜色不一样

$table->striped();

# 添加列

通过column($attribute, $title)方法来设置表格列的展示、字段绑定，参数$attribute为绑定的字段，$title为列的标题，更多关于列的操作可以查看下一节列的显示：

$table->column('title', '标题');

# 表格数据

如果表格没有绑定模型的话，你可以通过datasource()方法来给表格填充数据

$data = [
  [
    'id' => 1,
    'name'=>'John Brown',
    'age'=> 32,
    'address'=> 'New York No. 1 Lake Park',
    'status'=>1,
  ],
  [
    'id' => 2,
    'name' => 'John Brown',
    'age'=> 32,
    'address' => 'New York No. 1 Lake Park',
    'status'=> 1,
  ]
]

$table->datasource($data);

# 列的显示

通过column()方法来设置列后，我们可以通过column()方法返回的实例，来控制列的不同展示：

# 列宽

通过width()方法来设置列的宽度

$table->column('sex','性别')->width(100);

# 内容渲染html标签

通过isHtml()方法来渲染html标签内容，特别注意：如果以html标签方式渲染内容，将有可能存在XSS攻击的风险！

$table->column('sex','性别')->isHtml();

# 内容样式

通过style()方法来设置内容的样式

$table->column('sex','性别')->style(['color'=>'green']);

# 对齐方式

可以用align()方法来设置列的对齐方式，可选 'left' | 'right' | 'center'，默认为：'left'

$table->column('sex','性别')->align('center');

# 固定列

通过fixed()方法来设置列是否固定（IE 下无效），可选 true (等效于 left) left right

$table->column('sex','性别')->fixed();

# 自动缩略

通过ellipsis()方法来控制列内容超出宽度后是否展示缩略，注意当设置自动缩略时需要设置 tableLayout 属性为 'fixed' table

$table->column('title','标题')->ellipsis();

# 支持复制

通过copyable()方法来控制列内容是否支持复制

$table->column('title','标题')->copyable();

# 列提示信息

通过tooltip()方法来设置提示一些信息

table

$table->column('url','链接')->tooltip('这是一个提示列');

# 重置列的数据显示

通过display()方法，我们可以重置列的数据显示

$table->column('sex','性别')->display(function ($sex) {
    if($sex == 1) {
        return '男';
    } else {
        return '女';
    }
});

// 支持渲染html标签
$table->column('sex','性别')->isHtml()->display(function ($sex) {
    if($sex == 1) {
        return '<span style="color:red">男</span>';
    } else {
        return '<span style="color:green">女</span>';
    }
});

// 当你自定义一个表中不存在的字段时，闭包函数会传入本行的数组
$table->column('full_name','全名')->display(function ($row) {
    return $row['first_name'].$row['last_name'];
});

# 内容映射

通过using()方法，我们可以根据每行数据列的值，来显示using()方法的参数中数组下标对应的值

$table->column('sex','性别')->using([1 => '男',2 => '女']);

# 链接

通过link($href, $target)方法来进行跳转操作；此方法有两个参数，$href为跳转的地址，$target为跳转方式可选'_blank' | '_self' | '_parent' | '_top'，默认为'_self'；$href链接可以为前台地址，也可以为后台地址，我们可以借助frontend_url($api ='',$isEngineUrl = true)，backend_url($api ='',$withToken = false)两个助手函数分别生成前台、后台跳转链接

// 前台地址跳转
$table->column('title','标题')->link(frontend_url('admin/article/index'),'_blank');

// 替换参数的前台地址跳转
$table->column('title','标题')->link(frontend_url('admin/article/edit&id={id}'));

// 后台地址跳转，例如文件下载
$table->column('title','标题')->link(backend_url('admin/file/download',true),'_blank');

// 替换参数的后台地址跳转
$table->column('title','标题')->link(backend_url('admin/file/download&id={id}',true),'_blank');

# 编辑链接

通过editLink($target)方法来跳转到编辑页面；此方法有一个参数，$target为跳转方式可选'_blank' | '_self' | '_parent' | '_top'，默认为'_self'

// 跳转到编辑页面
$table->column('title','标题')->editLink();

// 跳转到编辑页面，并在新窗口打开
$table->column('title','标题')->editLink('_blank');

# 二维码

通过下面的调用，会在这一列的每一行文字前面出现一个二维码icon，点击它可以展开一个小弹框，里面会显示这一列值的二维码编码图形

$table->column('link','二维码')->qrcode(); //qrcode($content=null,$width=150,$height=150)

# 显示图片

默认picture字段保存的是pictures表里面的id。

$table->column('picture','图片')->image();

//设置服务器和宽高
$table->column('picture')->image('http://xxx.com', 100, 100);

# 可筛选列

这个功能在表头给相应的列设置一个过滤器，可以更方便的根据这一列进行数据表格过滤操作：

$table->column('status', '状态')->filter([
    0 => '未知',
    1 => '已下单',
    2 => '已付款',
    3 => '已取消',
]);

# 可排序列

可排序列：

$table->column('status', '状态')->sorter();

# 可编辑列

数据表格有一系列方法，来帮助你列表里面直接对数据进行编辑；用editable方法，可以让你在表格中点击数据，在显示的对话框里面编辑保存数据，使用方法如下：

# 文本框控件（text）

$table->column('title', '标题')->editable();

# 下拉框控件（select）

第二个参数是select选择的选项

$table->column('title', '标题')->editable('select', [
    1 => 'option1',
    2 => 'option2',
    3 => 'option3'
]);

# 开关框架（switch）

快速将列变成开关组件，使用方法如下：

$table->column('status','状态')->editable('switch',[
    'on'  => ['value' => 1, 'text' => '正常'],
    'off' => ['value' => 0, 'text' => '禁用']
])->width(100);

# 行为列

用actions闭包函数，你可以自定义行操作；此方法传入两个参数，$action为Action对象的实例，关于Action的使用方法，你可以在下面表格行为一节中查看,$row为当前行的数组

# 快速入门

通过下面的代码你可以快速创建一个操作列：

$table->column('actions','操作')->width(260)->actions(function($action,$row) {

    // 根据不同的条件定义不同的A标签形式行为
    if($row['status'] === 1) {
        $action->a('禁用')
        ->withPopconfirm('确认要禁用数据吗？')
        ->model()
        ->where('id','{id}')
        ->update(['status'=>0]);
    } else {
        $action->a('启用')
        ->withPopconfirm('确认要启用数据吗？')
        ->model()
        ->where('id','{id}')
        ->update(['status'=>1]);
    }

    // 跳转默认编辑页面
    $action->a('编辑')->editLink();

    // 删除数据
    $action->a('删除')
    ->withPopconfirm('确认要删除吗？')
    ->model()
    ->where('id','{id}')
    ->delete();

    // 下拉菜单形式的行为
    $action->dropdown('更多')->overlay(function($action) use($row) {

        // 跳转详情页
        $action->item('详情')->showLink();

        // 弹框表单
        $action->item('充值')->modalForm(backend_url('api/admin/user/recharge?id='.$row['id']));
    });
});

# 表格行为

$action 为 Action 对象的实例，下面我们具体介绍一下表格行为的使用：

# 行为样式

现在表格行为暂时只提供 A标签、按钮、下拉菜单 形式的样式

# A标签样式的行为

$action->a('禁用');

# 按钮样式的行为

$action->button('编辑');

# 下拉菜单形式的行为

$action->dropdown('更多');

# A标签行为

# 跳转链接

WARNING

特别注意：当您设置了跳转链接，A标签将自动进行链接跳转，而不是执行行为操作！


// 跳转一个网址
$action->a('跳转一个连接')
->href('http://www.ixiaoquan.com')
->target('_blank');

// 新页面打开一个网址
$action->a('跳转一个连接')->link('http://www.ixiaoquan.com','_blank');

// 应用内跳转，并传递参数
$action->a('编辑')->link(frontend_url('admin/article/edit&id={id}'));

// 跳转到Table组件页面，并传递搜索参数，特别注意：需要对应的Table组件页面定义了搜索栏表单
$action->a('跳转')->link(frontend_url('admin/article/index&search[id]=1'));

// 新页面打开一个接口网址，并带上token
$action->a('下载文件')->link(backend_url('admin/file/download',true),'_blank');

# 跳转到新增页面

// 打开新增页面
$action->a('跳转一个连接')->createLink();

// 新页面打开新增页面
$action->a('跳转一个连接')->createLink('_blank');

# 跳转到编辑页面

// 打开编辑页面
$action->a('跳转一个连接')->editLink();

// 新页面打开编辑页面
$action->a('跳转一个连接')->editLink('_blank');

# 跳转到详情页面

// 打开详情页面
$action->a('跳转一个连接')->showLink();

// 新页面打开详情页面
$action->a('跳转一个连接')->showLink('_blank');

# 带Pop确认

$action->a('删除')->withPopconfirm('确认要删除吗？');

# 带弹框确认

$action->a('删除')->withConfirm('确认要删除吗？','删除后数据将无法恢复，请谨慎操作！');

# 打开弹框表单

注意：如果您要打开弹窗表单，需要在相应的接口返回表单渲染数据示例代码 (opens new window)

$action->a('编辑')->modalForm(backend_url('api/admin/config/edit?id=1'));

# 打开抽屉表单

注意：如果您要打开抽屉表单，需要在相应的接口返回表单渲染数据示例代码 (opens new window)

$action->a('编辑')->drawerForm(backend_url('api/admin/menu/edit?id=1'));

# 行为执行接口

在没有设置链接跳转的情况下，点击事件将自动触发对接口的访问，您可以通过api方法自定义访问接口，在默认的情况下访问当前控制器的'api/admin/.../action'接口

WARNING

特别注意：当您设置了跳转链接，将无法触发对接口的访问请求！


// 当链接被点击时，会触发对接口的get访问请求
$action->a('删除')->api('api/admin/menu/delete?id=1');

# 行为操作数据

您可以通过model方法，对数据进行管理，当前台触发对'api/admin/.../action'接口访问的时候，会对model方法进行回调，支持Laravel 提供的Eloquent ORM 来操作各种数据库数据

WARNING

特别注意：行操作、批量操作、工具栏操作的行为在参数替换的使用方法上会有些许不同，一定要注意！避免不必要的风险！


// 删除全部数据
$action->a('删除')
->model()
->delete();

// 在回调的时候对id进行参数替换，执行带有where条件的操作
$action->a('禁用')
->model()
->where('id','{id}')
->update(['status'=>0]);

# 按钮行为

# 按钮行为样式

按钮行为提供了一些样式配置

// 将按钮宽度调整为其父宽度
$action->button('这是一个按钮')->block();

// 设置危险按钮
$action->button('这是一个按钮')->danger();

// 按钮失效状态
$action->button('这是一个按钮')->disabled();

// 幽灵属性，使按钮背景透明
$action->button('这是一个按钮')->ghost();

// 设置按钮图标
$action->button('这是一个按钮')->icon('plus-circle');

// 设置按钮形状，可选值为 circle、 round 或者不设
$action->button('这是一个按钮')->shape('circle');

// 设置按钮类型，primary | ghost | dashed | link | text | default
$action->button('这是一个按钮')->type('primary');

// 设置按钮类型为primary并且为危险按钮
$action->button('这是一个按钮')->type('primary',true);

// 设置按钮大小，large | middle | small | default
$action->button('这是一个按钮')->size('small');

# 按钮行为其他用法

按钮行为的跳转链接、跳转到新增页面、跳转到编辑页面、跳转到详情页面、带Pop确认、带弹框确认、打开弹框表单、打开抽屉表单、行为执行接口、行为操作数据等用法与A标签的一样，可以点击相应章节查看，下面是一个简单的示例：

// 跳转一个网址
$action->button('跳转一个连接')
->href('http://www.ixiaoquan.com')
->target('_blank');

# 下拉菜单行为

# 快速入门

$action->dropdown('更多')->overlay(function($action) {
    $action->item('禁用用户')
    ->withConfirm('确认要禁用吗？','禁用后管理员将无法登陆后台，请谨慎操作！')
    ->model()
    ->whereIn('id','{ids}')
    ->update(['status'=>0]);

    $action->item('启用用户')
    ->withConfirm('确认要启用吗？','启用后管理员将可以正常登录后台！')
    ->model()
    ->whereIn('id','{ids}')
    ->update(['status'=>1]);
});

# 下拉框显示模式

下拉框显示模式,a|button

// A标签样式的下拉菜单
$action->dropdown('更多')->mode('a');

// 按钮样式的下拉菜单
$action->dropdown('更多')->mode('button');

# 下拉框箭头

下拉框箭头是否显示

$action->dropdown('更多')->arrow();

# 菜单是否禁用

$action->dropdown('更多')->disabled();

# 下拉框的菜单

// 下拉菜单形式的行为
$action->dropdown('更多')->overlay(function($action) {
    $action->item('禁用')
    ->withConfirm('确认要禁用吗？','禁用后将无法使用，请谨慎操作！')
    ->model()
    ->whereIn('id','{ids}')
    ->update(['status'=>0]);

    $action->item('启用')
    ->withConfirm('确认要启用吗？','启用后可以正常使用！')
    ->model()
    ->whereIn('id','{ids}')
    ->update(['status'=>1]);
});

# 菜单弹出位置

菜单弹出位置：bottomLeft bottomCenter bottomRight topLeft topCenter topRight

$action->dropdown('更多')->placement('bottomLeft');

# 触发下拉的行为

触发下拉的行为, 移动端不支持 hover

$action->dropdown('更多')->trigger('hover');

# 下拉框菜单行为

下拉框的菜单项触发的行为与A标签的一样，具体用法请查看相应的章节：跳转链接、跳转到新增页面、跳转到编辑页面、跳转到详情页面、带Pop确认、带弹框确认、打开弹框表单、打开抽屉表单、行为执行接口、行为操作数据

# 数据查询

如果在实例化表格对象时绑定了模型，你可以使用 Laravel 提供的Eloquent ORM 来操作各种数据库数据。

# 快速入门

默认情况下，表格的数据没有任何查询条件，可以使用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()->take(100);

$table->model()后面可以直接调用Eloquent的查询方法来给表格数据添加查询条件，更多查询方法参考Laravel文档.

# 设置分页

// 默认为每页10条
$table->paginate(15);

// 根据传参，动态设置每页数量
$table->paginate(request('pageSize',10));

# 关联模型

一对一，users表和profiles表通过profiles.user_id字段生成一对一关联

users
    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('profile.gender');

# 搜索栏

Table组件提供了一系列的方法来实现对表格搜索栏的渲染

# 效果预览

table-search

# 快速入门

通过search()闭包函数我们可以快速的构建表格页面的查询表单项，下面是一个简单的例子：

$table->search(function($search) {

    $search->where('title', '搜索内容',function ($query) {
        $query->where('title', 'like', "%{input}%");
    })->placeholder('搜索内容');

    $search->equal('status', '所选状态')
    ->select([''=>'全部',1=>'正常',2=>'已禁用'])
    ->placeholder('选择状态')
    ->width(110);

    $search->between('created_at', '发布时间')
    ->datetime();
});

# 展开搜索栏

通过点击筛选按钮展开显示，默认是不展开的，用下面的方式可以让它默认展开

// 在`$table`返回的search实例上操作
$table->search(function($search) {
    // ...
})->collapsed(true);

# Label 标签对齐方式

Label 标签的文本对齐方式，'left' | 'right'

// 在`$table`返回的search实例上操作
$table->search(function($search) {
    // ...
})->labelAlign('left');

# 设置字段组件的尺寸

设置字段组件的尺寸,'small' | 'middle' | 'large'

// 在`$table`返回的search实例上操作
$table->search(function($search) {
    // ...
})->size('small');

# 显示表单控件数量

自定义折叠状态下默认显示的表单控件数量，没有设置或小于 0，则显示一行控件; 数量大于等于控件数量则隐藏展开按钮

// 在`$table`返回的search实例上操作
$table->search(function($search) {
    // ...
})->defaultColsNumber(2);

# Label 宽度

表单 Label 宽度,number | 'auto'

// 在`$table`返回的search实例上操作
$table->search(function($search) {
    // ...
})->labelWidth(200);

# 表单项宽度

表单项宽度,number[0 - 24]

// 在`$table`返回的search实例上操作
$table->search(function($search) {
    // ...
})->span(0);

# 是否有分割线

每一行是否有分割线

// 在`$table`返回的search实例上操作
$table->search(function($search) {
    // ...
})->split();

# 范围查询

可以把你最常用的查询定义为一个查询范围，它将会出现在筛选按钮的下拉菜单中，下面是几个例子：

$search->scope('anywords', '范围查询',function ($scope) {
    $scope->option('option1', '正常')->where('status', 1);
    $scope->option('option2', '禁用')->where('status', 0);
    $scope->option('male', '男性')->where('gender', 'm');

    // 多条件查询
    $scope->option('new', '最近修改')
        ->whereDate('created_at', date('Y-m-d'))
        ->orWhere('updated_at', date('Y-m-d'));

    // 关联关系查询
    $scope->option('address')->whereHas('profile', function ($query) {
        $query->whereNotNull('address');
    });

    $scope->option('trashed', '被软删除的数据')->onlyTrashed();

})->placeholder('请选择查询内容');

TIP

scope方法可以链式调用任何eloquent查询条件

# 查询类型

目前支持的过滤类型有下面这些：

# 等于条件（equal）

SQL语句：... WHERE column = "$input"

$search->equal('column', $label);

# 不等于条件（not equal）

SQL语句：... WHERE column != "$input"

$search->notEqual('column', $label);

# 模糊查询（like）

SQL语句：... WHERE column LIKE "%$input%"

$search->like('column', $label);

# 大于条件（gt）

SQL语句：... WHERE column > "$input"

$search->gt('column', $label);

# 小于条件（lt）

SQL语句：... WHERE column < "$input"

$search->lt('column', $label);

# 区间查询（between）

SQL语句：... WHERE column BETWEEN "$start" AND "$end"

$search->between('column', $label);

// datetime类型控件
$search->between('column', $label)->datetime();

# 范围查询（in）

SQL语句：... WHERE column in (...$inputs)

// 多选下拉框类型控件
$search->in('column', $label)->multipleSelect(['key' => 'value']);

# 非范围查询（notIn）

SQL语句：... WHERE column not in (...$inputs)

// 多选下拉框类型控件
$search->notIn('column', $label)->multipleSelect(['key' => 'value']);

# 复杂查询（where）

可以用where来构建比较复杂的查询过滤

SQL语句：... WHERE title LIKE "%$input" OR content LIKE "%$input"

$search->where(function ($query) {

    $query->where('title', 'like', "%{input}%")
        ->orWhere('content', 'like', "%{input}%");

}, 'Text');

SQL语句：... WHERE rate>= 6 AND created_at= {$input}

$search->where(function ($query) {

    $query->whereRaw("`rate` >= 6 AND `created_at` = %{input}%");

}, 'Text');

关系查询，查询对应关系profile的字段：

$search->where(function ($query) {

    $query->whereHas('profile', function ($query) {
        $query->where('address', 'like', "%{input}%")->orWhere('email', 'like', "%{input}%");
    });

}, '地址或手机号');

# 控件类型

# 文本框控件（text）

表单类型默认是text input，可以设置placeholder：

$search->equal('column')->placeholder('请输入。。。');

# 下拉框控件（select）

$search->equal('column')->select(['key' => 'value'...]);

# 下拉框（select）控件联动


// 下拉框联动
$search->equal('province', '省')->select([1 => '北京', 2 => '天津', 3 => '河北省'])->load('city','admin/area/cities');

// 市
$search->equal('city', '市')->select();

# 下拉框联动的接口代码示例

public function cities(Request $request)
{
    // 获取参数
    $pid = $request->input('search');

    // 获取数据
    $options = Area::where('pid',$pid)->select('id as value','area_name as label')->get()->toArray();

    return success('获取成功','',$options);
}

# 多选下拉框控件（multipleSelect）

一般用来配合in和notIn两个需要查询数组的查询类型使用，也可以在where类型的查询中使用：

$search->in('column')->multipleSelect(['key' => 'value'...]);

# 时间选择控件（datetime）

$search->equal('column')->datetime();

# 高级控件

有时候对同一个字段要设置多中筛选方式，可以通过下面的方式实现

$search->group('rate','评分', function ($group) {
    $group->gt('大于');
    $group->lt('小于');
    $group->nlt('不小于');
    $group->ngt('不大于');
    $group->equal('等于');
});

有下面的几个方法可以调用

// 等于
$group->equal();

// 不等于
$group->notEqual();

// 大于
$group->gt();

// 小于
$group->lt();

// 大于等于
$group->nlt();

// 小于等于
$group->ngt();

// 匹配
$group->match();

// 复杂条件
$group->where();

// like查询
$group->like();

# 批量操作

用batchActions闭包函数，你可以自定义批量操作；此方法传入$action参数，$action为Action对象的实例，关于Action的使用方法，你可以在表格行为一节中查看

WARNING

特别注意：批量操作的行为在参数替换的方法上使用的是'{ids}'字符串，一定要注意！避免不必要的风险！

$table->batchActions(function($action) {
    // 跳转默认编辑页面
    $action->a('批量删除')
    ->withConfirm('确认要删除吗？','删除后数据将无法恢复，请谨慎操作！')
    ->model()
    ->whereIn('id','{ids}')
    ->delete();

    // 下拉菜单形式的行为
    $action->dropdown('更多')->overlay(function($action) {
        $action->item('禁用菜单')
        ->withConfirm('确认要禁用吗？','禁用后菜单将无法使用，请谨慎操作！')
        ->model()
        ->whereIn('id','{ids}')
        ->update(['status'=>0]);

        $action->item('启用菜单')
        ->withConfirm('确认要启用吗？','启用后菜单可以正常使用！')
        ->model()
        ->whereIn('id','{ids}')
        ->update(['status'=>1]);
    });
});

# 工具栏

目前工具栏只支持行为的配置

# 工具栏行为

用actions闭包函数，你可以自定义工具栏上的操作；此方法传入$action参数，$action为Action对象的实例，关于Action的使用方法，你可以在表格行为一节中查看

WARNING

特别注意：工具栏上的行为并不会进行任何形式的参数替换！

$table->toolBar()->actions(function($action) {
    // 跳转默认创建页面
    $action->button('创建菜单')
    ->type('primary')
    ->icon('plus-circle')
    ->drawerForm(backend_url('api/admin/menu/create'));
});

← 卡片组件表单组件 →