添加一个顶部按钮

addTopButton('类型' [, '按钮属性', '弹窗形式'])

版本功能
1.0.7支持自定义数据操作方式，默认为Db::name()
1.3.3顶部弹窗按钮支持选择表格数据
1.4.3弹窗返回支持跳转url

DolphinPHP内置了几种常用的顶部按钮，比如：添加、批量启用、批量禁用、批量删除、自定义。

按钮类型标识符
添加add
批量启用enable
批量禁用disable
批量删除delete
自定义1.0.5版本以后，自定义按钮类型可按需求填写，不再限定于custom类型

注意：要使用这些按钮，需要将对应的操作添加到节点菜单，否则除管理员外，其他用户将无权限操作。
其中，添加按钮的操作方法需要自己实现，默认是当前控制器的add方法。

  1. // 读取用户数据
  2. $data_list = Db::name('admin_user')->select();
  4. // 使用ZBuilder构建数据表格
  5. return ZBuilder::make('table')
  6.     ->addColumn('id', 'ID')
  7.     ->addColumn('username', '用户名')
  8.     ->addColumn('nickname', '昵称')
  9.     ->addColumn('email', '邮箱')
  10.     ->addColumn('mobile', '手机号')
  11.     ->addColumn('create_time', '创建时间')
  12.     ->addColumn('right_button', '操作', 'btn')
  13.     ->addTopButton('add') // 添加顶部按钮
  14.     ->addTopButton('enable') // 添加顶部按钮
  15.     ->addTopButton('disable') // 添加顶部按钮
  16.     ->addTopButton('delete') // 添加顶部按钮
  17.     ->setRowList($data_list) // 设置表格数据
  18.     ->fetch();

添加一个顶部按钮 - 图1

添加额外属性

可以给按钮添加额外的自定义属性，比如data-**这种。

  1. ->addTopButton('add', ['data-test' => 'test'])

启用、禁用和删除

如果是批量启用、禁用和删除按钮，系统会默认去操作“当前模块名_当前控制器名”的数据表，如果表名不是“当前模块名_当前控制器名”，那么需要另外指定表名。

  1. ->addTopButton('enable', ['table' => 'admin_user']) // 启用
  2. ->addTopButton('disable', ['table' => 'admin_user']) // 禁用
  3. ->addTopButton('delete', ['table' => 'admin_user']) // 删除

从1.0.7版本开始，启用、禁用和删除功能除了可以自定义表名外，还支持使用模型

默认使用Db::name('admin_user')操作数据

  1. ->addTopButton('enable', ['table' => 'admin_user'])
  2. 等同于
  3. ->addTopButton('enable', ['table' => 'admin_user', 1])

使用Db::table('admin_user')操作数据

  1. ->addTopButton('enable', ['table' => 'admin_user', 0])

使用指定模型model('admin/user')操作数据

  1. ->addTopButton('enable', ['table' => 'admin/user', 2])
  2. 等同于
  3. ->addTopButton('enable', ['table' => 'admin/user', true])

自定义启用或禁用的字段（V1.0正式版+）

默认情况下，启用和禁用针对的是表中的status字段，如果不是status字段，可以自定义，如：

  1. ->addTopButton('enable', ['field' => 'check'])

表示将check字段的值修改为1，如果是禁用，则修改为0；

自定义按钮

如果内置的几种按钮都不满足要求，可以自己定义按钮。

提示：1.0.5版以后，自定义按钮不再限定于custom类型，只要不是默认的按钮类型，其他均属于自定义按钮。

  1. // 授权按钮
  2. $btn_access = [
  3.     'title' => '授权',
  4.     'icon'  => 'fa fa-fw fa-key',
  5.     'href'  => url('access')
  6. ];
  8. // 使用ZBuilder构建数据表格
  9. return ZBuilder::make('table')
  10.     ->addTopButton('custom', $btn_access) // 添加授权按钮
  11.     ->fetch();
  13.  或者
  15. // 使用ZBuilder构建数据表格
  16. return ZBuilder::make('table')
  17.     ->addTopButton('access', $btn_access) // 添加授权按钮
  18.     ->fetch();

ajax提交

这样添加的顶部按钮只是一个普通的带链接按钮，点击之后会直接跳转。如果想获取数据表格的数据，那么需要给按钮的css类名添加ajax-post。

  1. // 授权按钮
  2. $btn_access = [
  3.     'title' => '授权',
  4.     'icon'  => 'fa fa-fw fa-key',
  5.     'class' => 'btn btn-primary ajax-post',
  6.     'href'  => url('access')
  7. ];
  9. // 使用ZBuilder构建数据表格
  10. return ZBuilder::make('table')
  11.     ->addTopButton('custom', $btn_access) // 添加授权按钮
  12.     ->fetch();

控制器方法可以这样接收数据表的数据：input('post.ids/a');

执行确认

如果提交的时候需要确认框，可以添加css类名：confirm

  1. // 授权按钮
  2. $btn_access = [
  3.     'title' => '授权',
  4.     'icon'  => 'fa fa-fw fa-key',
  5.     'class' => 'btn btn-primary ajax-post confirm',
  6.     'href'  => url('access')
  7. ];
  9. // 使用ZBuilder构建数据表格
  10. return ZBuilder::make('table')
  11.     ->addTopButton('custom', $btn_access) // 添加授权按钮
  12.     ->fetch();

添加一个顶部按钮 - 图2

从1.0.3版本开始，确认框的标题支持自定义，只需添加“data-title”属性。

  1. $btn_access = [
  2.     'title' => '授权',
  3.     'icon'  => 'fa fa-fw fa-key',
  4.     'class' => 'btn btn-xs btn-default ajax-get confirm',
  5.     'href'  => url('access', ['uid' => '__id__']),
  6.     'data-title' => '真的要删除吗？'
  7. ];
  8. ->addTopButton('custom', $btn_access) // 添加授权按钮

添加一个顶部按钮 - 图3

也可以显示额外的提示文字，只需添加“data-tips”属性。

  1. $btn_access = [
  2.     'title' => '授权',
  3.     'icon'  => 'fa fa-fw fa-key',
  4.     'class' => 'btn btn-xs btn-default ajax-get confirm',
  5.     'href'  => url('access', ['uid' => '__id__']),
  6.     'data-title' => '真的要删除吗？',
  7.     'data-tips' => '删除了就无法恢复了'
  8. ];
  9. ->addTopButton('custom', $btn_access) // 添加授权按钮

添加一个顶部按钮 - 图4

也可以自定义按钮文字

  1. $btn_access = [
  2.     'title' => '授权',
  3.     'icon'  => 'fa fa-fw fa-key',
  4.     'class' => 'btn btn-xs btn-default ajax-get confirm',
  5.     'href'  => url('access', ['uid' => '__id__']),
  6.     'data-title' => '真的要删除吗？',
  7.     'data-tips' => '删除了就无法恢复了',
  8.     'data-confirm' => '删除吧',
  9.     'data-cancel' => '再想想'
  10. ];
  11. ->addTopButton('custom', $btn_access) // 添加授权按钮

添加一个顶部按钮 - 图5

普通方式提交get请求

比如导出数据的时候，我们可能只需要导出勾选的数据，但表格默认是ajax方式提交，一般导出文件下载需要get方式提交，那么可以添加css类名：js-get

  1. // 授权按钮
  2. $btn_access = [
  3.     'title' => '授权',
  4.     'icon'  => 'fa fa-fw fa-key',
  5.     'class' => 'btn btn-primary js-get',
  6.     'href'  => url('access')
  7. ];
  9. // 使用ZBuilder构建数据表格
  10. return ZBuilder::make('table')
  11.     ->addTopButton('custom', $btn_access) // 添加授权按钮
  12.     ->fetch();

选择好数据，点击按钮，会以get的方式跳转，url地址会带上选中的值，多个值会以逗号隔开。比如：

http://www.dolphinphp.com/admin.php/cms/index/access.html?ids=1,2,3

新窗口打开(1.4.3+)

默认情况下，如果只添加js-getcss类，是在当前窗口打开链接，如果需要在新窗口打开，则需添加js-blank

  1. // 授权按钮
  2. $btn_access = [
  3.     'title' => '授权',
  4.     'icon'  => 'fa fa-fw fa-key',
  5.     'class' => 'btn btn-primary js-get js-blank',
  6.     'href'  => url('access')
  7. ];
  9. // 使用ZBuilder构建数据表格
  10. return ZBuilder::make('table')
  11.     ->addTopButton('custom', $btn_access) // 添加授权按钮
  12.     ->fetch();

弹窗形式打开

如果需要以弹出层的方式打开页面的话，只需将第三个参数设置为true即可，比如：

  1. ->addTopButton('add', [], true)

小提示：默认情况下，在弹出框操作完成之后，弹出框不会关闭。如果需要关闭弹出框，可以回传“_close_pop”指令。

  1. $this->success('保存成功', null, '_close_pop');
  2. 或者
  3. $this->success('保存成功', null, ['_close_pop' => 1]);

如果希望刷新父窗口，可以回传“_parent_reload”指令。

  1. $this->success('保存成功', null, '_parent_reload');
  2. 或
  3. $this->success('保存成功', null, ['_parent_reload' => 1]);

1.4.3后，如果返回url，则跳转到该rul。

  1. $this->success('保存成功'); // 默认刷新弹窗
  2. $this->success('保存成功', null, '_parent_reload'); // 刷新父页面
  3. $this->success('保存成功', 'user/index'); // 弹窗页面跳转到  'user/index'页面
  4. $this->success('保存成功',  'user/index', '_parent_reload'); // 父页面跳转到  'user/index'页面

自定义弹窗

从1.0.3开始，弹窗支持自定义，比如重新定义弹窗的大小，标题等，只需要以数组形式传入配置参数即可，更多参数，请参考：layer手册

比如修改弹窗的宽和高，可以这样做。

  1. ->addTopButton('add', [], ['area' => ['800px', '90%']])
  2. 或者
  3. ->addTopButton('add', [], ['area' => '800px'])

或者重新指定弹窗标题

  1. ->addTopButton('add', [], ['area' => ['800px', '90%'], 'title' => '这是新标题'])

也可以加个图标什么的

  1. ->addTopButton('add', [], ['area' => ['800px', '90%'], 'title' => '<i class="fa fa-user"></i> 这是新标题'])

当然也可以不显示标题

  1. ->addTopButton('add', [], ['area' => ['800px', '90%'], 'title' => false])

甚至可以定义标题样式

  1. ->addTopButton('add', [], ['area' => ['800px', '90%'], 'title' => ['新标题', 'font-size:18px;']])

定义皮肤

  1. ->addTopButton('add', [], ['skin' => 'layui-layer-lan'])

更多参数设置，请自行到layer官网查看手册。

从1.4.3版本开始，可以通过自定义函数来接管layer的各种回调。

  1. ->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()

弹窗的全局参数配置" class="reference-link">弹窗的全局参数配置

除了可以在ZBuilder中设置弹窗参数外，从1.0.3版本开始，可以在application\extra\zbuilder.php文件中设置全局参数。

注意：全局参数配置的优先级比在ZBuilder中直接设置参数低

弹窗按钮支持选择表格数据(1.3.3+)" class="reference-link">弹窗按钮支持选择表格数据(1.3.3+)

从1.3.3版本开始，顶部弹窗按钮支持选择表格数据，只需要在按钮的class添加js-get

  1. ->addTopButton('change', ['class' => 'btn btn-success js-get'], true)

这样设置后，勾选数据，然后点击顶部按钮，所勾选的id将会以get参数传送给弹窗页面，在弹窗页面的控制器中，用$ids来接收所选的id。