Uploader

图片上传Uploader组件。

代码引入

在 page.json 中引入组件

  1. {
  2. "usingComponents": {
  3. "mp-uploader": "weui-miniprogram/uploader/uploader"
  4. }
  5. }

示例代码

属性列表

属性类型默认值必填说明
ext-classstring添加在组件内部结构的class,可用于修改组件内部的样式
titlestring组件标题
tipsstring组件的提示
deleteboolean是否显示删除按钮
size-typearray和chooseImage的sizeType参数一样
source-typearray和chooseImage的sourceType参数一样
max-sizenumber5 1024 1024图片上传的最大文件限制,默认是5M
max-countnumber1图片上传的个数限制
filesarray<object>当前的图片列表
selectfunction选择图片时的过滤函数,返回true表示图片有效
uploadfunction图片上传的函数,返回Promise,Promise的callback里面必须resolve({urls})表示成功,否则表示失败
bindselecteventhandler图片选择触发的事件,detail为{tempFilePaths, tempFiles, contents},其中tempFiles和tempFilePaths是chooseImage返回的字段,contents表示所选的图片的二进制Buffer列表
bindcanceleventhandler取消图片选择的事件,detail为{}
bindsuccesseventhandler图片上传成功的事件,detail为{urls},urls为upload函数上传成功返回的urls参数
bindfaileventhandler图片上传失败的事件,detail为{type, errMsg},type为1表示图片超过大小限制,type为2表示选择图片失败,type为3表示图片上传失败。
binddeleteeventhandler删除图片触发的事件,detail为{index, item},index表示删除的图片的下标,item为图片对象。

files表示当前的图片列表,每一项的定义为

属性类型默认值必填说明
urlstring图片链接
loadingboolean图片上传中
errorboolean图片上传失败