欢迎您访问程序员文章站本站旨在为大家提供分享程序员计算机编程知识!
您现在的位置是: 首页  >  IT编程

Vue上传组件vue Simple Uploader的用法示例

程序员文章站 2022-04-29 08:10:26
在日常开发中经常会遇到文件上传的需求,vue-simple-uploader 就是一个基于 simple-uploader.js 和 vue 结合做的一个上传组件,自带 u...

在日常开发中经常会遇到文件上传的需求,vue-simple-uploader 就是一个基于 simple-uploader.js 和 vue 结合做的一个上传组件,自带 ui,可覆盖、自定义;先来张动图看看效果:

Vue上传组件vue Simple Uploader的用法示例

其主要特点就是:

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

安装

通过npm安装:npm install vue-simple-uploader --save即可。

使用

初始化

import vue from 'vue'
import uploader from 'vue-simple-uploader'
import app from './app.vue'

vue.use(uploader)

/* eslint-disable no-new */
new vue({
 render(createelement) {
  return createelement(app)
 }
}).$mount('#app')

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 {
  data () {
   return {
    options: {
     // 可通过 https://github.com/simple-uploader/uploader/tree/develop/samples/node.js 示例启动服务
     target: '//localhost:3000/upload',
     testchunks: false
    },
    attrs: {
     accept: 'image/*'
    }
   }
  }
 }
</script>

<style>
 .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>

组件

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}

文件、文件夹组成数组。

uploaderunsupport

不支持 html5 file api 的时候会显示。

uploaderfiles

文件列表,没有文件夹概念,纯文件列表。

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。

项目

地址:。

以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持。