
# 变更记录
| 产品版本 | 更新内容 | 更新日期 |
| --- | --- | --- |
| V7.0.1 | 优化了移动端图片列表控件,新增”最大图片大小“属性,上传超过该大小的图片自动进行压缩,提升图片上传速度 | 2024-10-24 |
# 1 功能介绍
当需要上传一张或一组图片时,可选择图片列表控件。
# 2 控件对象
`kd.bos.form.control.ImageList`
# 3 视觉展示

# 4 属性说明
## 4.1 通用属性
>通用属性包含字段和控件的一些公有的属性,如宽高,帮助文本等等。请参考[通用属性](https://vip.kingdee.com/article/215559076720798976)
## 4.2 样式属性
>样式属性是每个控件在设计器右侧样式栏可以设置的属性,请参考[样式属性](https://vip.kingdee.com/article/252017936767406336)
## 4.3 业务属性
| 属性名 | 类型 | 默认值 | 说明 | 备注 | 支持版本 |
| --- | --- | --- | --- | --- | --- |
| 允许上传 | 复选框 | true | 设置Upload 按钮是否出现 | | |
| 最大图片数 | 整数 | -1 | 设置限制上传最大图片数,为负则不限制 | | |
| 显示图片名称 | 复选框 | false | 设置是否显示图片名称 | | |
| 最大图片大小 | 整数 | | 设置可上传的最大图片大小,单位Mb;移动端选择的图片超过该大小会先进行压缩,压缩后小于该大小才能上传,否则不能上传 | 仅移动端支持 | V7.0.1 |
### 4.3.1 允许上传的图片格式
默认情况下,图片字段允许上传格式为: .webp