# Uploader
图片上传Uploader组件。
# 代码引入
在 page.json 中引入组件
{
"usingComponents": {
"mp-uploader": "weui-miniprogram/uploader/uploader"
}
}
1
2
3
4
5
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 | 否 | 图片上传失败 |