多图上传（兼容小程序只能单图上传） - 开发uniapp项目，遇到的问题（兼容H5，微信/支付宝小程序）

Demo：uni-app template GitHub Address

Tips

---

2020/12/07 后期有支付宝小程序业务，该组件兼容哦~~~亲测有效

问题

---

需求中，需要上传多张图片，但是微信小程序只能单图上传，多图上传只支持App、H5。

如果只能一张一张上传图片的话，用户体验相当差，我相信上传的用户，会疯的……

思路

---

对此官方文档也给出了解决方案，就是重复调用api uni.uploadFile

解决方法

---

我使用了uni-app插件市场中luck-request插件（仿axios封装request网络请求库，支持拦截器以及task操作），对于uni.uploadFile，也有封装。

在此，我在api.js的文件中又定义封装了上传图片的方法。

// 上传图片，接口名称根据自己后端定义，此接口调用不通
export const uploadToOss = (params) => axios.upload('/api/upload/xxx', {
    ...params,
    custom: {
        loading: true,
        loadingTitle: '正在上传...'
    }
})

UploadPic.vue

<template>
    <view class="upload_box">
        <view class="image_list">
            <view class="image_item" v-for="(item, index) in files" :key="index">
                <view class="icon iconfont iconshanchu" @click="removeItem(index)"></view>
                <image :src="item"></image>
            </view>
            <view class="upload" v-if="files.length < limit" @click="handleUpload">
                <view class="icon iconfont iconshangchuan"></view>
                <text>{{ btnText }}</text>
            </view>
        </view>
        <view class="upload_tip" v-if="tip">{{ tip }}</view>
    </view>
</template>

<script>
import { uploadToOss } from '@/api/http';

export default {
    props: {
        // 提示信息
        tip: {
            type: String,
            default: ''
        },
        // 按钮文字
        btnText: {
            type: String,
            default: ''
        },
        // 最多限制张数，默认1张
        limit: {
            type: Number,
            default: 1
        },
        // 图片类型，用于同个页面多个图片上传组件区分
        imgType: {
            type: String,
            default: 'image'
        }
    },
    data() {
        return {
            files: [] // 上传图片后的图片地址集合
        };
    },
    methods: {
        /**
         * @description 删除图片
         * @param {Number} index 图片所在索引值
         */
        removeItem(index) {
            this.files.splice(index, 1);
            this.sendMessage(); // 发送信息父组件
        },
        /**
         * @description 上传图片
         * @param {String} url 图片临时地址
         */
        uploadImg(url) {
            return new Promise((resolve, reject) => {
                uploadToOss({
                    filePath: url,
                    fileType: 'image',
                    name: 'file',
                }).then(res => {
                    if(res._OK) {
                        resolve(res.data.data);
                    } else {
                        uni.showModal({
                            title: '提示',
                            content: res.data.message || '上传失败'
                        })
                        
                        return new Promise.reject(res);
                    }
                }).catch(err => {
                    return new Promise.reject(err);
                })
            })
        },
        
        /**
         * @description 遍历调用upload接口
         * @param {Array} tempFilePaths uni.chooseImage选择图片后返回的临时图片地址集合
         * @returns {Array} arr 异步调用upload接口返回的图片服务器上的地址集合
         */
        async uploads(tempFilePaths) {
            let arr = [];
            for(let i = 0; i < tempFilePaths.length; i++) {
                arr[i] = await this.uploadImg(tempFilePaths[i]);
            }
            
            return arr;
        },
        
        /**
         * @description 上传图片
         */
        handleUpload() {
            let _this = this;
            
            uni.chooseImage({
                count: _this.limit,
                async success(chooseImageRes) {
                    // 选择图片后，立即调用图片上传的接口，es6的await必须被async包含。
                    let files = await _this.uploads(chooseImageRes.tempFilePaths);

                    _this.files = [..._this.files, ...files];
                    _this.sendMessage(); // 发送信息父组件
                }
            });
        },
        /**
         * @description 发送信息给父组件
         */
        sendMessage() {
            this.$emit('on-change', {
                files: this.files,
                imgType: this.imgType
            });
        }
    }
};
</script>

<style lang="scss" scoped>
.upload_box {
    .upload {
        width: 120rpx;
        height: 120rpx;
        border: 2rpx solid #d9d9d9;
        font-size: 24rpx;
        color: #999999;
        display: flex;
        justify-content: center;
        flex-direction: column;
        align-items: center;
        margin-bottom: 20rpx;

        .iconfont {
            margin-bottom: 8rpx;
        }
    }

    .image_list {
        display: flex;
        flex-wrap: wrap;

        .image_item {
            position: relative;
            width: 120rpx;
            height: 120rpx;
            margin: 0 20rpx 20rpx 0;
            z-index: 1;

            image {
                width: 120rpx;
                height: 120rpx;
            }

            .iconfont {
                color: #ff0000;
                font-size: 30rpx;
                position: absolute;
                z-index: 10;
                right: 0;
                top: 0;
            }
        }
    }
}

.upload_tip {
    color: #999999;
    font-size: 24rpx;
    margin-top: -10rpx;
}
</style>

总结

---

该多图上传组件的交互跟拓展性还不够好，但基本满足了目前产品的需求，之后还是会持续迭代更新的，也希望大家多多提意见😜😜😜