右侧按钮

简介

右侧操作按钮用于在表格每行的最右侧显示操作按钮,实现单行数据的操作功能。

用法示例

基础用法

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');
});

可用方法

方法名参数返回值说明
addRightActionDialogtitle, url, optionDialogAction添加弹窗按钮
addRightActionDrawertitle, url, optionDrawerAction添加抽屉按钮
addRightActionConfirmtitle, url, content, cTitleAjaxAction添加确认框按钮
addRightActionDownloadtitle, urlDownloadAction添加下载按钮
addRightActionLinktitle, urlLinkAction添加链接按钮
addRightActionUrltitle, url, targetUrlAction添加URL按钮
addRightDropdownButtontitle, callbackDropdownButton添加下拉按钮组
setActionConfigname, valuethis设置操作列配置

方法参数说明

addRightActionDialog

参数名类型默认值说明
titlestring必填按钮文本
urlstring必填请求地址(支持 METHOD:URL 格式)
optioncallable|array[]弹窗配置

addRightActionConfirm

参数名类型默认值说明
titlestring必填按钮文本
urlstring必填请求地址
contentstring'是否确认操作该数据?'确认框内容
cTitlestring'温馨提示'确认框标题

addRightActionUrl

参数名类型默认值说明
titlestring必填按钮文本
urlstring必填跳转地址
targetbooltrue是否新窗口打开

setActionConfig

参数名类型默认值说明
namestring必填配置项名称
valuemixed必填配置项值

操作列配置

配置项类型默认值说明
labelstring'操作'列标题
widthstring|int'auto'列宽度
fixedstring-固定位置:'left'、'right'
alignstring-水平对齐方式

URL参数绑定

操作按钮的URL支持动态参数绑定:

  • ${id} - 绑定当前行的id字段
  • ${字段名} - 绑定当前行的任意字段
  • 自动添加主键ID参数

使用场景

  • 数据编辑操作
  • 数据删除操作
  • 详情查看
  • 数据下载导出
  • 状态变更操作

注意事项

  1. 操作按钮显示在表格最右侧
  2. 所有按钮默认为链接样式(level: 'link')
  3. URL会自动追加主键ID参数
  4. 支持 METHOD:URL 格式指定请求方法
  5. 下拉按钮组中的按钮会收纳在"更多"菜单中
  6. 删除类按钮建议使用红色样式(text-danger)