## setSearch('字段名' [, '提示', '提交地址', '提交按鈕文字']) | 版本 | 新增功能 | | --- | --- | | 1.0.7 | 表格搜素框添加搜索按鈕，可配置顯示不顯示 | 默認情況下，數據表格是沒有搜索功能的，如果需要搜索功能，可以設置搜索參數。 格式為：`['字段名' => '字段提示']` ~~~ // 使用ZBuilder快速創建數據表格 return ZBuilder::make('table') ->setSearch(['id' => 'ID', 'username' => '用戶名', 'email' => '郵箱']) // 設置搜索參數 ->fetch(); // 渲染頁面 ~~~ 數據表格右上角會出現搜索框  搜索功能要配合`$this->getMap();`方法，比如 ~~~ // 獲取篩選 $map = $this->getMap(); // 讀取用戶數據 $data_list = Db::name('admin_user')->where($map)->order($order)->select(); // 使用ZBuilder構建數據表格 return ZBuilder::make('table') ->setSearch(['id' => 'ID', 'username' => '用戶名', 'email' => '郵箱']) // 設置搜索參數 ->addColumn('id', 'ID') ->addColumn('username', '用戶名') ->addColumn('nickname', '昵稱') ->addColumn('email', '郵箱') ->addColumn('mobile', '手機號') ->addColumn('create_time', '創建時間') ->setRowList($data_list) // 設置表格數據 ->fetch(); ~~~ >[info] 此處的搜索是模糊搜索 ### 字段名 如果數據是從視圖查詢得到的，也就是要搜索的字段在其他表，則必須寫明表名。 ~~~ ->setSearch(['id' => 'ID', 'admin_user.username' => '用戶名', 'email' => '郵箱']) // 設置搜索參數 ~~~ 以上表示用戶名字段在`admin_user`表。 >[info]### 從1.0.3版本開始，支持字符串參數 比如建立以下表格 ~~~ // 使用ZBuilder構建數據表格 return ZBuilder::make('table') ->setSearch(['id' => 'ID', 'username' => '用戶名', 'email' => '郵箱']) // 設置搜索參數 ->addColumn('id', 'ID') ->addColumn('username', '用戶名') ->addColumn('nickname', '昵稱') ->addColumn('email', '郵箱') ->addColumn('mobile', '手機號') ->addColumn('create_time', '創建時間') ->setRowList($data_list) // 設置表格數據 ->fetch(); ~~~ 我們可以看到，setSearch方法內的參數不僅要寫字段名，還要寫字段提示，這樣比較繁瑣。如果你要搜索的字段已經用addColumn或者addColumns方法定義過，那么可以這么改。 ~~~ // 使用ZBuilder構建數據表格 return ZBuilder::make('table') ->setSearch('id,username,email') // 直接寫字段名 ->addColumn('id', 'ID') ->addColumn('username', '用戶名') ->addColumn('nickname', '昵稱') ->addColumn('email', '郵箱') ->addColumn('mobile', '手機號') ->addColumn('create_time', '創建時間') ->setRowList($data_list) // 設置表格數據 ->fetch(); ~~~ 也支持帶表名的字段，比如數據是用Db::view()方法查詢的情況。 ~~~ // 使用ZBuilder構建數據表格 return ZBuilder::make('table') ->setSearch('admin_user.username,admin_user.email') // 支持帶表名 ->addColumn('id', 'ID') ->addColumn('username', '用戶名') ->addColumn('nickname', '昵稱') ->addColumn('email', '郵箱') ->addColumn('mobile', '手機號') ->addColumn('create_time', '創建時間') ->setRowList($data_list) // 設置表格數據 ->fetch(); ~~~ 如果你想重命名某個搜索字段名，可以原來的數組方式。 ~~~ // 使用ZBuilder構建數據表格 return ZBuilder::make('table') ->setSearch(['id', 'username', 'email' => '郵箱地址']) // 重命名email字段的提示 ->addColumn('id', 'ID') ->addColumn('username', '用戶名') ->addColumn('nickname', '昵稱') ->addColumn('email', '郵箱') ->addColumn('mobile', '手機號') ->addColumn('create_time', '創建時間') ->setRowList($data_list) // 設置表格數據 ->fetch(); ~~~ ### 提示 也可以自定義提示 ~~~ // 使用ZBuilder快速創建數據表格 return ZBuilder::make('table') ->setSearch(['id' => 'ID', 'username' => '用戶名', 'email' => '郵箱'], '請輸入關鍵字') // 設置搜索參數 ->fetch(); // 渲染頁面 ~~~ ### 提交地址 默認的搜索提交地址是當前url，如果有需要，可以另外指定。 ~~~ // 使用ZBuilder快速創建數據表格 return ZBuilder::make('table') ->setSearch(['id' => 'ID', 'username' => '用戶名', 'email' => '郵箱'], '請輸入關鍵字', url('index')) // 設置搜索參數 ->fetch(); // 渲染頁面 ~~~ ### 提交按鈕文字 >[info] 從1.0.7版本開始，可設置搜索框的提交按鈕，默認為不顯示按鈕，如果需要顯示按鈕，可以設置為`true`或者具體的提示文字。 ~~~ // 使用ZBuilder快速創建數據表格 return ZBuilder::make('table') ->setSearch(['id' => 'ID', 'username' => '用戶名', 'email' => '郵箱'], '', '', true) // 設置搜索參數 ->fetch(); // 渲染頁面 ~~~  設置為true，則按鈕的默認文字為“搜索”，如果需要修改文字，可以直接設置文字。 ~~~ // 使用ZBuilder快速創建數據表格 return ZBuilder::make('table') ->setSearch(['id' => 'ID', 'username' => '用戶名', 'email' => '郵箱'], '', '', '立即搜索') // 設置搜索參數 ->fetch(); // 渲染頁面 ~~~  除此之外，如果需要將所有頁面的搜索框一次性配置上按鈕，可修改文件： ~~~ \application\extra\zbuilder.php ~~~ 中的`search_button`參數，false表示不顯示按鈕。 >[danger] 注意：配置文件的優先級低于setSearch()方法