Vue的移动端多图上传插件vue

Vue的移动端多图上传插件vue

前言

这段时间赶项目，需要用到多文件上传，用vue进行前端项目开发。在网上找了不少插件，都不是十分满意，有的使用起来繁琐，有的不能适应本项目。就打算自己折腾一下，写一个Vue的上传插件，一劳永逸，以后可以直接使用。

目前vue-easy-uploader已上传到github和NPM，使用起来方便简单，不需要繁琐的配置即可投入生产，不过需要后端配合，实现上传接口。

本项目GitHub地址: https://github.com/quanzaiyu/vue-easy-uploader

本项目NPM地址: https://npmjs.com/package/vue-easy-uploader

详细的使用方法都在仓库Readme中，就不赘述，这里谈下本插件的设计开发思路。

插件介绍

vue-easy-uploader是一个多图上传插件。主要特性包括:

多文件上传

上传图片预览

上传状态监测

删除指定图片

清空图片

重新上传

后期版本迭代将不限于图片，往通用文件上传进行改进。

先看看上传插件使用时候的效果图:

目录结构

index.js # 主入口文件

store.js # 状态管理

uploader.vue # 上传组件

文件解析

index.js

import uploader from './uploader'

import store from './store'

let plugin = {}

plugin.install = function (_Vue, _store) {

_Vue.component('uploader', uploader)

_store.registerModule('http://imgstore', store)

}

export default plugin

这是插件的主入口文件，注册了全局的上传组件和状态管理，使用时只需要在项目入口文件(一般是main.js)中加入以下代码即可引入此插件:

import Vue from 'vue'

import Vuex from 'vuex'

import uploader from 'vue-easy-uploader'

let store = new Vuex.Store({})

Vue.use(uploader, store)

store.js

此文件为状态管理配置文件，主要包含三个state:

img_upload_cache # 上传文件缓存

img_paths # 上传状态，包括 ready selected uploading finished

img_status # 上传后的路径反馈数组(数据结构为Set集合)

针对每个state都有自己的mutation，用于改变state，规范上mutation都需要使用大写字母加下划线的形式，本人习惯使用小写字母，不过都不是原则上的问题。

最重要的一个state是img_status，用于监视图片上传的状态。包括以下几个状态:

ready # 上传开始前的准备状态

selected # 已选择上传文件

uploading # 开始上传

finished # 上传完毕

在组件中可以通过改变上传状态实现文件的上传，同时也可以监听上传状态的变化而执行回调。如:

methods: {

upload () {

this.$store.commit('set_img_status', 'uploading')

},

submit () {

// some code

}

}

computed: {

...mapState({

imgStatus: state => state.imgstore.img_status

})

},

watch: {

imgStatus () {

if (this.imgStatus === 'finished') {

this.submit()

}

}

}

上述代码中，使用upload方法更新了上传状态，让图片开始执行上传操作，使用watch进行上传状态的监视，当上传完成(img_status状态变为finished)，执行回调函数submit。

源文件如下:

// Created by quanzaiyu on 2017/10/25 0025.

var state = {

img_upload_cache: [],

img_paths: [],

img_status: 'ready' // 上传状态 ready selected uploading finished

}

const actions = {}

const getters = {}

const mutations = {

set_img_upload_cache (state, arg) {

state.img_upload_cache = arg

},

set_img_paths (state, arg) {

state.img_paths = arg

},

set_img_status (state, arg) {

state.img_status = arg

}

}

export default {

state,

mutations,

actions,

getters

}

uploader.vue

先看源代码(为了节省空间，未贴出style部分的代码):

v-for="(file, index) in imgStore" :key="index"

class="file-item draggable-item"

>

+

+

data-role="none" accept="image/*"

@change="selectImgs"

ref="file"

>

@click="empty">

{{imgStatus === 'finished' ? '重新上传' : '清空'}}

@click="empty">

{{imgStatus === 'finished' ? '重新上传' : '清空'}}

以上代码中有一些注释序号，是此插件设计的主要思路，其他代码都比较容易理解，分别说下

① 选择文件后执行，img_status状态变为selected。

② 将带上传的图片文件转化为Base64格式，用于缩略图显示。

③ 创建一个表单对象，用于存储待上传的文件。

④ 注意这里的name属性值，暂时写死，后面设计打算从组件中指定name属性，如果是多文件的话，name属性的数组序号从0开始递增。

⑤ 未依赖任何Ajax请求插件，使用原生的XMLHttpRequest对象创建请求。

⑥ 存储上传成功后服务器返回的上传路径。

⑦ 检测上传状态，当在使用此插件时将img_status的状态设置为uploading时执行上传操作。

使用

参考本项目的GItHub和NPM。

注意

使用此插件时，需要与后端约定返回的数据格式，如下:

复制代码 代码如下:

[{"error":0,"url":"\/uploads\/api\/201711\/25\/fde412bd83d3ec5d6a49769bd0c143cd.jpg"},{"error":0,"url":"\/uploads\/api\/201711\/25\/c6fd51f0388c63a0b6d350331c945fb1.jpg"}]

预览如下:

返回的是一个上传后的路径数组，包括error和url字段，每个文件有自己的上传状态，当error为0的时候为上传成功，并返回上传后的路径url

改进

后续版本打算进行如下改进

把表单的name属性名称通过组件传递。

自定义上传成功后服务器响应的数据格式，比如自定义error的名称和其值所表示的状态。

支持其他类型文件的上传，可以在组件中自行制定上传的文件类型，及其预览方式。

版权声明：本文内容由网络用户投稿，版权归原作者所有，本站不拥有其著作权，亦不承担相应法律责任。如果您发现本站中有涉嫌抄袭或描述失实的内容，请联系我们jiasou666@gmail.com 处理，核实后本网站将在24小时内删除侵权内容。