>[danger] 友情提示:构建器目前只支持HisiPHP Pro版本([我要升级](https://www.hisiphp.com/authorize.html))
## 表格筛选(filter)
后台数据管理99%都离不开各种筛选需求,HisiPHP也提供了一种非常简单快速的筛选渲染方式,同样是通过一个简单的数组方式完成,鉴于表格页面排版问题,目前只支持以下几种表单项。
## 筛选表单请求地址(action)
>[info]非必须,默认为当前页面URL
示例代码:
```
$assign['buildTable']['filter']['action'] = url('index');
```
## 筛选表单显示与隐藏(display)
>[info]非必须,默认隐藏筛选表单,需要点击搜索图标来切换显示/隐藏。
示例代码:
```
$assign['buildTable']['filter']['display'] = true;
```
## 筛选表单项 - 文本框(text)
| 参数 | 类型 | 必须 | 默认 | 说明
| --- | --- | --- | --- | --- |
| type | string | Y | | 固定值:text |
| name | string | Y | | 字段名称 |
| title | string | Y | | 标题 |
| placeholder | string | N | | 输入提示 |
示例代码:
```
$assign['buildTable']['filter']['items'] = [
[
'type' => 'text',
'title' => '客户名',
'name' => 'text',
'placeholder' => '请输入客户名',
],
// 更多表单项.....
];
```
![](https://box.kancloud.cn/720d2743e851175106d9c274c929b4b9_2364x786.jpg)
## 筛选表单项 - 下拉框(select)
| 参数 | 类型 | 必须 | 默认 | 说明
| --- | --- | --- | --- | --- |
| type | string | Y | | 固定值:select |
| name | string | Y | | 字段名称 |
| title | string | Y | | 标题 |
| option | array | Y | | 选择项 |
示例代码:
```
$assign['buildTable']['filter']['items'] = [
[
'type' => 'select',
'title' => '城市',
'name' => 'city',
'option' => [
1 => '北京',
2 => '上海',
3 => '重庆',
],
],
// 更多表单项.....
];
```
![](https://box.kancloud.cn/7182618971055b7207e1c0a9b750cdbc_2364x740.jpg)
## 筛选表单项 - 日期时间选择器(year、month、date、time、datetime)
| 参数 | 类型 | 必须 | 默认 | 说明
| --- | --- | --- | --- | --- |
| type | String | Y | | 可选值:year(年)、month(月)、date(日期)、time(时间)、datetime(日期+时间) |
| name |String | Y | | 字段名称 |
| title | String | Y | | 标题 |
| format | String | N | | 自定义格式,详见下面的自定义格式 |
| options | Array | N | | 基础参数选项,[点此浏览详细参数配置](https://www.layui.com/doc/modules/laydate.html#options) |
## 日期时间选择器 - 自定义格式
| 格式符 | 说明
| --- | --- |
| yyyy | 年份,至少四位数。如果不足四位,则前面补零 |
| y | 年份,不限制位数,即不管年份多少位,前面均不补零 |
| MM | 月份,至少两位数。如果不足两位,则前面补零 |
| M | 月份,允许一位数 |
| dd | 日期,至少两位数。如果不足两位,则前面补零 |
| d | 日期,允许一位数 |
| HH | 小时,至少两位数。如果不足两位,则前面补零 |
| H | 小时,允许一位数 |
| mm | 分钟,至少两位数。如果不足两位,则前面补零 |
| m | 分钟,允许一位数 |
| ss | 秒数,至少两位数。如果不足两位,则前面补零 |
| s | 秒数,允许一位数 |
示例代码:
```
$assign['buildTable']['filter']['items'] = [
[
'type' => 'date',
'title' => '日期',
'name' => 'date',
],
// 更多表单项.....
];
```
![](https://box.kancloud.cn/4eeeb7a405dd7d6885e16abc566a093a_2390x892.jpg)
- 序言
- 环境配置
- 下载及安装
- 目录结构
- 系统配置
- 多语言
- 命令行(pro版)
- 自动生成模块或插件(build)
- 生成模块
- 生成插件
- 自动生成增删改查(crud)
- 第一步:创建数据表
- 第二步:使用crud指令生成
- 自动生成类库文件(make)
- 生成控制器文件(make:controller)
- 生成模型文件(make:model)
- 生成逻辑文件(make:logic)
- 生成服务文件(make:service)
- 生成验证器文件(make:validate)
- 构建器(pro版)
- 表单构建器(form)
- 表单属性设置
- 添加表单项
- 文本框(text)
- 隐藏域(hidden)
- 密码框(password)
- 文本域(textarea)
- 单文件(file)
- 多文件(files)
- 单图(image)
- 多图(images)
- 开关(switch)
- 单选(radio)
- 多选(checkbox)
- 下拉框(select)
- 标签(tag)
- 日期时间(datetime)
- 颜色选择器(color)
- 富文本编辑器(editor)
- 滑块(slider)
- 评分(rate)
- 穿梭框(transfer)
- 进度条(progress)
- 树形(tree)
- 联动(linkage)
- 自定义html(html)
- 分隔线(line)
- 文字(txt)
- 下拉框增强版(select+)
- 数据表格(table)
- 添加表单分组(group)
- 栅格布局(grid)
- 触发器(trigger)
- 通用上传方法
- 表格构建器(table)
- 表格基础配置
- 添加表头工具栏
- 添加表格筛选
- 页面提示(pageTips)
- 引入 JS 文件
- 引入 CSS 文件
- 渲染额外 JS 代码
- 渲染额外 CSS 代码
- 模块开发
- 1.生成模块
- 2.创建菜单
- 3.创建控制器
- 后台通用方法
- 插件开发
- 1.新建插件
- 2.插件配置
- 3.插件控制器
- 4.插件模板
- 5.插件钩子
- 模板替换变量
- 公共函数库
- 后台通用JS方法
- 常见问题
- 官方模块
- CMS内容管理模块
- 目录结构
- 模板标签
- API接口
- 栏目页/内容页
- 小程序发布
- 官方插件
- 第三方登录
- excel插件
- 万能采集
- 采集规则
- 采集内容