Vue上傳組件vue Simple Uploader的用法示例
在日常開發(fā)中經(jīng)常會遇到文件上傳的需求,vue-simple-uploader 就是一個基于 simple-uploader.js 和 Vue 結(jié)合做的一個上傳組件,自帶 UI,可覆蓋、自定義;先來張動圖看看效果:
其主要特點(diǎn)就是:
- 支持文件、多文件、文件夾上傳
- 支持拖拽文件、文件夾上傳
- 統(tǒng)一對待文件和文件夾,方便操作管理
- 可暫停、繼續(xù)上傳
- 錯誤處理
- 支持“快傳”,通過文件判斷服務(wù)端是否已存在從而實(shí)現(xiàn)“快傳”
- 上傳隊(duì)列管理,支持最大并發(fā)上傳
- 分塊上傳
- 支持進(jìn)度、預(yù)估剩余時間、出錯自動重試、重傳等操作
安裝
通過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 示例啟動服務(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
上傳根組件,可理解為一個上傳器。
Props
options {Object}
參考 simple-uploader.js 配置。
autoStart {Boolean}
默認(rèn) true, 是否選擇文件后自動開始上傳。
事件
- upload-start 開始上傳。
- file-added(file) 添加了一個文件,一般用作文件校驗(yàn),如果給 file 增加 ignored 屬性為 true 的話就會被過濾掉。
- file-removed(file) 移除一個文件(文件夾)。
- files-submitted(files, fileList) 所選擇的文件們添加到上傳隊(duì)列后觸發(fā)。
作用域插槽
- files {Array}純文件列表,沒有文件夾概念。
- fileList {Array}統(tǒng)一對待文件、文件夾列表。
- started是否開始上傳了。
UploaderBtn
點(diǎn)選上傳文件按鈕。
Props
directory {Boolean}
默認(rèn) false, 是否是文件夾上傳。
single {Boolean}
默認(rèn) false, 如果設(shè)為 true,則代表一次只能選擇一個文件。
attrs {Object}
默認(rèn) {}, 添加到 input 元素上的額外屬性。
UploaderDrop
拖拽上傳區(qū)域。
UploaderList
文件、文件夾列表,同等對待。
作用域插槽
fileList {Array}
文件、文件夾組成數(shù)組。
UploaderUnsupport
不支持 HTML5 File API 的時候會顯示。
UploaderFiles
文件列表,沒有文件夾概念,純文件列表。
Props
file {Uploader.File}
封裝的文件實(shí)例。
list {Boolean}
如果是在 UploaderList 組件中使用的話,請?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}是否出錯了。
- averageSpeed {Number}平均上傳速度,單位字節(jié)每秒。
- formatedAverageSpeed {String}格式化后的平均上傳速度,類似:3 KB / S。
- currentSpeed {Number}當(dāng)前上傳速度,單位字節(jié)每秒。
- isComplete {Boolean}是否已經(jīng)上傳完成。
- isUploading {Boolean}是否在上傳中。
- size {Number}文件或者文件夾大小。
- formatedSize {Number}格式化后文件或者文件夾大小,類似:10 KB.
- uploadedSize {Number}已經(jīng)上傳大小,單位字節(jié)。
- progress {Number}介于 0 到 1 之間的小數(shù),上傳進(jìn)度。
- progressStyle {String}進(jìn)度樣式,transform 屬性,類似:{transform: '-50%'}.
- progressingClass {String}正在上傳中的時候值為:uploader-file-progressing。
- timeRemaining {Number}預(yù)估剩余時間,單位秒。
- formatedTimeRemaining {String}格式化后剩余時間,類似:3 miniutes.
- type {String}文件類型。
- extension {String}文件名后綴,小寫。
- fileCategory {String}文件分類,其中之一:folder, document, video, audio, image, unknown。
項(xiàng)目
地址:https://github.com/simple-uploader/vue-uploader。
以上就是本文的全部內(nèi)容,希望對大家的學(xué)習(xí)有所幫助,也希望大家多多支持腳本之家。
相關(guān)文章
vue2 el-checkbox-group復(fù)選框無法選中問題及解決
這篇文章主要介紹了vue2 el-checkbox-group復(fù)選框無法選中問題及解決,具有很好的參考價值,希望對大家有所幫助,如有錯誤或未考慮完全的地方,望不吝賜教2024-05-05Vue?uni-app框架實(shí)現(xiàn)上拉加載下拉刷新功能
uni-app是一個使用Vue.js(opens?new?window)開發(fā)所有前端應(yīng)用的框架,開發(fā)者編寫一套代碼,可發(fā)布到iOS、Android、Web(響應(yīng)式)、以及各種小程序(微信/支付寶/百度/頭條/飛書/QQ/快手/釘釘/淘寶)、快應(yīng)用等多個平臺2022-09-09Vue3使用hooks函數(shù)實(shí)現(xiàn)代碼復(fù)用詳解
這篇文章主要介紹了Vue3使用hooks函數(shù)實(shí)現(xiàn)代碼復(fù)用詳解,Vue3的hook函數(shù)可以幫助我們提高代碼的復(fù)用性,?讓我們能在不同的組件中都利用hooks函數(shù)2022-06-06vue項(xiàng)目中vue-i18n和element-ui國際化開發(fā)實(shí)現(xiàn)過程
這篇文章主要介紹了vue項(xiàng)目中vue-i18n和element-ui國際化開發(fā)實(shí)現(xiàn)過程,非常不錯,具有參考借鑒價值,需要的朋友可以參考下2018-04-04Vuex數(shù)據(jù)持久化實(shí)現(xiàn)的思路與代碼
Vuex數(shù)據(jù)持久化可以很好的解決全局狀態(tài)管理,當(dāng)刷新后數(shù)據(jù)會消失,這是我們不愿意看到的。這篇文章主要給大家介紹了關(guān)于Vuex數(shù)據(jù)持久化實(shí)現(xiàn)的思路與代碼,需要的朋友可以參考下2021-05-05