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

版本 功能
1.0.7 支持自定义数据操作方式,默认为Db::name()

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

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

注意:要使用这些按钮,需要将对应的操作添加到节点菜单,否则除管理员外,其他用户将无权限操作。
其中,添加按钮的操作方法需要自己实现,默认是当前控制器的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']) // 删除

从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;

自定义按钮

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

提示: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();

从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' => '真的要删除吗?'
];

->addRightButton('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' => '删除了就无法恢复了'
];

->addRightButton('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' => '再想想'
];

->addRightButton('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

弹窗形式打开

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

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

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

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

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

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

自定义弹窗

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

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

->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官网查看手册。

弹窗的全局参数配置

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

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