## 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。