Vue 之上传组件 vue-simple-uploader

vue-simple-uploader 是一个基于 simple-uploader.js 和 Vue 结合做的一个上传组件，自带 UI，可覆盖、自定义。

特点：

支持文件、多文件、文件夹上传
支持拖拽文件、文件夹上传
统一对待文件和文件夹，方便操作管理
可暂停、继续上传
错误处理
支持“快传”，通过文件判断服务端是否已存在从而实现“快传”
上传队列管理，支持最大并发上传
分块上传
支持进度、预估剩余时间、出错自动重试、重传等操作
1
2
3
4
5
6
7
8
9

安装

npm install vue-simple-uploader --save
1

初始化

import uploader from 'vue-simple-uploader'
Vue.use(uploader)
1
2

App.vue

<template>
  <uploader :options="options" class="uploader-example">
    <uploader-unsupport></uploader-unsupport>
    <uploader-drop>
      <p>Drop files here to upload or</p>
      <uploader-btn>select files</uploader-btn>
      <uploader-btn :attrs="attrs">select images</uploader-btn>
      <uploader-btn :directory="true">select folder</uploader-btn>
    </uploader-drop>
    <uploader-list></uploader-list>
 </uploader>
</template>

<script>
export default {
  components:{
    
  },
  data(){
    return{
      options: {
        // 可通过 https://github.com/simple-uploader/Uploader/tree/develop/samples/Node.js 示例启动服务
        target: '//localhost:3000/upload',
        autoStart: false,
        testChunks: false
      },
      attrs: {
        accept: 'image/*'
      }
    }
  },
  methods:{
    
  }
}
</script>


<style lang="less">
.uploader-example {
  width: 880px;
  padding: 15px;
  margin: 40px auto 0;
  font-size: 12px;
  box-shadow: 0 0 10px rgba(0, 0, 0, .4);
}
.uploader-example .uploader-btn {
  margin-right: 4px;
}
.uploader-example .uploader-list {
  max-height: 440px;
  overflow: auto;
  overflow-x: hidden;
  overflow-y: auto;
}
</style>
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56

组件

Uploader：上传根组件，可理解为一个上传器。

Props：

• options {Object} 参考 simple-uploader.js 配置。
• autoStart {Boolean} 默认 true, 是否选择文件后自动开始上传。

事件：

• upload-start 开始上传。
• file-added(file) 添加了一个文件，一般用作文件校验，如果给 file 增加 ignored 属性为 true 的话就会被过滤掉。
• file-removed(file) 移除一个文件（文件夹）。
• files-submitted(files, fileList) 所选择的文件们添加到上传队列后触发。

作用域插槽：

• files {Array} 纯文件列表，没有文件夹概念。
• fileList {Array} 统一对待文件、文件夹列表。
• started 是否开始上传了。

UploaderBtn： 点选上传文件按钮。

Props：

• directory {Boolean} 默认 false, 是否是文件夹上传。
• single {Boolean} 默认 false, 如果设为 true，则代表一次只能选择一个文件。
• attrs {Object} 默认 {}, 添加到 input 元素上的额外属性。

UploaderDrop： 拖拽上传区域。

UploaderList： 文件、文件夹列表，同等对待。

作用域插槽：

• fileList {Array} 文件、文件夹组成数组。

UploaderFiles：文件列表，没有文件夹概念，纯文件列表。

作用域插槽：

• files {Array} 文件列表。

UploaderUnsupport ：不支持 HTML5 File API 的时候会显示。

UploaderFile：文件、文件夹单个组件。

Props：

• file {Uploader.File} 封装的文件实例。
• list {Boolean}
• 如果是在 UploaderList 组件中使用的话，请设置为 true。

作用域插槽：

• file {Uploader.File} 文件实例。
• list {Boolean} 是否在 UploaderList 组件中使用。
• status {String} 当前状态，可能是：success, error, uploading, paused, waiting
• name {String} 文件名字。
• paused {Boolean} 是否暂停了。
• error {Boolean} 是否出错了。
• averageSpeed {Number} 平均上传速度，单位字节每秒。
• formatedAverageSpeed {String} 格式化后的平均上传速度，类似：3 KB / S。
• currentSpeed {Number} 当前上传速度，单位字节每秒。
• isComplete {Boolean} 是否已经上传完成。
• isUploading {Boolean} 是否在上传中。
• size {Number} 文件或者文件夹大小。
• formatedSize {Number} 格式化后文件或者文件夹大小，类似：10 KB.
• uploadedSize {Number} 已经上传大小，单位字节。
• progress {Number} 介于 0 到 1 之间的小数，上传进度。
• progressStyle {String} 进度样式，transform 属性，类似：{transform: ‘-50%’}.
• progressingClass {String} 正在上传中的时候值为：uploader-file-progressing。
• timeRemaining {Number} 预估剩余时间，单位秒。
• formatedTimeRemaining {String} 格式化后剩余时间，类似：3 miniutes.
• type {String} 文件类型。
• extension {String} 文件名后缀，小写。
• fileCategory {String} 文件分类，其中之一：folder, document, video, audio, image, unknown。