更新记录
1.0.0(2024-07-16) 下载此版本
1.0.0
平台兼容性
shaoll-upload
Props
属性名 | 类型 | 说明 | 默认值 |
---|---|---|---|
width | [Number,String] | 展示图片的宽度,单位rpx | 218 |
height | [Number,String] | 展示图片的高度,单位rpx | 218 |
value | Array |
初始化图片路径 | [ ] |
radius | [Number,String] | 选择框与图片圆角值,单位rpx | 0 |
background | String | 选择框背景颜色 | #F7F7F7 |
borderColor | String | 选择框边框颜色 | transparent |
borderSytle | String | 选择框边框样式类型,可选值:solid、dashed、dotted | dashed |
delColor | String | 删除图标背景色 | #EB0909 |
delConfirm | Boolean | 删除图片前是否弹框确认 | false |
forbidDel | Boolean | 禁用删除 | false |
delTrigger | Boolean | 删除图片是否触发 complete 事件 | true |
addColor | String | 添加图标颜色 | #888 |
addSize | [Number,String] | 添加图标字体大小,单位rpx | 68 |
custom | Boolean | 是否自定义加号图标,结合插槽使用,仅小程序端需要设置 | false |
forbidAdd | Boolean | 禁用添加 | false |
serverUrl | String | 服务器接口地址。当接口地址为空时,直接返回本地图片地址 | "" |
limit | Number | 限制数 | 9 |
sizeType | Array |
original 原图,compressed 压缩图,默认二者都有 | ['original', 'compressed'] |
sourceType | Array |
album 从相册选图,camera 使用相机,默认二者都有。如需直接开相机或直接选相册,请只使用一个选项 | ['album', 'camera'] |
imageFormat | Array |
上传图片类型,默认为空数组,不限制,格式:['jpg','png','gif'] | [ ] |
size | Number | 单张图片大小限制 MB | 4 |
fileKeyName | String | 文件对应的 key , 开发者在服务器端通过这个 key 可以获取到文件二进制内容 | file |
header | Object | HTTP 请求 Header, header 中不能设置 Referer | { } |
formData | Object | HTTP 请求中其他额外的 form data | { } |
params | [Number, String] | 自定义参数,触发事件时回传 | 0 |
Slots
插槽名称 | 说明 |
---|---|
default V2.8.0+ | 自定义选择框加号,小程序端需要将custom属性设置为true |
Events
事件名 | 说明 | 回调参数 |
---|---|---|
complete | 上传完成事件 | { |
//上传状态 1-成功 2-上传中 3-失败 | ||
status:Number, | ||
//图片信息 | ||
imgArr:Array | ||
//自定义参数 | ||
params: params | ||
//是否手动上传 | ||
manual: false | ||
} | ||
remove | 删除图片,回传index索引 | { |
index:Number, | ||
params: params //自定义参数 | ||
} | ||
reuploadV2.9.1 | 上传失败时点击重新上传按钮事件,回传index索引 | { |
index:Number | ||
} |
Methods
方法名 | 说明 | 传入参数 |
---|---|---|
uploadAllImageV1.6.1 | 当属性serverUrl传空时,父级可调用该方法一次性上传所有图片 | serverUrl(服务器接口地址) |
uploadV2.9.1 | 父级可调用该方法进行上传图片,传入一个返回Promise的文件上传的函数,serverUrl属性请勿传值 | upload(callback, index) |