## replaceRightButton('匹配条件', '最终要替换的内容', '目标按钮')
| 版本 | 新增功能 |
| --- | --- |
| 1.0.5 | 增强条件判断,支持替换指定按钮 |
| 1.4.2 | 替换内容支持数据变量 |
如果要修改某些数据的右侧按钮,比如,管理员用户组不给用户操作,只显示一个不可操作的按钮。
~~~
->replaceRightButton(['id' => 1], '<button class="btn btn-danger btn-xs" type="button" disabled>不可操作</button>') // 修改id为1的按钮
~~~
上面的代码是将id字段为1的数据,右侧按钮替换为”不可操作“;
**设置多个匹配条件**
~~~
->replaceRightButton(['id' => 1, 'status' => 1], '<button class="btn btn-danger btn-xs" type="button" disabled>不可操作</button>') // 修改id为1的按钮
~~~
表示id字段为1并且status字段为1的数据,右侧按钮替换为”不可操作“;
**设置多个替换规则**
~~~
->replaceRightButton(['id' => 1], '<button class="btn btn-danger btn-xs" type="button" disabled>不可操作</button>')
->replaceRightButton(['id' => 2], '<button class="btn btn-danger btn-xs" type="button" disabled>可操作</button>')
~~~
>[info] ### 从1.0.5版本开始,增强了条件判断,并支持替换指定按钮
比如:
~~~
->replaceRightButton(['status' => ['in', '0,1']], '', 'edit,delete')
~~~
表示当status字段为0或者1,则将编辑按钮和删除按钮替换为空,即不显示这两个按钮。
也可以这样写:
~~~
->replaceRightButton(['status' => ['in', '0,1']], '', ['edit', 'delete'])
~~~
>[info] 提示:如果不指定替换的按钮,则默认替换所有按钮。
~~~
->replaceRightButton(['status' => 1], '')
~~~
表示如果status为1,则不显示所有按钮。
>[danger] 注意,以上的例子指定了替换编辑按钮和删除按钮,也就是需要添加这两个按钮,判断才起作用。
**`replaceRightButton`方法的第一个参数是判断条件,基本使用方法如下:**
~~~
['字段名' => ['表达式', '对比条件']]
~~~
表达式不分大小写,支持的查询表达式有下面几种,分别表示的含义是:
| 表达式 | 含义 |
| --- | --- |
| EQ、= | 等于(=) |
| NEQ、<> | 不等于(<>) |
| GT、> | 大于(>) |
| EGT、>= | 大于等于(>=) |
| LT、< | 小于(<) |
| ELT、<= | 小于等于(<=) |
| [NOT] BETWEEN | (不在)区间查询 |
| [NOT] IN | (不在)IN 查询 |
表达式查询的用法示例如下:
### EQ :等于(=)
~~~
->replaceRightButton(['status' => 1], '', 'edit')
->replaceRightButton(['status' => ['eq', 1]], '', 'edit')
->replaceRightButton(['status' => ['=', 1]], '', 'edit')
~~~
表示status字段等于1时,不显示编辑按钮。
### NEQ: 不等于(<>)
~~~
->replaceRightButton(['status' => ['neq', 1]], '', 'edit')
->replaceRightButton(['status' => ['<>', 1]], '', 'edit')
~~~
表示status字段不等于1时,不显示编辑按钮。
### GT:大于(>)
~~~
->replaceRightButton(['status' => ['gt', 1]], '', 'edit')
->replaceRightButton(['status' => ['>', 1]], '', 'edit')
~~~
表示status字段大于1时,不显示编辑按钮。
### EGT:大于等于(>=)
~~~
->replaceRightButton(['status' => ['egt', 1]], '', 'edit')
->replaceRightButton(['status' => ['>=', 1]], '', 'edit')
~~~
表示status字段大于等于1时,不显示编辑按钮。
### LT:小于(<)
~~~
->replaceRightButton(['status' => ['lt', 1]], '', 'edit')
->replaceRightButton(['status' => ['<', 1]], '', 'edit')
~~~
表示status字段小于1时,不显示编辑按钮。
### ELT: 小于等于(<=)
~~~
->replaceRightButton(['status' => ['elt', 1]], '', 'edit')
->replaceRightButton(['status' => ['<=', 1]], '', 'edit')
~~~
表示status字段小于等于1时,不显示编辑按钮。
### [NOT] BETWEEN : (不在)区间查询
支持字符串或者数组,例如:
~~~
->replaceRightButton(['status' => ['between', '0,8']], '', 'edit')
~~~
和下面的等效:
~~~
->replaceRightButton(['status' => ['between', [0, 8]]], '', 'edit')
~~~
表示status字段在0到8之间时,不显示编辑按钮。
~~~
->replaceRightButton(['status' => ['not between', '0,8']], '', 'edit')
->replaceRightButton(['status' => ['not between', [0, 8]]], '', 'edit')
~~~
表示status字段不在0到8之间时,不显示编辑按钮。
### [NOT] IN:(不在)IN 查询
支持字符串或者数组,例如:
~~~
->replaceRightButton(['status' => ['in', '1,5,8']], '', 'edit')
~~~
和下面的等效:
~~~
->replaceRightButton(['status' => ['in', [1,5,8]]], '', 'edit')
~~~
表示status字段为1或5或8时,不显示编辑按钮。
~~~
->replaceRightButton(['status' => ['not in', '1,5,8']], '', 'edit')
->replaceRightButton(['status' => ['not in', [1,5,8]]], '', 'edit')
~~~
表示status字段不是1或5或8时,不显示编辑按钮。
### 或的用法
~~~
->replaceRightButton(['status' => 1], '', 'delete')
->replaceRightButton(['status' => 0], '', 'delete')
~~~
表示status字段为1或者0,不显示删除按钮,可以使用一条语句完成相同的效果。
~~~
->replaceRightButton(['status' => ['in', '0,1']], '', 'delete')
~~~
### 且的用法
~~~
->replaceRightButton(['status' => 1,, 'nickname' => 'ming'], '', 'delete')
~~~
表示`status`字段为1并且`nickname`字段为`ming`时,不显示删除按钮。
### 高级用法
如果以上用法还不符合需求,可以自定义函数处理,返回true表示替换,返回fale表示不替换。
~~~
->replaceRightButton(function ($data){
return $data['status'] == 0;
}, '', 'delete')
~~~
表示当status字段的值为0时,不显示删除按钮。
其中,$data是当前行的所有字段数据。
## 替换内容支持数据变量(1.4.2+)
有时候我们希望替换内容是一个按钮或者一个链接,又想获取当前数据的id或者其他字段,那么可以使用`__字段名__`来获取。
```
->replaceRightButton(['status' => 1], '<button data-id="__id__">禁止操作</button>')
```
- 序言
- 环境搭建
- 下载及安装
- 目录结构
- 快速构建器(ZBuilder)
- 表单(form)
- 设置页面标题
- 设置页提示信息
- 设置表单提交地址
- 隐藏按钮
- 添加按钮
- 设置按钮标题
- 添加表单项
- 复选
- 单选
- 日期
- 时间
- 开关
- 标签
- 数组
- 分组
- 范围
- 按钮
- 数字框
- 密码框
- 取色器
- 下拉菜单
- 普通联动
- 快速联动
- 拖拽排序
- 静态文本
- 格式文本
- 日期时间
- 日期范围
- 图片裁剪
- 百度地图
- 单文件上传
- 多文件上传
- 单图片上传
- 多图片上传
- 隐藏表单项
- 图标选择器
- 单行文本框
- 多行文本框
- 百度编辑器
- CKEditor编辑器
- wang编辑器
- markdown编辑器
- summernote编辑器
- 图片展示(1.1.0+)
- 单文件展示(1.1.0+)
- 多文件展示(1.1.0+)
- 下拉菜单Ajax(1.3.3+)
- 复杂表格(1.4.3+)
- 数据表格(1.4.3+)
- 分组下拉菜单(1.4.3+)
- 表格选取(1.4.3+)
- 穿梭框(1.4.3+)
- 添加表单项通用方法
- 直接设置表单项
- 表单布局
- 设置Tab按钮列表
- 设置表单数据
- 引入js文件
- 引入css文件
- 设置额外JS代码
- 设置额外CSS样式
- 设置额外HTML代码
- 是否ajax方式提交
- 设置模版路径
- 设置触发器
- 设置表单提交确认框
- 自定义表单项(1.0.6+)
- 设置表单提交方式(1.0.6+)
- 模板变量赋值(1.0.7+)
- 设置页面空表单项提示(1.0.7+)
- 自定义扩展表单图标(1.2.0+)
- 设置表单令牌(1.3.1+)
- 新窗口打开返回的url(1.4.4+)
- 表格(table)
- 设置页面标题
- 设置页面提示信息
- 添加一列
- 字段类型
- switch
- status
- yesno
- text.edit
- textarea.edit
- password
- url
- tel
- number
- icon
- byte
- date
- time
- datetime
- date.edit
- time.edit
- datetime.edit
- picture
- pictures
- select
- callback
- link
- text
- img_url
- files(1.1.1+)
- popover(1.4.4+)
- 添加多列
- 添加数量索引
- 添加快捷编辑的验证器
- 设置表格数据
- 隐藏第一列多选框
- 添加表头排序
- 添加表头筛选
- 添加表头筛选条件
- 添加时间段筛选
- 添加一个右侧按钮
- 添加多个右侧按钮
- 添加一个顶部按钮
- 添加多个顶部按钮
- 自动添加按钮
- 自动编辑按钮
- 替换右侧按钮
- 设置搜索参数
- 设置数据库表名
- 设置插件名称
- 设置表格主键
- 设置Tab按钮列表
- 设置分页
- 去除分页
- 引入js文件
- 引入css文件
- 设置额外JS代码
- 设置额外CSS样式
- 设置额外HTML代码
- 设置额外HTML代码-模板文件(1.4.0+)
- 设置模版路径
- 添加行class名
- 添加顶部下拉筛选
- 设置页面空数据提示(1.0.7+)
- 模板变量赋值(1.0.7+)
- 设置使用原始数据字段(1.0.8+)
- 设置搜索区域(1.1.0+)
- 设置表格高度(1.3.0+)
- 固定左列(1.3.0+)
- 固定右列(1.3.0+)
- 设置列宽(1.3.0+)
- 设置隐藏列(1.3.0+)
- 侧栏(aside)
- 添加区块
- 设置Tab按钮列表
- 追加Tab按钮列表
- 设置当前tab
- 设置单个tab内容
- 设置多个tab内容
- 追加tab内容
- 覆盖侧栏
- 模块开发
- 创建模块信息文件
- 安装模块
- 模块配置
- 控制器
- 创建菜单节点
- 第一个控制器
- 模块参数配置页面
- 方法参考
- 数据授权(1.3.2+)
- 插件开发
- 插件入口文件
- 插件基本信息
- 管理界面的字段信息
- 新增或编辑的字段信息
- 插件钩子
- 触发器
- 原数据库表前缀
- 插件配置信息
- 安装和卸载Sql文件
- 控制器
- 模型
- 验证器
- 视图
- 方法参考
- 实践教程
- 变量参考
- 函数参考
- 安全相关
- 常见问题
- 其他杂项
- 更新日志
- 升级指导
- 贡献名单
- 关于文档