# vue-simple-uploader
https://github.com/simple-uploader/vue-uploader/blob/master/README_zh-CN.md

# simple-uploader
https://github.com/simple-uploader/Uploader/blob/develop/README_zh-CN.md#%E9%85%8D%E7%BD%AE

具體使用建議看博客的另外兩篇文章【uploader】

然后如果想要參考博主對該組件的使用的探索過程以及使用情況，可以查看主頁中的uploader的幾篇文章，那是簡單記錄自己對該組件的探索。文章來源地址http://www.zghlxwxcb.cn/news/detail-408729.html

1.vue-simple-uploader介紹

超級強大的上傳文件的前端vue組件，相比elementui的upload組件，其能滿足絕大多數(shù)的文件上傳需求。包括斷續(xù)重傳等常見業(yè)務(wù)。而elementui的upload組件很多功能都不能實現(xiàn)。但是兩者可以相互兼容著使用。

• 支持文件、多文件、文件夾上傳
• 支持拖拽文件、文件夾上傳
• 可暫停、繼續(xù)上傳
• 支持?jǐn)帱c續(xù)傳、秒傳
• 支持進度、預(yù)估剩余時間、出錯自動重試、重傳等操作
• 上傳隊列管理，支持最大并發(fā)上傳，支持分塊上傳

為了方便查看，這里copy一下quickstart代碼，uploader只有這幾個標(biāo)簽，但是會有很多屬性和方法。

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

2.安裝和配置

npm install vue-simple-uploader --save

# 在main.js中
import uploader from 'vue-simple-uploader'
Vue.use(uploader)

3. 組件標(biāo)簽的文檔整理

一共有如下幾個標(biāo)簽：

• uploader

• uploader-btn

• uploader-drop

• uploader-list

• uploader-file

3.1 uploader標(biāo)簽

根組件標(biāo)簽，可理解為一個上傳器

Props屬性：

補充options的可配置項【常用的優(yōu)先，△標(biāo)記為重要，其他沒寫的都是默認為最優(yōu)】：

Slot事件：

methods方法：

需要得到uploader實例

# 我們先給uploader標(biāo)簽指定ref
<uploader :options="options" class="uploader-example" ref="uploader">
# 然后可以從當(dāng)前vue組件的子組件refs列表里獲取uploader組件，uploader組件有個uploader屬性表示uploader組件本身
const uploaderInstance = this.$refs.uploader.uploader
# 然后實例.方法就可以使用了

3.2 uploader-btn標(biāo)簽

點擊后能夠展示文件選擇器的按鈕。一般就只使用directory參數(shù)

props屬性：

3.3 uploader-drop標(biāo)簽

聲明該區(qū)域允許拖動文件進來后上傳

3.4 uploader-list標(biāo)簽

一個列表外標(biāo)簽，類似于form一樣，僅僅是用來裝載uploader-file組件的容器。
下面有使用演示

3.5 uploader-file標(biāo)簽

就是你拉取后的一個文件單位對象，可以展示，擁有自己的很多屬性可以展示。

Props屬性：

slot插槽：就是通過file對象能直接的file信息

簡單演示一下list和file的使用，用于可視化文件上傳進度

• uploader設(shè)置自動上傳為false: `autoStart=“false”
• 在uploader內(nèi)引入uploader-list
• 通過slot-scope綁定文件實例，選擇文件后自動傳遞實例
• v-for展示uploader-file即可，file實例的屬性、方法和事件看上方文檔，自己設(shè)計可視化即可

<uploader 
	:options="this.options" 
	@file-added="this.fileAdded" 
	@file-error="this.fileError" 
	@file-success="this.fileSuccess" 
	:autoStart="false">
	<uploader-unsupport></uploader-unsupport>
	<uploader-btn class="uploader-btn">點擊上傳</uploader-btn>
	 
	<uploader-list>
		<!--通過slot-scope綁定文件實例-->
	     <div slot-scope="props">
	         <div v-for="(file,i) in props.fileList" :key="i">
	             <uploader-file :list="true" :file="file"></uploader-file>
	         </div>
	     </div>
	 </uploader-list>
</uploader>

原生的效果長這樣。

3.6 uploader-unsopport標(biāo)簽

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

一般就寫在uploader根組件里就行了，遇到低版本的瀏覽器不兼容組件的時候才會展示。

<uploader :options="options" class="uploader-example">
	<uploader-unsupport></uploader-unsupport>
    
</uploader>

4.請求中的參數(shù)

可通過 query 參數(shù)配置擴充，也可以通過 processParams 自定義

• chunkNumber，當(dāng)前分片
• chunkSize，分片上限大小
• currentChunkSize，當(dāng)前分片的真實大小
• totalSize，文件總大小
• identifier，唯一標(biāo)識，可自定義
• filename，文件名
• totalChunks，總分片數(shù)量
• 從totalChunks往下，是自己在options配置中配置的query參數(shù)，比如我配置了curUrl這個參數(shù)

然后如果想要參考博主對該組件的使用的探索過程以及使用情況，可以查看主頁中的uploader的幾篇文章，那是簡單記錄自己對該組件的探索。

到了這里，關(guān)于【uploader】表格化自整理vue-simple-uploader的文檔（超詳細）的文章就介紹完了。如果您還想了解更多內(nèi)容，請在右上角搜索TOY模板網(wǎng)以前的文章或繼續(xù)瀏覽下面的相關(guān)文章，希望大家以后多多支持TOY模板網(wǎng)！