# Uploader

图片上传Uploader组件。

# 代码引入

在 page.json 中引入组件

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

# 属性列表

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

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

属性 类型 默认值 必填 说明
url string 图片链接
loading boolean 图片上传中
error boolean 图片上传失败