Element el-upload上傳元件詳解
最近學習Element架構,在處理上傳圖檔時發現的一篇好文,轉發一下做個筆記。
作者:崗伯伯
連結:https://www.jianshu.com/p/84b727a4b58a
來源:簡書
upload上傳是前端開發很常用的一個功能,在Vue開發中常用的Element元件庫也提供了非常好用的upload元件。
基本用法
代碼:
<el-upload :action="uploadActionUrl">
<el-button size="small" type="primary">點選上傳</el-button>
</el-upload>
這個基本不用說,:action是執行上傳動作的背景接口,el-button是觸發上傳的按鈕。
上傳檔案數量
首先是設定是否可以同時選中多個檔案上傳,這個也是的屬性,添加multiple即可。另外el-upload元件提供了:limit屬性來設定最多可以上傳的檔案數量,超出此數量後選擇的檔案是不會被上傳的。:on-exceed綁定的方法則是處理超出數量後的動作。代碼如下:
<el-upload
:action="uploadActionUrl"
multiple
:limit="3"
:on-exceed="handleExceed">
<el-button size="small" type="primary">點選上傳</el-button>
</el-upload>
上傳格式及大小限制
如果需要限制上傳檔案的格式,需要添加accept屬性,這個是直接使用一樣的屬性了,accept屬性的值可以是accept="image/gif, image/jpeg, text/plain, application/pdf"等等。檔案格式的提示,則可以使用slot。代碼如下:
<el-upload
:action="uploadActionUrl"
accept="image/jpeg,image/gif,image/png"
multiple
:limit="3"
:on-exceed="handleExceed">
<el-button size="small" type="primary">點選上傳</el-button>
<div slot="tip" class="el-upload__tip">請上傳圖檔格式檔案</div>
</el-upload>
注意這裡隻是選擇檔案時限制格式,其實使用者還是可以點選“所有檔案”選項,上傳其他格式。如果需要在在上傳時再次校驗,擇需要在:before-upload這個鈎子綁定相應的方法來校驗,代碼如下:
<el-upload
:action="uploadActionUrl"
accept="image/jpeg,image/gif,image/png"
:before-upload="onBeforeUpload"
multiple
:limit="3"
:on-exceed="handleExceed">
<el-button size="small" type="primary">點選上傳</el-button>
<div slot="tip" class="el-upload__tip">請上傳圖檔格式檔案</div>
</el-upload>
onBeforeUpload(file)
{
const isIMAGE = file.type === 'image/jpeg'||'image/gif'||'image/png';
const isLt1M = file.size / 1024 / 1024 < 1;
if (!isIMAGE) {
this.$message.error('上傳檔案隻能是圖檔格式!');
}
if (!isLt1M) {
this.$message.error('上傳檔案大小不能超過 1MB!');
}
return isIMAGE && isLt1M;
}
這裡在限制檔案格式的同時,也做了檔案大小的校驗。
上傳過程中的各種鈎子
這裡直接搬運官網的說明了,如圖:
![](https://img.laitimes.com/img/_0nNw4CM6IyYiwiM6ICdiwiI3pVdC5GTrJkeZRTVt5keNpXWoRGVZtmSy4kaxMlT4NGROJzYE1Ee4k3YsR2VZRHbyg1aGJjYzJEWkZHOXFWdVhUY6VzVZBHctxkeWJjWoFzVhRXUXlld4d0YxkTeMZTTINGMShUYvwlbj5yZtlmbkN3YuQnclZnbvN2Ztl2Lc9CX6MHc0RHaiojIsJye.jpg)
顯示已上傳檔案清單
這個功能可以說很強大了,可以很清晰的顯示已上傳的檔案清單,并且可以友善的删除,以便上傳新的檔案。
代碼:
<el-upload
:action="uploadActionUrl"
accept="image/jpeg,image/gif,image/png"
multiple
:limit="3"
:on-exceed="handleExceed"
:on-error="uploadError"
:on-success="uploadSuccess"
:on-remove="onRemoveTxt"
:before-upload="onBeforeUpload"
:file-list="files">
<el-button size="small" type="primary">點選上傳</el-button>
<div slot="tip" class="el-upload__tip">請上傳圖檔格式檔案</div>
</el-upload>
實作方法就是:file-list="files"這個屬性的添加,其中files是綁定的數組對象,初始為空。
效果如下圖:
上傳時送出資料
上傳檔案同時需要送出資料給背景接口,這時就要用到:data屬性。
<el-upload
:action="uploadActionUrl"
accept="image/jpeg,image/gif,image/png"
multiple
:limit="3"
:data="uploadData"
:on-exceed="handleExceed"
:on-error="uploadError"
:on-success="uploadSuccess"
:on-remove="onRemoveTxt"
:before-upload="onBeforeUpload"
:file-list="files">
<el-button size="small" type="primary">點選上傳</el-button>
<div slot="tip" class="el-upload__tip">請上傳圖檔格式檔案</div>
</el-upload>
uploadData: {
dataType: "0",
oldFilePath:""
}
選取和上傳分開處理
有時我們需要把選取和上傳分開處理,比如上傳圖檔,先選取檔案送出到前端,圖檔處理後再把base64内容送出到背景。
代碼如下:
<el-upload
action=""
accept="image/jpeg,image/gif,image/png"
:on-change="onUploadChange"
:auto-upload="false"
:show-file-list="false">
<el-button slot="trigger" size="small" type="primary">選取</el-button>
<el-button style="margin-left: 10px;" size="small" type="success" @click="submitUpload">上傳</el-button>
</el-upload>
submitUpload()
{
console.log("submit")
},
onUploadChange(file)
{
const isIMAGE = (file.raw.type === 'image/jpeg' || file.raw.type === 'image/png'|| file.raw.type === 'image/gif');
const isLt1M = file.size / 1024 / 1024 < 1;
if (!isIMAGE) {
this.$message.error('上傳檔案隻能是圖檔格式!');
return false;
}
if (!isLt1M) {
this.$message.error('上傳檔案大小不能超過 1MB!');
return false;
}
var reader = new FileReader();
reader.readAsDataURL(file.raw);
reader.onload = function(e){
console.log(this.result)//圖檔的base64資料
}
}
效果如圖:
作者:崗伯伯
連結:https://www.jianshu.com/p/84b727a4b58a
來源:簡書
簡書著作權歸作者所有,任何形式的轉載都請聯系作者獲得授權并注明出處。