在日常开发中经常会遇到文件上传的需求,vue-simple-uploader 就是一个基于 simple-uploader.js 和 Vue 结合做的一个上传组件,自带 UI,可覆盖、自定义;先来张动图看看效果:
其主要特点就是:
- 支持文件、多文件、文件夹上传@H_301_12@
- 支持拖拽文件、文件夹上传@H_301_12@
- 统一对待文件和文件夹,方便操作管理@H_301_12@
- 可暂停、继续上传@H_301_12@
- 错误处理@H_301_12@
- 支持“快传”,通过文件判断服务端是否已存在从而实现“快传”@H_301_12@
- 上传队列管理,支持最大并发上传@H_301_12@
- 分块上传@H_301_12@
- 支持进度、预估剩余时间、出错自动重试、重传等操作@H_301_12@
安装
通过npm安装:npm install vue-simple-uploader --save
即可。
使用
初始化
Vue.use(uploader)
/ eslint-disable no-new /
new Vue({
render(createElement) {
return createElement(App)
}
}).$mount('#app')
App.vue
Drop files here to upload or
组件
Uploader
Props
options {Object}
参考 simple-uploader.js 配置。
autoStart {Boolean}
事件
- upload-start 开始上传。@H_301_12@
- file-added(file) 添加了一个文件,一般用作文件校验,如果给 file 增加 ignored 属性为 true 的话就会被过滤掉。@H_301_12@
- file-removed(file) 移除一个文件(文件夹)。@H_301_12@
- files-submitted(files,fileList) 所选择的文件们添加到上传队列后触发。@H_301_12@
作用域插槽
- files {Array}纯文件列表,没有文件夹概念。@H_301_12@
- fileList {Array}统一对待文件、文件夹列表。@H_301_12@
- started是否开始上传了。@H_301_12@
UploaderBtn
Props
directory {Boolean}
single {Boolean}
默认 false,如果设为 true,则代表一次只能选择一个文件。
attrs {Object}
UploaderDrop
拖拽上传区域。
UploaderList
作用域插槽
fileList {Array}
UploaderUnsupport
UploaderFiles
Props
file {Uploader.File}
封装的文件实例。
list {Boolean}
如果是在 UploaderList 组件中使用的话,请设置为 true。
作用域插槽
- file {Uploader.File}文件实例。@H_301_12@
- list {Boolean}是否在 UploaderList 组件中使用。@H_301_12@
- status {String}当前状态,可能是:success,error,uploading,paused,waiting@H_301_12@
- name {String}文件名字。@H_301_12@
- paused {Boolean}是否暂停了。@H_301_12@
- error {Boolean}是否出错了。@H_301_12@
- averageSpeed {Number}平均上传速度,单位字节每秒。@H_301_12@
- formatedAverageSpeed {String}格式化后的平均上传速度,类似:3 KB / S。@H_301_12@
- currentSpeed {Number}当前上传速度,单位字节每秒。@H_301_12@
- isComplete {Boolean}是否已经上传完成。@H_301_12@
- isUploading {Boolean}是否在上传中。@H_301_12@
- size {Number}文件或者文件夹大小。@H_301_12@
- formatedSize {Number}格式化后文件或者文件夹大小,类似:10 KB.@H_301_12@
- uploadedSize {Number}已经上传大小,单位字节。@H_301_12@
- progress {Number}介于 0 到 1 之间的小数,上传进度。@H_301_12@
- progressStyle {String}进度样式,transform 属性,类似:{transform: '-50%'}.@H_301_12@
- progressingClass {String}正在上传中的时候值为:uploader-file-progressing。@H_301_12@
- timeRemaining {Number}预估剩余时间,单位秒。@H_301_12@
- formatedTimeRemaining {String}格式化后剩余时间,类似:3 miniutes.@H_301_12@
- type {String}文件类型。@H_301_12@
- extension {String}文件名后缀,小写。@H_301_12@
- fileCategory {String}文件分类,其中之一:folder,document,video,audio,image,unknown。@H_301_12@
项目
原文链接:https://www.f2er.com/vue/36849.html