## 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文件
- 控制器
- 模型
- 驗證器
- 視圖
- 方法參考
- 實踐教程
- 變量參考
- 函數參考
- 安全相關
- 常見問題
- 其他雜項
- 更新日志
- 升級指導
- 貢獻名單
- 關于文檔