## setSearchArea(搜索參數, 提交地址)
從V1.1.0版本開始,支持設置搜索區域,目前支持以下類型:
| 類型 | 標識符 |
| --- | --- |
| 單行文本框 | text |
| 下拉框 | select |
| 日期時間 | datetime |
用法如下:
~~~
->setSearchArea([
['text', 'username', '昵稱'],
])
~~~
不管是哪種類型,前面五個參數的含義是相同的
第一個參數:類型
第二個參數:字段名
第三個參數:標簽名
第四個參數:匹配方式(默認為“eq”,也可以是“neq”,“=”,“<>”等等)
第五個參數:默認值
第六個參數:額外參數(不同類型,用途不同)
### text(單行文本框)
一般用法
~~~
->setSearchArea([
['text', 'username', '昵稱'],
])
~~~
默認的匹配方式是“eq”,也就是等于,如果需要修改為不等于,可以明確指定
~~~
->setSearchArea([
['text', 'username', '昵稱', 'neq'],
])
~~~
改為模糊匹配
~~~
->setSearchArea([
['text', 'username', '昵稱', 'like'],
])
~~~
也可以設置默認值
~~~
->setSearchArea([
['text', 'username', '昵稱', '', 'ming'],
])
~~~
>[danger] 需要注意的是,這里的默認值僅用于默認顯示在單行文本框內,并不會默認按這個值搜索,需要自行在查詢數據時帶入默認值。
~~~
$map = $this->getMap();
if (!isset($map['username'])) {
$map['username'] = 'ming';
}
$data = User::where($map)->paginate();
return ZBuilder::make('table')
->addColumns([ // 批量添加列
['id', 'ID'],
['username', '用戶名'],
['nickname', '昵稱'],
['email', '郵箱'],
['mobile', '手機號'],
['create_time', '創建時間', 'datetime'],
['status', '狀態', 'switch'],
['right_button', '操作', 'btn']
])
->setSearchArea([
['text', 'username', '昵稱', '', 'ming'],
])
->fetch();
~~~
默認每個組件的寬度是占1/4,也可以自己設置
~~~
->setSearchArea([
['text:6', 'username', '昵稱', 'neq'],
])
~~~
如果數據是使用【視圖查詢】獲得的,有時候需要指定表名
~~~
->setSearchArea([
['text', 'admin_user.username', '昵稱'],
])
~~~
### select(下拉框)
**一般用法**,第六個參數傳入一個一維數組。
~~~
->setSearchArea([
['select', 'username', '用戶名', '', '', ['test' => 'test', 'ming' => 'ming']],
])
~~~
**設置默認值**
~~~
->setSearchArea([
['select', 'username', '用戶名', '', 'test', ['test' => 'test', 'ming' => 'ming']],
])
~~~
**設置寬度**
~~~
->setSearchArea([
['select:4', 'username', '用戶名', '', '', ['test' => 'test', 'ming' => 'ming']],
])
~~~
**指定表名**
~~~
->setSearchArea([
['select', 'admin_user.username', '用戶名', '', '', ['test' => 'test', 'ming' => 'ming']],
])
~~~
### daterange(日期范圍)
**一般用法**
~~~
->setSearchArea([
['daterange', 'create_time', '創建時間'],
])
~~~
**修改匹配方式**
默認匹配方式為在某個時間段內,也可以設置為不在某個時間段內
~~~
->setSearchArea([
['daterange', 'create_time', '創建時間', 'not between'],
])
~~~
**設置默認值**
~~~
->setSearchArea([
['daterange', 'create_time', '創建時間', '', '2017-11-10 - 2017-11-15'],
])
~~~
>[danger] 這里的默認值僅作為顯示,默認查詢數據時,需要自行添加默認值查詢,具體請參考上的“text”類型用法。
**設置時間格式**
~~~
->setSearchArea([
['daterange', 'create_time', '創建時間', '', '', ['format' => 'YYYY-MM-DD HH:mm']],
])
~~~
更多格式請參考 [momentjs](http://momentjs.com/docs/#/displaying/)
**設置可選日期范圍**
~~~
->setSearchArea([
['daterange', 'create_time', '創建時間', '', '', ['min-date' => '2017-11-01', 'max-date' => '2017-12-30']],
])
~~~
表示用戶只能在2017-11-01至2017-12-30之間選擇。
**開啟時間選擇**
默認情況下,時間選擇是沒有開啟的,如果需要開啟時間選擇,可以設置為
~~~
->setSearchArea([
['daterange', 'create_time', '創建時間', '', '', ['time-picker' => 'true']],
])
~~~
開啟時間選擇后,默認不是24小時制,如果需要設置為24小時制,設置為
~~~
->setSearchArea([
['daterange', 'create_time', '創建時間', '', '', ['time-picker' => 'true', 'time-picker24-hour' => 'true']],
])
~~~
如果需要精確到秒,可以設置為
~~~
->setSearchArea([
['daterange', 'create_time', '創建時間', '', '', ['time-picker' => 'true', 'time-picker24-hour' => 'true', 'time-picker-seconds' => 'true']],
])
~~~
更多參數請參考[http://www.daterangepicker.com/#options](http://www.daterangepicker.com/#options)
>[info] 比如要設置參數“maxDate”,那么填寫的時候要填寫為“max-date”這種方式。
- 序言
- 環境搭建
- 下載及安裝
- 目錄結構
- 快速構建器(ZBuilder)
- 表單(form)
- 設置頁面標題
- 設置頁提示信息
- 設置表單提交地址
- 隱藏按鈕
- 添加按鈕
- 設置按鈕標題
- 添加表單項
- 復選
- 單選
- 日期
- 時間
- 開關
- 標簽
- 數組
- 分組
- 范圍
- 按鈕
- 數字框
- 密碼框
- 取色器
- 下拉菜單
- 普通聯動
- 快速聯動
- 拖拽排序
- 靜態文本
- 格式文本
- 日期時間
- 日期范圍
- 圖片裁剪
- 百度地圖
- 單文件上傳
- 多文件上傳
- 單圖片上傳
- 多圖片上傳
- 隱藏表單項
- 圖標選擇器
- 單行文本框
- 多行文本框
- 百度編輯器
- CKEditor編輯器
- wang編輯器
- markdown編輯器
- summernote編輯器
- 圖片展示(1.1.0+)
- 單文件展示(1.1.0+)
- 多文件展示(1.1.0+)
- 下拉菜單Ajax(1.3.3+)
- 復雜表格(1.4.3+)
- 數據表格(1.4.3+)
- 分組下拉菜單(1.4.3+)
- 表格選取(1.4.3+)
- 穿梭框(1.4.3+)
- 添加表單項通用方法
- 直接設置表單項
- 表單布局
- 設置Tab按鈕列表
- 設置表單數據
- 引入js文件
- 引入css文件
- 設置額外JS代碼
- 設置額外CSS樣式
- 設置額外HTML代碼
- 是否ajax方式提交
- 設置模版路徑
- 設置觸發器
- 設置表單提交確認框
- 自定義表單項(1.0.6+)
- 設置表單提交方式(1.0.6+)
- 模板變量賦值(1.0.7+)
- 設置頁面空表單項提示(1.0.7+)
- 自定義擴展表單圖標(1.2.0+)
- 設置表單令牌(1.3.1+)
- 新窗口打開返回的url(1.4.4+)
- 表格(table)
- 設置頁面標題
- 設置頁面提示信息
- 添加一列
- 字段類型
- switch
- status
- yesno
- text.edit
- textarea.edit
- password
- url
- tel
- number
- icon
- byte
- date
- time
- datetime
- date.edit
- time.edit
- datetime.edit
- picture
- pictures
- select
- callback
- link
- text
- img_url
- files(1.1.1+)
- popover(1.4.4+)
- 添加多列
- 添加數量索引
- 添加快捷編輯的驗證器
- 設置表格數據
- 隱藏第一列多選框
- 添加表頭排序
- 添加表頭篩選
- 添加表頭篩選條件
- 添加時間段篩選
- 添加一個右側按鈕
- 添加多個右側按鈕
- 添加一個頂部按鈕
- 添加多個頂部按鈕
- 自動添加按鈕
- 自動編輯按鈕
- 替換右側按鈕
- 設置搜索參數
- 設置數據庫表名
- 設置插件名稱
- 設置表格主鍵
- 設置Tab按鈕列表
- 設置分頁
- 去除分頁
- 引入js文件
- 引入css文件
- 設置額外JS代碼
- 設置額外CSS樣式
- 設置額外HTML代碼
- 設置額外HTML代碼-模板文件(1.4.0+)
- 設置模版路徑
- 添加行class名
- 添加頂部下拉篩選
- 設置頁面空數據提示(1.0.7+)
- 模板變量賦值(1.0.7+)
- 設置使用原始數據字段(1.0.8+)
- 設置搜索區域(1.1.0+)
- 設置表格高度(1.3.0+)
- 固定左列(1.3.0+)
- 固定右列(1.3.0+)
- 設置列寬(1.3.0+)
- 設置隱藏列(1.3.0+)
- 側欄(aside)
- 添加區塊
- 設置Tab按鈕列表
- 追加Tab按鈕列表
- 設置當前tab
- 設置單個tab內容
- 設置多個tab內容
- 追加tab內容
- 覆蓋側欄
- 模塊開發
- 創建模塊信息文件
- 安裝模塊
- 模塊配置
- 控制器
- 創建菜單節點
- 第一個控制器
- 模塊參數配置頁面
- 方法參考
- 數據授權(1.3.2+)
- 插件開發
- 插件入口文件
- 插件基本信息
- 管理界面的字段信息
- 新增或編輯的字段信息
- 插件鉤子
- 觸發器
- 原數據庫表前綴
- 插件配置信息
- 安裝和卸載Sql文件
- 控制器
- 模型
- 驗證器
- 視圖
- 方法參考
- 實踐教程
- 變量參考
- 函數參考
- 安全相關
- 常見問題
- 其他雜項
- 更新日志
- 升級指導
- 貢獻名單
- 關于文檔