510 lines
15 KiB
Vue
510 lines
15 KiB
Vue
<template>
|
||
<view class="u-upload" v-if="!disabled">
|
||
<view v-if="showUploadList" class="u-list-item u-preview-wrap" v-for="(item, index) in lists" :key="index" :style="{
|
||
width: width + 'rpx',
|
||
height: width + 'rpx'
|
||
}">
|
||
<view v-if="deletable" class="u-delete-icon" @tap.stop="deleteItem(index)" :style="{
|
||
background: delBgColor
|
||
}">
|
||
<u-icon class="u-icon" :name="delIcon" size="20" :color="delColor"></u-icon>
|
||
</view>
|
||
<u-line-progress v-if="showProgress && item.progress > 0 && !item.error" :show-percent="false" height="16" class="u-progress" :percent="item.progress"></u-line-progress>
|
||
<view @tap.stop="retry(index)" v-if="item.error" class="u-error-btn">点击重试</view>
|
||
<image @tap.stop="doPreviewImage(item.url || item.path, index)" class="u-preview-image" v-if="!item.isImage" :src=" item.url || item.path "
|
||
:mode="imageMode"></image>
|
||
</view>
|
||
<slot name="file" :file="lists"></slot>
|
||
<view style="display: inline-block;" @tap="selectFile" v-if="maxCount > lists.length">
|
||
<slot name="addBtn"></slot>
|
||
<view v-if="!customBtn" class="u-list-item u-add-wrap" hover-class="u-add-wrap__hover" hover-stay-time="150" :style="{
|
||
width: width + 'rpx',
|
||
height: width + 'rpx'
|
||
}">
|
||
<u-icon name="plus" class="u-add-btn" size="40" @click="selectFile"></u-icon>
|
||
<view class="u-add-tips">{{uploadText}}</view>
|
||
</view>
|
||
</view>
|
||
</view>
|
||
</template>
|
||
|
||
<script>
|
||
/**
|
||
* upload 图片上传
|
||
* @description 该组件用于上传图片场景
|
||
* @tutorial https://www.uviewui.com/components/upload.html
|
||
* @property {String} action 服务器上传地址
|
||
* @property {String Number} max-count 最大选择图片的数量(默认99)
|
||
* @property {Boolean} custom-btn 如果需要自定义选择图片的按钮,设置为true(默认false)
|
||
* @property {Boolean} show-progress 是否显示进度条(默认true)
|
||
* @property {Boolean} disabled 是否启用(显示/移仓)组件(默认false)
|
||
* @property {String} image-mode 预览图片等显示模式,可选值为uni的image的mode属性值(默认aspectFill)
|
||
* @property {String} del-icon 右上角删除图标名称,只能为uView内置图标
|
||
* @property {String} del-bg-color 右上角关闭按钮的背景颜色
|
||
* @property {String} del-color 右上角关闭按钮图标的颜色
|
||
* @property {Object} header 上传携带的头信息,对象形式
|
||
* @property {Object} form-data 上传额外携带的参数
|
||
* @property {String} name 上传文件的字段名,供后端获取使用(默认file)
|
||
* @property {Array<String>} size-type original 原图,compressed 压缩图,默认二者都有(默认['original', 'compressed'])
|
||
* @property {Array<String>} source-type 选择图片的来源,album-从相册选图,camera-使用相机,默认二者都有(默认['album', 'camera'])
|
||
* @property {Boolean} preview-full-image 是否可以通过uni.previewImage预览已选择的图片(默认true)
|
||
* @property {Boolean} multiple 是否开启图片多选,部分安卓机型不支持(默认true)
|
||
* @property {Boolean} deletable 是否显示删除图片的按钮(默认true)
|
||
* @property {String Number} max-size 选择单个文件的最大大小,单位B(byte),默认不限制(默认Number.MAX_VALUE)
|
||
* @property {Array<Object>} file-list 默认显示的图片列表,数组元素为对象,必须提供url属性
|
||
* @property {Boolean} upload-text 选择图片按钮的提示文字(默认“选择图片”)
|
||
* @property {Boolean} auto-upload 选择完图片是否自动上传,见上方说明(默认true)
|
||
* @property {Boolean} show-tips 特殊情况下是否自动提示toast,见上方说明(默认true)
|
||
* @property {Boolean} show-upload-list 是否显示组件内部的图片预览(默认true)
|
||
* @event {Function} on-oversize 图片大小超出最大允许大小
|
||
* @event {Function} on-preview 全屏预览图片时触发
|
||
* @event {Function} on-remove 移除图片时触发
|
||
* @event {Function} on-success 图片上传成功时触发
|
||
* @event {Function} on-change 图片上传后,无论成功或者失败都会触发
|
||
* @event {Function} on-error 图片上传失败时触发
|
||
* @event {Function} on-progress 图片上传过程中的进度变化过程触发
|
||
* @event {Function} on-uploaded 所有图片上传完毕触发
|
||
* @event {Function} on-choose-complete 每次选择图片后触发,只是让外部可以得知每次选择后,内部的文件列表
|
||
* @example <u-upload :action="action" :file-list="fileList" ></u-upload>
|
||
*/
|
||
export default {
|
||
name: 'u-upload',
|
||
props: {
|
||
//是否显示组件自带的图片预览功能
|
||
showUploadList: {
|
||
type: Boolean,
|
||
default: true
|
||
},
|
||
// 后端地址
|
||
action: {
|
||
type: String,
|
||
default: ''
|
||
},
|
||
// 最大上传数量
|
||
maxCount: {
|
||
type: [String, Number],
|
||
default: 52
|
||
},
|
||
// 是否显示进度条
|
||
showProgress: {
|
||
type: Boolean,
|
||
default: true
|
||
},
|
||
// 是否启用
|
||
disabled: {
|
||
type: Boolean,
|
||
default: false
|
||
},
|
||
// 预览上传的图片时的裁剪模式,和image组件mode属性一致
|
||
imageMode: {
|
||
type: String,
|
||
default: 'aspectFill'
|
||
},
|
||
// 头部信息
|
||
header: {
|
||
type: Object,
|
||
default () {
|
||
return {}
|
||
}
|
||
},
|
||
// 额外携带的参数
|
||
formData: {
|
||
type: Object,
|
||
default () {
|
||
return {}
|
||
}
|
||
},
|
||
// 上传的文件字段名
|
||
name: {
|
||
type: String,
|
||
default: 'file'
|
||
},
|
||
// 所选的图片的尺寸, 可选值为original compressed
|
||
sizeType: {
|
||
type: Array,
|
||
default () {
|
||
return ['original', 'compressed']
|
||
}
|
||
},
|
||
sourceType: {
|
||
type: Array,
|
||
default () {
|
||
return ['album', 'camera']
|
||
}
|
||
},
|
||
// 是否在点击预览图后展示全屏图片预览
|
||
previewFullImage: {
|
||
type: Boolean,
|
||
default: true
|
||
},
|
||
// 是否开启图片多选,部分安卓机型不支持
|
||
multiple: {
|
||
type: Boolean,
|
||
default: true
|
||
},
|
||
// 是否展示删除按钮
|
||
deletable: {
|
||
type: Boolean,
|
||
default: true
|
||
},
|
||
// 文件大小限制,单位为byte
|
||
maxSize: {
|
||
type: [String, Number],
|
||
default: Number.MAX_VALUE
|
||
},
|
||
// 显示已上传的文件列表
|
||
fileList: {
|
||
type: Array,
|
||
default () {
|
||
return []
|
||
}
|
||
},
|
||
// 上传区域的提示文字
|
||
uploadText: {
|
||
type: String,
|
||
default: '选择图片'
|
||
},
|
||
// 是否自动上传
|
||
autoUpload: {
|
||
type: Boolean,
|
||
default: true
|
||
},
|
||
// 是否显示toast消息提示
|
||
showTips: {
|
||
type: Boolean,
|
||
default: true
|
||
},
|
||
// 是否通过slot自定义传入选择图标的按钮
|
||
customBtn: {
|
||
type: Boolean,
|
||
default: false
|
||
},
|
||
// 内部预览图片区域和选择图片按钮的区域宽度,高等于宽
|
||
width: {
|
||
type: [String, Number],
|
||
default: 200
|
||
},
|
||
// 右上角关闭按钮的背景颜色
|
||
delBgColor: {
|
||
type: String,
|
||
default: '#fa3534'
|
||
},
|
||
// 右上角关闭按钮的叉号图标的颜色
|
||
delColor: {
|
||
type: String,
|
||
default: '#ffffff'
|
||
},
|
||
// 右上角删除图标名称,只能为uView内置图标
|
||
delIcon: {
|
||
type: String,
|
||
default: 'close'
|
||
}
|
||
},
|
||
mounted() {
|
||
|
||
},
|
||
data() {
|
||
return {
|
||
lists: [],
|
||
isInCount: true,
|
||
uploading: false
|
||
}
|
||
},
|
||
watch: {
|
||
fileList: {
|
||
immediate: true,
|
||
handler(val) {
|
||
val.map(value => {
|
||
this.lists.push({url: value.url, error: false, progress: 100});
|
||
})
|
||
}
|
||
},
|
||
},
|
||
methods: {
|
||
// 清除列表
|
||
clear() {
|
||
this.lists = [];
|
||
// 如果是清空形式的话,发出"on-list-change"事件
|
||
this.$emit('on-list-change', this.lists);
|
||
},
|
||
// 重新上传队列中上传失败的所有文件
|
||
reUpload() {
|
||
this.uploadFile();
|
||
},
|
||
// 选择图片
|
||
selectFile() {
|
||
if (this.disabled) return;
|
||
const {
|
||
name = '', maxCount, multiple, maxSize, sizeType, lists, camera, compressed, maxDuration, sourceType
|
||
} = this;
|
||
let chooseFile = null;
|
||
const newMaxCount = maxCount - lists.length;
|
||
// 设置为只选择图片的时候使用 chooseImage 来实现
|
||
chooseFile = new Promise((resolve, reject) => {
|
||
uni.chooseImage({
|
||
count: multiple ? (newMaxCount > 9 ? 9 : newMaxCount) : 1,
|
||
sourceType: sourceType,
|
||
sizeType,
|
||
success: resolve,
|
||
fail: reject
|
||
});
|
||
});
|
||
chooseFile
|
||
.then((res) => {
|
||
let file = null;
|
||
let listOldLength = this.lists.length;
|
||
res.tempFiles.map((val, index) => {
|
||
// 如果是非多选,index大于等于1或者超出最大限制数量时,不处理
|
||
if (!multiple && index >= 1) return;
|
||
if (val.size > maxSize) {
|
||
this.$emit('on-oversize', val, this.lists);
|
||
this.showToast('超出允许的文件大小');
|
||
} else {
|
||
if(maxCount <= lists.length) {
|
||
this.$emit('on-exceed', val, this.lists);
|
||
this.showToast('超出最大允许的文件个数');
|
||
return ;
|
||
}
|
||
lists.push({
|
||
url: val.path,
|
||
progress: 0,
|
||
error: false
|
||
});
|
||
// 列表发生改变,发出事件,第二个参数为当前发生变化的项的索引
|
||
this.$emit('on-list-change', this.lists);
|
||
}
|
||
})
|
||
// 每次图片选择完,抛出一个事件,并将当前内部选择的图片数组抛出去
|
||
this.$emit('on-choose-complete', this.lists);
|
||
if(this.autoUpload) this.uploadFile(listOldLength);
|
||
})
|
||
.catch(error => {
|
||
// this.$emit('on-error', error);
|
||
});
|
||
},
|
||
// 提示用户消息
|
||
showToast(message, force = false) {
|
||
if(this.showTips || force) {
|
||
uni.showToast({
|
||
title: message,
|
||
icon: "none"
|
||
});
|
||
}
|
||
},
|
||
// 该方法供用户通过ref调用,手动上传
|
||
upload() {
|
||
this.uploadFile();
|
||
},
|
||
// 对失败的图片重新上传
|
||
retry(index) {
|
||
this.lists[index].progress = 0;
|
||
this.lists[index].error = false;
|
||
this.lists[index].response = null;
|
||
uni.showLoading({
|
||
title: '重新上传'
|
||
});
|
||
this.uploadFile(index);
|
||
},
|
||
// 上传图片
|
||
uploadFile(index = 0) {
|
||
if (this.disabled) return;
|
||
if(this.uploading) return ;
|
||
// 全部上传完成
|
||
if (index >= this.lists.length) {
|
||
this.$emit('on-uploaded', this.lists);
|
||
return ;
|
||
}
|
||
// 检查上传地址
|
||
if (!this.action) {
|
||
this.showToast('请配置上传地址', true);
|
||
return;
|
||
}
|
||
// 检查是否是已上传或者正在上传中
|
||
if (this.lists[index].progress == 100) {
|
||
if(this.autoUpload == false) this.uploadFile(index + 1);
|
||
return;
|
||
}
|
||
this.lists[index].error = false;
|
||
this.uploading = true;
|
||
// 创建上传对象
|
||
const task = uni.uploadFile({
|
||
url: this.action,
|
||
filePath: this.lists[index].url,
|
||
name: this.name,
|
||
formData: this.formData,
|
||
header: this.header,
|
||
success: (res) => {
|
||
if (![200,201].includes(res.statusCode)) {
|
||
this.uploadError(index, res.data);
|
||
} else {
|
||
// 上传成功
|
||
this.lists[index].response = res.data;
|
||
this.lists[index].progress = 100;
|
||
this.lists[index].error = false;
|
||
this.$emit('on-success', res.data, index, this.lists);
|
||
}
|
||
},
|
||
fail: (e) => {
|
||
this.uploadError(index, e);
|
||
},
|
||
complete: (res) => {
|
||
uni.hideLoading();
|
||
this.uploading = false;
|
||
this.uploadFile(index + 1);
|
||
this.$emit('on-change', res, index, this.lists);
|
||
}
|
||
});
|
||
task.onProgressUpdate((res) => {
|
||
if (res.progress > 0) {
|
||
this.lists[index].progress = res.progress;
|
||
this.$emit('on-progress', res, index, this.lists);
|
||
}
|
||
});
|
||
},
|
||
// 上传失败
|
||
uploadError(index, err) {
|
||
this.lists[index].progress = 0;
|
||
this.lists[index].error = true;
|
||
this.lists[index].response = null;
|
||
this.$emit('on-error', err, index, this.lists);
|
||
this.showToast('上传失败,请重试');
|
||
},
|
||
// 删除一个图片
|
||
deleteItem(index) {
|
||
uni.showModal({
|
||
title: '提示',
|
||
content: '您确定要删除此项吗?',
|
||
success: res => {
|
||
if (res.confirm) {
|
||
if (this.lists[index].process < 100 && this.lists[index].process > 0) {
|
||
typeof this.lists[index].uploadTask != 'undefined' && this.lists[index].uploadTask.abort();
|
||
}
|
||
this.lists.splice(index, 1);
|
||
this.$forceUpdate();
|
||
this.$emit('on-remove', index, this.lists);
|
||
this.showToast('移除成功');
|
||
// 列表发生改变,发出事件
|
||
this.$emit('on-list-change', this.lists);
|
||
}
|
||
}
|
||
});
|
||
},
|
||
// 用户通过ref手动的形式,移除一张图片
|
||
remove(index) {
|
||
// 判断索引的合法范围
|
||
if(index >= 0 && index < this.lists.length) {
|
||
this.lists.splice(index, 1);
|
||
this.$emit('on-list-change', this.lists);
|
||
}
|
||
},
|
||
// 预览图片
|
||
doPreviewImage(url, index) {
|
||
if (!this.previewFullImage)
|
||
return;
|
||
const images = this.lists.map(item => item.url || item.path);
|
||
uni.previewImage({
|
||
urls: images,
|
||
current: url,
|
||
success: () => {
|
||
this.$emit('on-preview', url, this.lists);
|
||
},
|
||
fail: () => {
|
||
uni.showToast({
|
||
title: '预览图片失败',
|
||
icon: 'none'
|
||
});
|
||
}
|
||
});
|
||
}
|
||
}
|
||
}
|
||
</script>
|
||
|
||
<style lang="scss" scoped>
|
||
.u-upload {
|
||
display: flex;
|
||
flex-wrap: wrap;
|
||
align-items: center;
|
||
}
|
||
|
||
.u-list-item {
|
||
width: 200rpx;
|
||
height: 200rpx;
|
||
overflow: hidden;
|
||
margin: 10rpx;
|
||
background: rgb(244, 245, 246);
|
||
position: relative;
|
||
border-radius: 10rpx;
|
||
display: inline-flex;
|
||
align-items: center;
|
||
justify-content: center;
|
||
}
|
||
|
||
.u-preview-wrap {
|
||
border: 1px solid rgb(235, 236, 238);
|
||
}
|
||
|
||
.u-add-wrap {
|
||
flex-direction: column;
|
||
color: $u-content-color;
|
||
font-size: 28rpx;
|
||
}
|
||
|
||
.u-add-tips {
|
||
margin-top: 20rpx;
|
||
}
|
||
|
||
.u-add-wrap__hover {
|
||
background-color: rgb(235, 236, 238);
|
||
}
|
||
|
||
.u-preview-image {
|
||
display: block;
|
||
width: 100%;
|
||
height: 100%;
|
||
}
|
||
|
||
.u-delete-icon {
|
||
position: absolute;
|
||
top: 10rpx;
|
||
right: 10rpx;
|
||
z-index: 10;
|
||
background-color: $u-type-error;
|
||
border-radius: 100rpx;
|
||
width: 44rpx;
|
||
height: 44rpx;
|
||
display: flex;
|
||
align-items: center;
|
||
justify-content: center;
|
||
}
|
||
|
||
.u-icon {
|
||
display: flex;
|
||
align-items: center;
|
||
justify-content: center;
|
||
}
|
||
|
||
.u-progress {
|
||
position: absolute;
|
||
bottom: 10rpx;
|
||
left: 8rpx;
|
||
right: 8rpx;
|
||
z-index: 9;
|
||
width: auto;
|
||
}
|
||
|
||
.u-error-btn {
|
||
color: #FFFFFF;
|
||
background-color: $u-type-error;
|
||
font-size: 20rpx;
|
||
padding: 4px 0;
|
||
text-align: center;
|
||
position: absolute;
|
||
bottom: 0;
|
||
left: 0;
|
||
right: 0;
|
||
z-index: 9;
|
||
line-height: 1;
|
||
}
|
||
</style>
|