作者: Tapas Adhikary
譯者:前端小智
來源:dev
點贊再看,養成習慣本文
GitHub
https://github.com/qq44924588... 上已經收錄,更多往期高贊文章的分類,也整理了很多我的文檔,和教程資料。歡迎Star和完善,大家面試可以參照考點復習,希望我們一起有點東西。
最近開源了一個 Vue 組件,還不夠完善,歡迎大家來一起完善它,也希望大家能給個 star 支持一下,謝謝各位了。
github 地址:https://github.com/qq44924588...
簡介
上傳文件功能可以說是項目經常出現的需求。從在社交媒體上上傳照片到在求職網站上發布簡歷,文件上傳無處不在。在本文中,我們將討論 HTML文件上傳支持的10種用法,希望對你有用。
1. 單文件上傳
我們可以將input
類型指定為file
,以在Web應用程序中使用文件上傳功能。
<input type="file" id="file-uploader">
input filte
提供按鈕上傳一個或多個文件。 默認情況下,它使用操作系統的本機文件瀏覽器上傳單個文件。成功上傳后,File API
使得可以使用簡單的 JS 代碼讀取File
對象。 要讀取File
對象,我們需要監聽 change
事件。
首先,通過id
獲取文件上傳的實例:
const fileUploader = document.getElementById('file-uploader');
然后添加一個change
事件偵聽器,以在上傳完成后讀取文件對象, 我們從event.target.files
屬性獲取上傳的文件信息:
fileUploader.addEventListener('change', (event) => {
const files = event.target.files;
console.log('files', files);
});
在控制臺中觀察輸出結果,這里關注一下FileList
數組和File
對象,該對象具有有關上傳文件的所有元數據信息。
如果大家看到這里,有點激動,想手賤一下,可以 CodePen 玩玩,地址:https://codepen.io/atapas/pen...
2. 多文件上傳
如果我們想上傳多個文件,需要在標簽上添加 multiple
屬性:
<input type="file" id="file-uploader" multiple />
現在,我們可以上傳多個文件了,以前面事例為基礎,選擇多個文件上傳后,觀察一下控制臺的變化:
如果大家看到這里,有點激動,想手賤一下,可以 CodePen 玩玩,地址:https://codepen.io/atapas/pen...
3.了解文件元數據
每當我們上傳文件時,File
對象都有元數據信息,例如file name
,size
,last update time,type 等等。這些信息對于進一步的驗證和特殊處理很有用。
const fileUploader = document.getElementById('file-uploader');
// 聽更 change 件并讀取元數據
fileUploader.addEventListener('change', (event) => {
// 獲取文件列表數組
const files = event.target.files;
// 遍歷并獲取元數據
for (const file of files) {
const name = file.name;
const type = file.type ? file.type: 'NA';
const size = file.size;
const lastModified = file.lastModified;
console.log({ file, name, type, size, lastModified });
}
});
下面是單個文件上傳的輸出結果:
如果大家看到這里,有點激動,想手賤一下,可以 CodePen 玩玩,地址:https://codepen.io/atapas/pen...
4.了解 accept
屬性
我們可以使用accept
屬性來限制要上載的文件的類型,如果只想上傳的文件格式是 .jpg
,.png
時,可以這么做:
<input type="file" id="file-uploader" accept=".jpg, .png" multiple>
在上面的代碼中,只能選擇后綴是.jpg
和.png
的文件。
如果大家看到這里,有點激動,想手賤一下,可以 CodePen 玩玩,地址:https://codepen.io/atapas/pen...
5. 管理文件內容
成功上傳文件后顯示文件內容,站在用戶的角度上,如果上傳之后,沒有一個預覽的,就很奇怪也不體貼。
我們可以使用FileReader
對象將文件轉換為二進制字符串。 然后添加load
事件偵聽器,以在成功上傳文件時獲取二進制字符串。
// FileReader 實例
const reader = new FileReader();
fileUploader.addEventListener('change', (event) => {
const files = event.target.files;
const file = files[0];
reader.readAsDataURL(file);
reader.addEventListener('load', (event) => {
const img = document.createElement('img');
imageGrid.appendChild(img);
img.src = event.target.result;
img.alt = file.name;
});
});
如果大家看到這里,有點激動,想手賤一下,可以 CodePen 玩玩,地址:https://codepen.io/atapas/pen...
6.驗證文件大小
如果用戶上傳圖片過大,為了不讓服務器有壓力,我們需要限制圖片的大小,下面是允許用戶上傳小于 1M
的圖片,如果大于 1M
將上傳失敗。
fileUploader.addEventListener('change', (event) => {
// Read the file size
const file = event.target.files[0];
const size = file.size;
let msg = '';
// 檢查文件大小是否大于1MB
if (size > 1024 * 1024) {
msg = `<span style="color:red;">The allowed file size is 1MB. The file you are trying to upload is of ${returnFileSize(size)}</span>`;
} else {
msg = `<span style="color:green;"> A ${returnFileSize(size)} file has been uploaded successfully. </span>`;
}
feedback.innerHTML = msg;
});
如果大家看到這里,有點激動,想手賤一下,可以 CodePen 玩玩,地址:https://codepen.io/atapas/pen...
7. 顯示文件上傳進度
更好的用戶體驗是讓用戶知道文件上傳進度,前面我們用過了FileReader
以及讀取和加載文件的事件。
const reader = new FileReader();
FileReader
還有一個progress
事件,表示當前上傳進度,配合HTML5的progress
標簽,我們來模擬一下文件的上傳進度。
reader.addEventListener('progress', (event) => {
if (event.loaded && event.total) {
// 計算完成百分比
const percent = (event.loaded / event.total) * 100;
// 將值綁定到 `progress`標簽
progress.value = percent;
}
});
如果大家看到這里,有點激動,想手賤一下,可以 CodePen 玩玩,地址:https://codepen.io/atapas/pen...
8. 怎么上傳目錄上傳?
我們可以上傳整個目錄嗎?嗯,這是可能的,但有一些限制。有一個叫做webkitdirectory
的非標準屬性(目前只有谷歌瀏覽器還有Microsoft Edge支持按照文件夾進行上傳),它允許我們上傳整個目錄。
目前只有谷歌瀏覽器還有Microsoft Edge支持按照文件夾進行上傳,具體可以看下百度云盤的網頁版的上傳按鈕,在火狐下就支持按照文件進行上傳,而在谷歌和Edge下,就會給用戶提供一個下拉,讓用戶選擇是根據文件進行上傳還是根據文件夾進行上傳。
<input type="file" id="file-uploader" webkitdirectory />
用戶必須需要確認才能上傳目錄
用戶單擊“上傳”按鈕后,就會進行上傳。 這里要注意的重要一點。 FileList
數組將以平面結構的形式包含有關上載目錄中所有文件的信息。 對于每個File
對象,webkitRelativePath
屬性表示目錄路徑。
例如,上傳一個主目錄及其下的其他文件夾和文件:
現在,File 對象將將webkitRelativePath
填充為:
如果大家看到這里,有點激動,想手賤一下,可以 CodePen 玩玩,地址:https://codepen.io/atapas/pen...
9. 拖拽上傳
不支持文件上傳的拖拽就有點 low 了,不是嗎?我們來看看如何通過幾個簡單的步驟實現這一點。
首先,創建一個拖放區域和一個可選的區域來顯示上傳的文件內容。
<div id="container">
<h1>Drag & Drop an Image</h1>
<div id="drop-zone">
DROP HERE
</div>
<div id="content">
Your image to appear here..
</div>
</div>
通過它們各自的ID獲取dropzone
和content
區域。
const dropZone = document.getElementById('drop-zone');
const content = document.getElementById('content');
添加一個dragover
事件處理程序,以顯示將要復制的內容的效果:
dropZone.addEventListener('dragover', event => {
event.stopPropagation();
event.preventDefault();
event.dataTransfer.dropEffect = 'copy';
});
接下來,我們需要一個drop
事件監聽器來處理。
dropZone.addEventListener('drop', event => {
// Get the files
const files = event.dataTransfer.files;
});
如果大家看到這里,有點激動,想手賤一下,可以 CodePen 玩玩,地址:https://codepen.io/atapas/pen...
10. 使用objectURL
處理文件
有一個特殊的方法叫做URL.createobjecturl()
,用于從文件中創建唯一的URL。還可以使用URL.revokeObjectURL()
方法來釋放它。
URL.revokeObjectURL()
靜態方法用來釋放一個之前已經存在的、通過調用URL.createObjectURL()
創建的 URL 對象。當你結束使用某個 URL 對象之后,應該通過調用這個方法來讓瀏覽器知道不用在內存中繼續保留對這個文件的引用了。
fileUploader.addEventListener('change', (event) => {
const files = event.target.files;
const file = files[0];
const img = document.createElement('img');
imageGrid.appendChild(img);
img.src = URL.createObjectURL(file);
img.alt = file.name;
});
如果大家看到這里,有點激動,想手賤一下,可以 CodePen 玩玩,地址:https://codepen.io/atapas/pen...
總結
無論何時,如果你還想學習本文涉及的一些知識,你可以在這里嘗試。
https://html-file-upload.netl...
代碼部署后可能存在的BUG沒法實時知道,事后為了解決這些BUG,花了大量的時間進行log 調試,這邊順便給大家推薦一個好用的BUG監控工具 Fundebug。
原文:https://dev.to/atapas/10-usef...
交流
文章每周持續更新,可以微信搜索「 大遷世界 」第一時間閱讀和催更(比博客早一到兩篇喲),本文 GitHub https://github.com/qq449245884/xiaozhi 已經收錄,整理了很多我的文檔,歡迎Star和完善,大家面試可以參照考點復習,另外關注公眾號,后臺回復福利,即可看到福利,你懂的。