简介
底部批量操作组件用于对表格中选中的多行数据进行批量处理。
用法示例
基础用法
use plugin\xbCode\builder\Builder;
// 创建表格
Builder::crud(function($builder) {
// 添加批量删除
$builder->addBulkActionConfirm('批量删除', '/api/delete', '确认删除选中的数据吗?');
// 添加批量导出
$builder->addBulkActionDownload('批量导出', '/api/export');
});
完整示例
Builder::crud(function($builder) {
// 批量弹窗操作
$builder->addBulkActionDialog('批量编辑', 'GET:/api/batch-edit', function($dialog) {
$dialog->title('批量编辑');
$dialog->size('lg');
});
// 批量抽屉操作
$builder->addBulkActionDrawer('批量分配', 'GET:/api/batch-assign', function($drawer) {
$drawer->title('批量分配');
});
// 批量确认操作
$builder->addBulkActionConfirm('批量审核', 'POST:/api/batch-approve', '确认批量审核选中的数据吗?', '批量审核');
// 批量链接操作
$builder->addBulkActionLink('批量查看', '/batch-view');
// 批量URL操作
$builder->addBulkActionUrl('批量打印', '/print', true);
});
可用方法
| 方法名 | 参数 | 返回值 | 说明 |
|---|
| addBulkActionDialog | title, url, method, option | DialogAction | 添加批量弹窗操作 |
| addBulkActionDrawer | title, url, method, option | DrawerAction | 添加批量抽屉操作 |
| addBulkActionConfirm | title, url, content, cTitle, method | AjaxAction | 添加批量确认框操作 |
| addBulkActionDownload | title, url, method | DownloadAction | 添加批量下载操作 |
| addBulkActionLink | title, url | LinkAction | 添加批量链接操作 |
| addBulkActionUrl | title, url, target | UrlAction | 添加批量URL操作 |
方法参数说明
addBulkActionDialog
| 参数名 | 类型 | 默认值 | 说明 |
|---|
| title | string | 必填 | 按钮文本 |
| url | string | 必填 | 请求地址 |
| method | string | GET | 请求方法 |
| option | callable|array | [] | 弹窗配置 |
addBulkActionConfirm
| 参数名 | 类型 | 默认值 | 说明 |
|---|
| title | string | 必填 | 按钮文本 |
| url | string | 必填 | 请求地址 |
| content | string | '是否确认操作该数据?' | 确认框内容 |
| cTitle | string | '温馨提示' | 确认框标题 |
| method | string | GET | 请求方法 |
addBulkActionDownload
| 参数名 | 类型 | 默认值 | 说明 |
|---|
| title | string | 必填 | 按钮文本 |
| url | string | 必填 | 下载地址 |
| method | string | GET | 请求方法 |
使用场景
- 批量删除数据
- 批量修改状态
- 批量导出数据
- 批量分配任务
- 批量审核操作
注意事项
- 批量操作按钮显示在表格底部左侧
- 自动获取选中行的ID(通过
${ids|raw} 变量) - URL会自动追加
ids 参数 - 支持GET和POST等多种请求方法
- 需要先选中数据才能执行批量操作