快捷導(dǎo)航

Vue上傳組件vue Simple Uploader的用法示例

更新時(shí)間：2017年08月25日 10:53:06 作者：dolymood的博客

本篇文章主要介紹了Vue上傳組件vue Simple Uploader的用法示例，非常具有實(shí)用價(jià)值，需要的朋友可以參考下

在日常開(kāi)發(fā)中經(jīng)常會(huì)遇到文件上傳的需求，vue-simple-uploader 就是一個(gè)基于 simple-uploader.js 和 Vue 結(jié)合做的一個(gè)上傳組件，自帶 UI，可覆蓋、自定義；先來(lái)張動(dòng)圖看看效果：

其主要特點(diǎn)就是：

支持文件、多文件、文件夾上傳
支持拖拽文件、文件夾上傳
統(tǒng)一對(duì)待文件和文件夾，方便操作管理
可暫停、繼續(xù)上傳
錯(cuò)誤處理
支持“快傳”，通過(guò)文件判斷服務(wù)端是否已存在從而實(shí)現(xiàn)“快傳”
上傳隊(duì)列管理，支持最大并發(fā)上傳
分塊上傳
支持進(jìn)度、預(yù)估剩余時(shí)間、出錯(cuò)自動(dòng)重試、重傳等操作

安裝

通過(guò)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: {
     // 可通過(guò) https://github.com/simple-uploader/Uploader/tree/develop/samples/Node.js 示例啟動(dòng)服務(wù)
     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

上傳根組件，可理解為一個(gè)上傳器。

Props

options {Object}

參考 simple-uploader.js 配置。

autoStart {Boolean}

默認(rèn) true, 是否選擇文件后自動(dòng)開(kāi)始上傳。

事件

upload-start 開(kāi)始上傳。
file-added(file) 添加了一個(gè)文件，一般用作文件校驗(yàn)，如果給 file 增加 ignored 屬性為 true 的話就會(huì)被過(guò)濾掉。
file-removed(file) 移除一個(gè)文件（文件夾）。
files-submitted(files, fileList) 所選擇的文件們添加到上傳隊(duì)列后觸發(fā)。

作用域插槽

files {Array}純文件列表，沒(méi)有文件夾概念。
fileList {Array}統(tǒng)一對(duì)待文件、文件夾列表。
started是否開(kāi)始上傳了。

UploaderBtn

點(diǎn)選上傳文件按鈕。

Props

directory {Boolean}

默認(rèn) false, 是否是文件夾上傳。

single {Boolean}

默認(rèn) false, 如果設(shè)為 true，則代表一次只能選擇一個(gè)文件。

attrs {Object}

默認(rèn) {}, 添加到 input 元素上的額外屬性。

UploaderDrop

拖拽上傳區(qū)域。

UploaderList

文件、文件夾列表，同等對(duì)待。

作用域插槽

fileList {Array}

文件、文件夾組成數(shù)組。

UploaderUnsupport

不支持 HTML5 File API 的時(shí)候會(huì)顯示。

UploaderFiles

文件列表，沒(méi)有文件夾概念，純文件列表。

Props

file {Uploader.File}

封裝的文件實(shí)例。

list {Boolean}

如果是在 UploaderList 組件中使用的話，請(qǐng)?jiān)O(shè)置為 true。

作用域插槽

file {Uploader.File}文件實(shí)例。
list {Boolean}是否在 UploaderList 組件中使用。
status {String}當(dāng)前狀態(tài)，可能是：success, error, uploading, paused, waiting
name {String}文件名字。
paused {Boolean}是否暫停了。
error {Boolean}是否出錯(cuò)了。
averageSpeed {Number}平均上傳速度，單位字節(jié)每秒。
formatedAverageSpeed {String}格式化后的平均上傳速度，類(lèi)似：3 KB / S。
currentSpeed {Number}當(dāng)前上傳速度，單位字節(jié)每秒。
isComplete {Boolean}是否已經(jīng)上傳完成。
isUploading {Boolean}是否在上傳中。
size {Number}文件或者文件夾大小。
formatedSize {Number}格式化后文件或者文件夾大小，類(lèi)似：10 KB.
uploadedSize {Number}已經(jīng)上傳大小，單位字節(jié)。
progress {Number}介于 0 到 1 之間的小數(shù)，上傳進(jìn)度。
progressStyle {String}進(jìn)度樣式，transform 屬性，類(lèi)似：{transform: '-50%'}.
progressingClass {String}正在上傳中的時(shí)候值為：uploader-file-progressing。
timeRemaining {Number}預(yù)估剩余時(shí)間，單位秒。
formatedTimeRemaining {String}格式化后剩余時(shí)間，類(lèi)似：3 miniutes.
type {String}文件類(lèi)型。
extension {String}文件名后綴，小寫(xiě)。
fileCategory {String}文件分類(lèi)，其中之一：folder, document, video, audio, image, unknown。