php 5 549.76,添加表头筛选 · DolphinPHP1.5.0完全开发手册-基于ThinkPHP5.1.41LTS的快速开发框架

## addFilter('字段名' [, '选项', '默认选项', '筛选方式'])

表头筛选是属于精确筛选。

| 版本 | 改进 |

| --- | --- |

| 1.0.4 | 新增“筛选方式”参数，支持单选 |

| 1.0.6 | 新增addFilterList()方法，支持自定义筛选列表，非读取数据库 |

~~~

// 读取用户数据

$data_list = Db::name('admin_user')->select();

// 使用ZBuilder构建数据表格

return ZBuilder::make('table')

->addOrder('id,username') // 添加排序

->addFilter('id,username') // 添加筛选

->addColumn('id', 'ID')

->addColumn('username', '用户名')

->addColumn('nickname', '昵称')

->addColumn('email', '邮箱')

->addColumn('mobile', '手机号')

->addColumn('create_time', '创建时间')

->setRowList($data_list) // 设置表格数据

->fetch();

~~~

添加好筛选字段后，还需要在查询数据之前获取筛选的数据，使用`$this->getMap()`即可。

~~~

// 获取排序

$order = $this->getOrder();

// 获取筛选

$map = $this->getMap();

// 读取用户数据

$data_list = Db::name('admin_user')->where($map)->order($order)->select();

// 使用ZBuilder构建数据表格

return ZBuilder::make('table')

->addOrder('id,username') // 添加排序

->addFilter('id,username') // 添加筛选

->addColumn('id', 'ID')

->addColumn('username', '用户名')

->addColumn('nickname', '昵称')

->addColumn('email', '邮箱')

->addColumn('mobile', '手机号')

->addColumn('create_time', '创建时间')

->setRowList($data_list) // 设置表格数据

->fetch();

~~~

![](https://box.kancloud.cn/a854b937c2690040971de9445f8d469a_1468x202.png)

点击字段筛选，弹出对话框，可以选择要显示的数据，也可以动态搜索。

![](https://box.kancloud.cn/65e425b4fe3468250124971209a6a3de_591x581.png)

>[danger]注意，点击筛选后，会默认在当前表查询结果，如果当前表没有数据，则查询结果为空。

### 使用数组方式

除了可以以字符串的形式填写要筛选的字段外，还可以用数组的形式。

~~~

// 使用ZBuilder构建数据表格

return ZBuilder::make('table')

->addFilter(['id','username']) // 添加筛选

->fetch();

~~~

### 指定其他表的字段

同样的，如果要筛选的字段不在当前表，需指定表名，比如数据是用[视图查询](http://www.kancloud.cn/manual/thinkphp5/156576)获得的。

~~~

// 使用ZBuilder构建数据表格

return ZBuilder::make('table')

->addFilter('admin_action.username,nickname') // 添加筛选

->fetch();

~~~

也可以用数组的方式写，格式为`'字段名' => '表名'`

~~~

// 使用ZBuilder构建数据表格

return ZBuilder::make('table')

->addFilter(['title' => 'admin_action', 'username']) // 添加筛选

->fetch();

~~~

或者

~~~

// 使用ZBuilder构建数据表格

return ZBuilder::make('table')

->addFilter(['admin_action.title', 'username']) // 添加筛选

->fetch();

~~~

如果设置的字段别名，也可以指定其他表，并且指定其他字段名，格式为：`字段别名 => '表名.字段名'`

~~~

// 使用ZBuilder构建数据表格

return ZBuilder::make('table')

->addFilter(['module_title' => 'admin_module.title']) // 添加筛选

->fetch();

~~~

其中`module_title`是字段别名。

>[info] 具体使用请参考系统的“日志管理”源码。

还有一种情况，比如某个字段只是代号，真正需要显示的数据在另外一张表或自己构造的数据。

比如系统的“配置管理”页面，假设列是这么定义的.

~~~

// 使用ZBuilder构建数据表格

return ZBuilder::make('table')

->addColumns([ // 批量添加数据列

['name', '名称', 'text.edit'],

['title', '标题', 'text.edit'],

['type', '类型'],

['status', '状态', 'switch'],

['sort', '排序', 'text.edit'],

['right_button', '操作', 'btn']

])

->fetch();

~~~

显示的出来的数据大致是这样的

![](https://box.kancloud.cn/a320babda1081de87d5ea6d207665f61_1279x476.png)

我们希望用中文来代替这些值，这里我们设置type类型为select(下拉编辑)，并设置下拉选项数据config('form_item_type')

~~~

// 使用ZBuilder构建数据表格

return ZBuilder::make('table')

->addColumns([ // 批量添加数据列

['name', '名称', 'text.edit'],

['title', '标题', 'text.edit'],

['type', '类型', 'select', config('form_item_type')],

['status', '状态', 'switch'],

['sort', '排序', 'text.edit'],

['right_button', '操作', 'btn']

])

->fetch();

~~~

>[info] config('form_item_type')是一个一维数组，取出来的数据是这样的

~~~

array(

"text" => "单行文本"

"textarea" => "多行文本"

"static" => "静态文本"

"password" => "密码"

"checkbox" => "复选框"

"radio" => "单选按钮"

"date" => "日期"

"datetime" => "日期+时间"

"hidden" => "隐藏"

"switch" => "开关"

"array" => "数组"

"select" => "下拉框"

"linkage" => "普通联动下拉框"

"linkages" => "快速联动下拉框"

"image" => "单张图片"

"images" => "多张图片"

"file" => "单个文件"

"files" => "多个文件"

"ueditor" => "UEditor 编辑器"

"wangeditor" => "wangEditor 编辑器"

"editormd" => "markdown 编辑器"

"icon" => "字体图标"

"tags" => "标签"

"number" => "数字"

)

~~~

这样设置之后的最终结果是

![](https://box.kancloud.cn/1cd480e8a02db10e08e0c3feb66f6e42_1239x504.png)

我们对type字段添加筛选功能

~~~

// 使用ZBuilder构建数据表格

return ZBuilder::make('table')

->addColumns([ // 批量添加数据列

['name', '名称', 'text.edit'],

['title', '标题', 'text.edit'],

['type', '类型', 'select', config('form_item_type')],

['status', '状态', 'switch'],

['sort', '排序', 'text.edit'],

['right_button', '操作', 'btn']

])

->addFilter('type') // 添加标题字段筛选

->fetch();

~~~

点击筛选图标之后，会发现结果是这样

![](https://box.kancloud.cn/745d6699585ec1c956d328a4a989abfc_546x560.png)

因为数据表里面存储的就是这样的数据，如果我们希望这些数据也能转换显示，那该怎么办呢？

只要将对应的数据，也就是上面`config('form_item_type')`的一维数组放在第二个参数即可，系统会对应显示。

~~~

// 使用ZBuilder构建数据表格

return ZBuilder::make('table')

->addColumns([ // 批量添加数据列

['name', '名称', 'text.edit'],

['title', '标题', 'text.edit'],

['type', '类型', 'select', config('form_item_type')],

['status', '状态', 'switch'],

['sort', '排序', 'text.edit'],

['right_button', '操作', 'btn']

])

->addFilter('type', config('form_item_type')) // 添加标题字段筛选

->fetch();

~~~

最终显示结果

![](https://box.kancloud.cn/18a797f1cdfc7a8c5db9fac62313de2a_536x562.png)

>[danger]注意，这种写法只能一个一个写，下面的写法是错误的

~~~

->addFilter('type,title', config('form_item_type')) // 错误写法

~~~

### 默认选项

如果需要默认设置筛选，可以使用第三个参数。

~~~

// 使用ZBuilder构建数据表格

return ZBuilder::make('table')

->addColumns([ // 批量添加数据列

['name', '名称', 'text.edit'],

['title', '标题', 'text.edit'],

['type', '类型', 'select', config('form_item_type')],

['status', '状态', 'switch'],

['sort', '排序', 'text.edit'],

['right_button', '操作', 'btn']

])

->addFilter('name', [], ['name' => 'web_site_icp,web_site_keyword']) // 添加标题字段筛选

->fetch();

~~~

上面表示初始状态下，字段筛选默认点亮字段名为name的字段，并且选中值为web_site_icp和web_site_keyword的选项。

![](https://box.kancloud.cn/f5673a503bf2a3b28ef17a7cfd379d80_1094x599.png)

**也可以指定多个字段**

~~~

// 使用ZBuilder构建数据表格

return ZBuilder::make('table')

->addColumns([ // 批量添加数据列

['name', '名称', 'text.edit'],

['title', '标题', 'text.edit'],

['type', '类型', 'select', config('form_item_type')],

['status', '状态', 'switch'],

['sort', '排序', 'text.edit'],

['right_button', '操作', 'btn']

])

->addFilter('title', [], ['name' => 'web_site_icp,web_site_keyword', 'title' => ['备案信息']]) // 添加标题字段筛选

->fetch();

~~~

**指定当前表的其他字段名**

~~~

// 使用ZBuilder构建数据表格

return ZBuilder::make('table')

->addColumns([ // 批量添加数据列

['name', '名称', 'text.edit'],

['title', '标题', 'text.edit'],

['type', '类型', 'select', config('form_item_type')],

['status', '状态', 'switch'],

['sort', '排序', 'text.edit'],

['right_button', '操作', 'btn']

])

->addFilter('type', config('form_item_type'), ['title|title2' => ['备案信息']]) // 添加标题字段筛选

->fetch();

~~~

以上表示点亮字段为title的列，但是查询数据实际查询的不是title字段，而是title2字段。

**指定其他表的其他字段名**

~~~

// 使用ZBuilder构建数据表格

return ZBuilder::make('table')

->addColumns([ // 批量添加数据列

['name', '名称', 'text.edit'],

['title', '标题', 'text.edit'],

['type', '类型', 'select', config('form_item_type')],

['status', '状态', 'switch'],

['sort', '排序', 'text.edit'],

['right_button', '操作', 'btn']

])

->addFilter('type', config('form_item_type'), ['title|admin_article.title' => ['备案信息']]) // 添加标题字段筛选

->fetch();

~~~

以上表示点亮字段为title的列，但是查询数据实际查询的是admin_article表的title字段。

>[danger] 注意，设置**默认选项**只是页面上点亮指定的字段列，并选中指定的字段值，实际查询的时候，需要自己添加查询条件。比如默认选择name字段的web_site_icp和web_site_keyword，那么在查询时需将条件先设定好。

~~~

// 设置查询条件

$map = $this->getMap();

if (empty($map)) {

// 默认情况下，查询name字段的值为web_site_icp和web_site_keyword

$map['name'] = ['in', 'web_site_icp,web_site_keyword'];

}

// 查询数据

$data_list = ConfigModel::where($map)->paginate();

// 使用ZBuilder构建数据表格

return ZBuilder::make('table')

->addColumns([ // 批量添加数据列

['name', '名称', 'text.edit'],

['title', '标题', 'text.edit'],

['type', '类型', 'select', config('form_item_type')],

['status', '状态', 'switch'],

['sort', '排序', 'text.edit'],

['right_button', '操作', 'btn']

])

->addFilter('type', config('form_item_type'), ['name' => 'web_site_icp,web_site_keyword']) // 添加标题字段筛选

->fetch();

~~~

### 筛选方式

从1.0.4版本开始，字段筛选支持单选方式，只要添加第四个参数为“`radio`”即可

~~~

// 使用ZBuilder构建数据表格

return ZBuilder::make('table')

->addColumns([ // 批量添加数据列

['name', '名称', 'text.edit'],

['title', '标题', 'text.edit'],

['type', '类型', 'select', config('form_item_type')],

['status', '状态', 'switch'],

['sort', '排序', 'text.edit'],

['right_button', '操作', 'btn']

])

->addFilter('type', [], [], 'radio') // 添加标题字段筛选

->fetch();

~~~

## addFilterList('字段名', '需要显示的列表' [, '默认选项', '筛选方式'])

>[info] ## 此方法1.0.6版本开始支持。

用法和addFilter类似，第二个参数填写一个一维数组即可，数组的key为要查询的内容，value为显示的内容。

~~~

// 使用ZBuilder构建数据表格

return ZBuilder::make('table')

->addColumns([ // 批量添加数据列

['name', '名称', 'text.edit'],

['title', '标题', 'text.edit'],

['type', '类型', 'select', config('form_item_type')],

['status', '状态', 'switch'],

['sort', '排序', 'text.edit'],

['right_button', '操作', 'btn']

])

->addFilterList('status', ['关闭', '开启'])

->fetch();

~~~

![](https://box.kancloud.cn/467d33edb5e241f4bab81070b1b22783_554x549.png)

### 默认值

~~~

// 使用ZBuilder构建数据表格

return ZBuilder::make('table')

->addColumns([ // 批量添加数据列

['name', '名称', 'text.edit'],

['title', '标题', 'text.edit'],

['type', '类型', 'select', config('form_item_type')],

['status', '状态', 'switch'],

['sort', '排序', 'text.edit'],

['right_button', '操作', 'btn']

])

->addFilterList('status', ['关闭', '开启'], '0')

->fetch();

~~~

![](https://box.kancloud.cn/8f1a46c0159f2c73c35e1596e7231485_535x551.png)

如果多个默认值，可以使用逗号隔开，或者使用数组形式。

~~~

->addFilterList('status', ['关闭', '开启'], '0,1')

或者

->addFilterList('status', ['关闭', '开启'], [0,1])

~~~

### 筛选方式

默认为多选，可以改为单选。

~~~

// 使用ZBuilder构建数据表格

return ZBuilder::make('table')

->addColumns([ // 批量添加数据列

['name', '名称', 'text.edit'],

['title', '标题', 'text.edit'],

['type', '类型', 'select', config('form_item_type')],

['status', '状态', 'switch'],

['sort', '排序', 'text.edit'],

['right_button', '操作', 'btn']

])

->addFilterList('status', ['关闭', '开启'], '', 'radio')

->fetch();

~~~

![](https://box.kancloud.cn/72523d2aad76ba832bcae1838193ce5e_529x546.png)

php 5 549.76,添加表头筛选 · DolphinPHP1.5.0完全开发手册-基于ThinkPHP5.1.41LTS的快速开发框架 · 看云...