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

其主要特點就是：

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

安裝

通過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) 所選擇的文件們添加到上傳隊列后觸發(fā)。

作用域插槽

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

UploaderBtn

點選上傳文件按鈕。

Props

directory {Boolean}

默認 false, 是否是文件夾上傳。

single {Boolean}

默認 false, 如果設為 true，則代表一次只能選擇一個文件。

attrs {Object}

默認 {}, 添加到 input 元素上的額外屬性。

UploaderDrop

拖拽上傳區(qū)域。

UploaderList

文件、文件夾列表，同等對待。

作用域插槽

fileList {Array}

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

UploaderUnsupport

不支持 HTML5 File API 的時候會顯示。

UploaderFiles

文件列表，沒有文件夾概念，純文件列表。

Props

file {Uploader.File}

封裝的文件實例。

list {Boolean}

如果是在 UploaderList 組件中使用的話，請設置為 true。

作用域插槽

• file {Uploader.File}文件實例。
• list {Boolean}是否在 UploaderList 組件中使用。
• status {String}當前狀態(tài)，可能是：success, error, uploading, paused, waiting
• name {String}文件名字。
• paused {Boolean}是否暫停了。
• error {Boolean}是否出錯了。
• averageSpeed {Number}平均上傳速度，單位字節(jié)每秒。
• formatedAverageSpeed {String}格式化后的平均上傳速度，類似：3 KB / S。
• currentSpeed {Number}當前上傳速度，單位字節(jié)每秒。
• isComplete {Boolean}是否已經(jīng)上傳完成。
• isUploading {Boolean}是否在上傳中。
• size {Number}文件或者文件夾大小。
• formatedSize {Number}格式化后文件或者文件夾大小，類似：10 KB.
• uploadedSize {Number}已經(jīng)上傳大小，單位字節(jié)。
• progress {Number}介于 0 到 1 之間的小數(shù)，上傳進度。
• 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。

項目

地址：https://github.com/simple-uploader/vue-uploader。

以上就是本文的全部內(nèi)容，希望對大家的學習有所幫助，也希望大家多多支持武林網(wǎng)。