简介
右侧操作按钮用于在表格每行的最右侧显示操作按钮,实现单行数据的操作功能。
用法示例
基础用法
use plugin\xbCode\builder\Builder;
// 创建表格
Builder::crud(function($builder) {
// 添加编辑按钮(弹窗)
$builder->addRightActionDialog('编辑', '/api/edit');
// 添加删除按钮(确认框)
$builder->addRightActionConfirm('删除', '/api/delete');
});
完整示例
Builder::crud(function($builder) {
// 弹窗按钮
$builder->addRightActionDialog('编辑', 'GET:/api/edit', function($dialog) {
$dialog->title('编辑数据');
$dialog->size('lg');
});
// 抽屉按钮
$builder->addRightActionDrawer('详情', 'GET:/api/detail', function($drawer) {
$drawer->title('查看详情');
$drawer->position('right');
});
// 确认框按钮
$builder->addRightActionConfirm('删除', 'POST:/api/delete', '确认删除该数据吗?', '删除提示');
// 链接按钮
$builder->addRightActionLink('查看', '/view?id=${id}');
// URL按钮(新窗口打开)
$builder->addRightActionUrl('预览', '/preview?id=${id}', true);
// 下载按钮
$builder->addRightActionDownload('下载', '/api/download');
});
下拉按钮组
Builder::crud(function($builder) {
// 常用按钮
$builder->addRightActionDialog('编辑', 'GET:/api/edit');
// 下拉按钮组
$builder->addRightDropdownButton('更多操作', function($dropdown) use ($builder) {
$builder->addRightActionDialog('复制', 'GET:/api/copy');
$builder->addRightActionConfirm('归档', 'POST:/api/archive');
$builder->addRightActionDownload('导出', '/api/export');
});
});
配置操作列
Builder::crud(function($builder) {
// 设置操作列配置
$builder->setActionConfig('label', '操作'); // 设置列标题
$builder->setActionConfig('width', 200); // 设置列宽度
$builder->setActionConfig('fixed', 'right'); // 固定在右侧
// 添加操作按钮
$builder->addRightActionDialog('编辑', '/api/edit');
$builder->addRightActionConfirm('删除', '/api/delete');
});
可用方法
| 方法名 | 参数 | 返回值 | 说明 |
|---|
| addRightActionDialog | title, url, option | DialogAction | 添加弹窗按钮 |
| addRightActionDrawer | title, url, option | DrawerAction | 添加抽屉按钮 |
| addRightActionConfirm | title, url, content, cTitle | AjaxAction | 添加确认框按钮 |
| addRightActionDownload | title, url | DownloadAction | 添加下载按钮 |
| addRightActionLink | title, url | LinkAction | 添加链接按钮 |
| addRightActionUrl | title, url, target | UrlAction | 添加URL按钮 |
| addRightDropdownButton | title, callback | DropdownButton | 添加下拉按钮组 |
| setActionConfig | name, value | this | 设置操作列配置 |
方法参数说明
addRightActionDialog
| 参数名 | 类型 | 默认值 | 说明 |
|---|
| title | string | 必填 | 按钮文本 |
| url | string | 必填 | 请求地址(支持 METHOD:URL 格式) |
| option | callable|array | [] | 弹窗配置 |
addRightActionConfirm
| 参数名 | 类型 | 默认值 | 说明 |
|---|
| title | string | 必填 | 按钮文本 |
| url | string | 必填 | 请求地址 |
| content | string | '是否确认操作该数据?' | 确认框内容 |
| cTitle | string | '温馨提示' | 确认框标题 |
addRightActionUrl
| 参数名 | 类型 | 默认值 | 说明 |
|---|
| title | string | 必填 | 按钮文本 |
| url | string | 必填 | 跳转地址 |
| target | bool | true | 是否新窗口打开 |
setActionConfig
| 参数名 | 类型 | 默认值 | 说明 |
|---|
| name | string | 必填 | 配置项名称 |
| value | mixed | 必填 | 配置项值 |
操作列配置
| 配置项 | 类型 | 默认值 | 说明 |
|---|
| label | string | '操作' | 列标题 |
| width | string|int | 'auto' | 列宽度 |
| fixed | string | - | 固定位置:'left'、'right' |
| align | string | - | 水平对齐方式 |
URL参数绑定
操作按钮的URL支持动态参数绑定:
${id} - 绑定当前行的id字段${字段名} - 绑定当前行的任意字段- 自动添加主键ID参数
使用场景
- 数据编辑操作
- 数据删除操作
- 详情查看
- 数据下载导出
- 状态变更操作
注意事项
- 操作按钮显示在表格最右侧
- 所有按钮默认为链接样式(level: 'link')
- URL会自动追加主键ID参数
- 支持 METHOD:URL 格式指定请求方法
- 下拉按钮组中的按钮会收纳在"更多"菜单中
- 删除类按钮建议使用红色样式(text-danger)