## 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
email
number
datetime
date.edit
time.edit
datetime.edit
picture
pictures
select
callback
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文件