## addTopButton('類型' [, '按鈕屬性', '彈窗形式']) | 版本 | 功能 | | --- | --- | | 1.0.7 | 支持自定義數據操作方式，默認為Db::name() | | 1.3.3 | 頂部彈窗按鈕支持選擇表格數據 | | 1.4.3 | 彈窗返回支持跳轉url | DolphinPHP內置了幾種常用的頂部按鈕，比如：添加、批量啟用、批量禁用、批量刪除、自定義。 | 按鈕類型 | 標識符 | | --- | --- | | 添加 | add | | 批量啟用 | enable | | 批量禁用 | disable | | 批量刪除 | delete | | 自定義 | 1.0.5版本以后，自定義按鈕類型可按需求填寫，不再限定于custom類型 | >[danger] 注意：要使用這些按鈕，需要將對應的操作添加到節點菜單，否則除管理員外，其他用戶將無權限操作。 其中，添加按鈕的操作方法需要自己實現，默認是當前控制器的add方法。 ~~~ // 讀取用戶數據 $data_list = Db::name('admin_user')->select(); // 使用ZBuilder構建數據表格 return ZBuilder::make('table') ->addColumn('id', 'ID') ->addColumn('username', '用戶名') ->addColumn('nickname', '昵稱') ->addColumn('email', '郵箱') ->addColumn('mobile', '手機號') ->addColumn('create_time', '創建時間') ->addColumn('right_button', '操作', 'btn') ->addTopButton('add') // 添加頂部按鈕 ->addTopButton('enable') // 添加頂部按鈕 ->addTopButton('disable') // 添加頂部按鈕 ->addTopButton('delete') // 添加頂部按鈕 ->setRowList($data_list) // 設置表格數據 ->fetch(); ~~~  ### 添加額外屬性 可以給按鈕添加額外的自定義屬性，比如`data-**`這種。 ~~~ ->addTopButton('add', ['data-test' => 'test']) ~~~ ### 啟用、禁用和刪除 如果是批量啟用、禁用和刪除按鈕，系統會默認去操作“`當前模塊名_當前控制器名`”的數據表，如果表名不是“`當前模塊名_當前控制器名`”，那么需要另外指定表名。 ~~~ ->addTopButton('enable', ['table' => 'admin_user']) // 啟用 ->addTopButton('disable', ['table' => 'admin_user']) // 禁用 ->addTopButton('delete', ['table' => 'admin_user']) // 刪除 ~~~ >[info]從1.0.7版本開始，啟用、禁用和刪除功能除了可以自定義表名外，還支持使用模型 **默認使用Db::name('admin_user')操作數據** ~~~ ->addTopButton('enable', ['table' => 'admin_user']) 等同于 ->addTopButton('enable', ['table' => 'admin_user', 1]) ~~~ **使用Db::table('admin_user')操作數據** ~~~ ->addTopButton('enable', ['table' => 'admin_user', 0]) ~~~ **使用指定模型`model('admin/user')`操作數據** ~~~ ->addTopButton('enable', ['table' => 'admin/user', 2]) 等同于 ->addTopButton('enable', ['table' => 'admin/user', true]) ~~~ #### 自定義啟用或禁用的字段（V1.0正式版+） 默認情況下，啟用和禁用針對的是表中的status字段，如果不是status字段，可以自定義，如： ~~~ ->addTopButton('enable', ['field' => 'check']) ~~~ 表示將check字段的值修改為1，如果是禁用，則修改為0； ### 自定義按鈕 如果內置的幾種按鈕都不滿足要求，可以自己定義按鈕。 >[info] 提示：1.0.5版以后，自定義按鈕不再限定于custom類型，只要不是默認的按鈕類型，其他均屬于自定義按鈕。 ~~~ // 授權按鈕 $btn_access = [ 'title' => '授權', 'icon' => 'fa fa-fw fa-key', 'href' => url('access') ]; // 使用ZBuilder構建數據表格 return ZBuilder::make('table') ->addTopButton('custom', $btn_access) // 添加授權按鈕 ->fetch(); 或者 // 使用ZBuilder構建數據表格 return ZBuilder::make('table') ->addTopButton('access', $btn_access) // 添加授權按鈕 ->fetch(); ~~~ ### ajax提交 這樣添加的頂部按鈕只是一個普通的帶鏈接按鈕，點擊之后會直接跳轉。如果想獲取數據表格的數據，那么需要給按鈕的css類名添加`ajax-post`。 ~~~ // 授權按鈕 $btn_access = [ 'title' => '授權', 'icon' => 'fa fa-fw fa-key', 'class' => 'btn btn-primary ajax-post', 'href' => url('access') ]; // 使用ZBuilder構建數據表格 return ZBuilder::make('table') ->addTopButton('custom', $btn_access) // 添加授權按鈕 ->fetch(); ~~~ 控制器方法可以這樣接收數據表的數據：`input('post.ids/a')`; ### 執行確認 如果提交的時候需要確認框，可以添加css類名：`confirm` ~~~ // 授權按鈕 $btn_access = [ 'title' => '授權', 'icon' => 'fa fa-fw fa-key', 'class' => 'btn btn-primary ajax-post confirm', 'href' => url('access') ]; // 使用ZBuilder構建數據表格 return ZBuilder::make('table') ->addTopButton('custom', $btn_access) // 添加授權按鈕 ->fetch(); ~~~  >[info]從1.0.3版本開始，確認框的標題支持自定義，只需添加“data-title”屬性。 ~~~ $btn_access = [ 'title' => '授權', 'icon' => 'fa fa-fw fa-key', 'class' => 'btn btn-xs btn-default ajax-get confirm', 'href' => url('access', ['uid' => '__id__']), 'data-title' => '真的要刪除嗎？' ]; ->addTopButton('custom', $btn_access) // 添加授權按鈕 ~~~  也可以顯示額外的提示文字，只需添加“data-tips”屬性。 ~~~ $btn_access = [ 'title' => '授權', 'icon' => 'fa fa-fw fa-key', 'class' => 'btn btn-xs btn-default ajax-get confirm', 'href' => url('access', ['uid' => '__id__']), 'data-title' => '真的要刪除嗎？', 'data-tips' => '刪除了就無法恢復了' ]; ->addTopButton('custom', $btn_access) // 添加授權按鈕 ~~~  也可以自定義按鈕文字 ~~~ $btn_access = [ 'title' => '授權', 'icon' => 'fa fa-fw fa-key', 'class' => 'btn btn-xs btn-default ajax-get confirm', 'href' => url('access', ['uid' => '__id__']), 'data-title' => '真的要刪除嗎？', 'data-tips' => '刪除了就無法恢復了', 'data-confirm' => '刪除吧', 'data-cancel' => '再想想' ]; ->addTopButton('custom', $btn_access) // 添加授權按鈕 ~~~  ### 普通方式提交get請求 比如導出數據的時候，我們可能只需要導出勾選的數據，但表格默認是ajax方式提交，一般導出文件下載需要get方式提交，那么可以添加css類名：`js-get` ~~~ // 授權按鈕 $btn_access = [ 'title' => '授權', 'icon' => 'fa fa-fw fa-key', 'class' => 'btn btn-primary js-get', 'href' => url('access') ]; // 使用ZBuilder構建數據表格 return ZBuilder::make('table') ->addTopButton('custom', $btn_access) // 添加授權按鈕 ->fetch(); ~~~ 選擇好數據，點擊按鈕，會以get的方式跳轉，url地址會帶上選中的值，多個值會以逗號隔開。比如： `http://www.dolphinphp.com/admin.php/cms/index/access.html?ids=1,2,3` ### 新窗口打開(1.4.3+) 默認情況下，如果只添加`js-get`css類，是在當前窗口打開鏈接，如果需要在新窗口打開，則需添加`js-blank` ~~~ // 授權按鈕 $btn_access = [ 'title' => '授權', 'icon' => 'fa fa-fw fa-key', 'class' => 'btn btn-primary js-get js-blank', 'href' => url('access') ]; // 使用ZBuilder構建數據表格 return ZBuilder::make('table') ->addTopButton('custom', $btn_access) // 添加授權按鈕 ->fetch(); ~~~ ### 彈窗形式打開 如果需要以彈出層的方式打開頁面的話，只需將第三個參數設置為`true`即可，比如： ~~~ ->addTopButton('add', [], true) ~~~ >[info] 小提示：默認情況下，在彈出框操作完成之后，彈出框不會關閉。如果需要關閉彈出框，可以回傳“_close_pop”指令。 ~~~ $this->success('保存成功', null, '_close_pop'); 或者 $this->success('保存成功', null, ['_close_pop' => 1]); ~~~ >[info] 如果希望刷新父窗口，可以回傳“_parent_reload”指令。 ~~~ $this->success('保存成功', null, '_parent_reload'); 或 $this->success('保存成功', null, ['_parent_reload' => 1]); ~~~ >[info]1.4.3后，如果返回url，則跳轉到該rul。 ~~~ $this->success('保存成功'); // 默認刷新彈窗 $this->success('保存成功', null, '_parent_reload'); // 刷新父頁面 $this->success('保存成功', 'user/index'); // 彈窗頁面跳轉到 'user/index'頁面 $this->success('保存成功', 'user/index', '_parent_reload'); // 父頁面跳轉到 'user/index'頁面 ~~~ #### 自定義彈窗 從1.0.3開始，彈窗支持自定義，比如重新定義彈窗的大小，標題等，只需要以數組形式傳入配置參數即可，更多參數，請參考：[layer手冊](http://layer.layui.com/) 比如修改彈窗的寬和高，可以這樣做。 ~~~ ->addTopButton('add', [], ['area' => ['800px', '90%']]) 或者 ->addTopButton('add', [], ['area' => '800px']) ~~~ 或者重新指定彈窗標題 ~~~ ->addTopButton('add', [], ['area' => ['800px', '90%'], 'title' => '這是新標題']) ~~~ 也可以加個圖標什么的 ~~~ ->addTopButton('add', [], ['area' => ['800px', '90%'], 'title' => '<i class="fa fa-user"></i> 這是新標題']) ~~~ 當然也可以不顯示標題 ~~~ ->addTopButton('add', [], ['area' => ['800px', '90%'], 'title' => false]) ~~~ 甚至可以定義標題樣式 ~~~ ->addTopButton('add', [], ['area' => ['800px', '90%'], 'title' => ['新標題', 'font-size:18px;']]) ~~~ 定義皮膚 ~~~ ->addTopButton('add', [], ['skin' => 'layui-layer-lan']) ~~~ 更多參數設置，請自行到[layer官網](http://layer.layui.com/)查看手冊。 >[info]從1.4.3版本開始，可以通過自定義函數來接管layer的各種回調。 ~~~ ->setExtraJs('<script>var layer_end = function() { alert("我被關閉了");}</script>') ~~~ 那么在關閉彈窗的時候，將彈出“我被關閉了”，當然，也不一定要用setExtraJs()方法，也可以用引入js文件的方法，只要定義一個全局的js函數即可。 對應的回調函數對照如下： | layer回調 | 功能 | 對應函數名 | | --- | --- |--- | | cancel | 右上角關閉按鈕觸發的回調 | layer_cancel() | | success | 層彈出后的成功回調方法 | layer_success() | | yes | 確定按鈕回調方法 | layer_yes() | | end | 層銷毀后觸發的回調 | layer_end() | | full | 最大化后觸發的回調 | layer_full() | | min | 最小化后觸發的回調 | layer_min() | | restore | 還原后觸發的回調 | layer_restore() | #### 彈窗的全局參數配置 除了可以在ZBuilder中設置彈窗參數外，從1.0.3版本開始，可以在`application\extra\zbuilder.php`文件中設置全局參數。 >[danger]注意：全局參數配置的優先級比在ZBuilder中直接設置參數低 #### 彈窗按鈕支持選擇表格數據(1.3.3+) >[info] 從1.3.3版本開始，頂部彈窗按鈕支持選擇表格數據，只需要在按鈕的class添加`js-get` ~~~ ->addTopButton('change', ['class' => 'btn btn-success js-get'], true) ~~~ 這樣設置后，勾選數據，然后點擊頂部按鈕，所勾選的id將會以get參數傳送給彈窗頁面，在彈窗頁面的控制器中，用`$ids`來接收所選的id。