## addImages('name值', '標題' [, '提示', '默認值', '限制大小', '文件后綴', '額外css類', '縮略圖參數', '水印參數'])
| 版本 | 新增功能 |
| --- | --- |
| 1.2.0 | 自定義生成縮略圖,自定義水印 |
標識符:`images`
| 參數 | 含義 | 類型 |
| --- | --- | --- |
| name | name值 | string |
| title | 標題 | string |
| tips | 提示 | string |
| default | 默認值 | string |
| size | 限制大小(單位kb) | string |
| ext | 文件后綴(如:'jpg,png,gif') | string |
| extra_class | 額外css類 | string |
| thumb | 縮略圖參數(1.2.0+) | string/array |
| watermark | 水印參數(1.2.0+) | string/array |
用法還是和單文件上傳是一樣的,具體信息請參考[單文件上傳](單文件上傳.md)。
>[info]上傳后,保存的是圖片附件id,上傳多張圖片,保存的值類似:`1,2,3`(逗號隔開)
如果在前臺頁面使用時,需要獲取該圖片路徑,需要將值用`explode`函數將值轉為數組,然后逐個使用`get_file_path(附件id)`來獲取對應的路徑。
### 自定義生成縮略圖
>[info] 此參數需要1.2.0或以上版本支持。
**生成30x30的縮略圖**
如果需要生成30x30的縮略圖,那么size參數要寫成30,30(用逗號隔開)
~~~
return ZBuilder::make('form')
->addImages('pic', '圖片', '', '', '', '', '', ['size' => '30,30'])
->fetch();
~~~
或者
~~~
return ZBuilder::make('form')
->addFormItems([
['images', 'pic', '圖片', '', '', '', '', '', ['size' => '30,30']]
])
->fetch();
~~~
**設置縮略圖裁剪類型**
默認情況下,縮略圖的裁剪方式是“等比例縮放”,如果需要設置其他類型,可以這樣寫
~~~
return ZBuilder::make('form')
->addImages('pic', '圖片', '', '', '', '', '', ['size' => '30,30', 'type' => 2])
->fetch();
~~~
type參數可以設置以下幾種,默認為1,即等比例縮放。
| 參數 | 含義 |
| --- | --- |
| 1 | 等比例縮放 |
| 2 | 縮放后填充 |
| 3 | 居中裁剪 |
| 4 | 左上角裁剪 |
| 5 | 右下角裁剪 |
| 6 | 固定尺寸縮放 |
**關閉縮略圖功能**
>[danger]默認情況下,如果沒有設置縮略圖參數,那么是否生成縮略圖由【系統】【系統設置】【上傳】中的配置決定。

如果在表單項參數中設置了縮略圖參數,則以表單項的縮略圖參數為優先。
如果在系統設置中設置了縮略圖參數,但在某些情況下,想臨時不生成縮略圖,則可以將縮略圖參數設置為字符串'`close`'。
~~~
return ZBuilder::make('form')
->addImages('pic', '圖片', '', '', '', '', '', 'close')
->fetch();
~~~
### 自定義水印
>[info] 此參數需要1.2.0或以上版本支持。
設置參數的img為附件id,即水印圖片的附件id,如果附件不存在,則不會添加水印。
~~~
return ZBuilder::make('form')
->addImages('pic', '圖片', '', '', '', '', '', '', ['img' => 10])
->fetch();
~~~
**設置水印的位置**
~~~
return ZBuilder::make('form')
->addImages('pic', '圖片', '', '', '', '', '', '', ['img' => 10, 'pos' => 1])
->fetch();
~~~
水印位置有以下幾個參數,默認為9,即右下角。
| 參數 | 含義 |
| --- | --- |
| 1 | 左上角 |
| 2 | 上居中 |
| 3 | 右上角 |
| 4 | 左居中 |
| 5 | 居中 |
| 6 | 右居中 |
| 7 | 左下角 |
| 8 | 下居中 |
| 9 | 右下角 |
設置水印透明度
~~~
return ZBuilder::make('form')
->addImages('pic', '圖片', '', '', '', '', '', '', ['img' => 10, 'pos' => 1, 'alpha' => 90])
->fetch();
~~~
透明度取值范圍是0~100,數字越小,透明度越高。
不添加水印
>[danger]默認情況下,如果沒有設置水印參數,那么是否添加水印由【系統】【系統設置】【上傳】中的配置決定。

如果在表單項參數中設置了水印圖參數,則以表單項的水印參數為優先。
如果在系統設置中設置了打開了水印功能,但在某些情況下,想臨時不添加水印,則可以將水印參數設置為字符串'`close`'。
~~~
return ZBuilder::make('form')
->addImages('pic', '圖片', '', '', '', '', '', '', 'close')
->fetch();
~~~
- 序言
- 環境搭建
- 下載及安裝
- 目錄結構
- 快速構建器(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文件
- 控制器
- 模型
- 驗證器
- 視圖
- 方法參考
- 實踐教程
- 變量參考
- 函數參考
- 安全相關
- 常見問題
- 其他雜項
- 更新日志
- 升級指導
- 貢獻名單
- 關于文檔