>[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 | | 标题 | | option | array | Y | | 选择项 | 示例代码: ``` $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 | | 标题 | | placeholder | string | N | | 输入提示 | 示例代码: ``` $assign['buildTable']['filter']['items'] = [ [ 'type' => 'select', 'title' => '城市', 'name' => 'city', 'option' => [ 1 => '北京', 2 => '上海', 3 => '重庆', ], ], // 更多表单项..... ]; ``` ![](https://box.kancloud.cn/7182618971055b7207e1c0a9b750cdbc_2364x740.jpg) ## 筛选表单项 - 日期时间选择器(year、moth、date、time、datetime) | 参数 | 类型 | 必须 | 默认 | 说明 | --- | --- | --- | --- | --- | | type | String | Y | | 可选值:year(年)、moth(月)、date(日期)、time(时间)、datetime(日期+时间) | | name |String | Y | | 字段名称 | | title | String | Y | | 标题 | | format | String | N | | 自定义格式,详见下面的自定义格式 | ## 日期时间选择器 - 自定义格式 | 格式符 | 说明 | --- | --- | | 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)