10個(gè)有用的HTML文件上傳技巧
上傳文件的能力是許多Web和移動(dòng)應(yīng)用的關(guān)鍵需求,從將照片上傳到社交媒體上到將簡(jiǎn)歷發(fā)布到工作門(mén)戶(hù)網(wǎng)站上,文件上傳無(wú)處不在。
作為一名Web開(kāi)發(fā)人員,我們一定知道HTML提供了原生文件上傳的支持,并借助于JavaScript的一點(diǎn)幫助。在HTML5中,F(xiàn)ile API被添加到DOM中。利用它,我們可以讀取 FileList 和其中的 File 對(duì)象,這就解決了文件的多種用例,即在本地加載文件或通過(guò)網(wǎng)絡(luò)發(fā)送到服務(wù)器進(jìn)行處理等。
在本文中,我們將討論HTML文件上傳支持的10種用法,希望你覺(jué)得它有用。
在任何時(shí)候,如果您想使用這些文件上傳功能,都可以在這里找到:
HTML文件上傳演示:https://html-file-upload.netlify.app/
該演示的源代碼在我的Github存儲(chǔ)庫(kù)中,?請(qǐng)隨時(shí)關(guān)注我,并通過(guò)示例不斷更新代碼,如果您覺(jué)得有用,請(qǐng)給一個(gè)?。
源代碼倉(cāng)庫(kù):https://github.com/atapas/html-file-upload
1.單個(gè)文件上傳
我們可以將輸入類(lèi)型指定為 file,以在Web應(yīng)用程序中使用文件上傳器功能。
- <input type="file" id="file-uploader">
輸入文件類(lèi)型使用戶(hù)可以通過(guò)按鈕上傳一個(gè)或多個(gè)文件,默認(rèn)情況下,它允許使用操作系統(tǒng)的本地文件瀏覽器上傳單個(gè)文件。
上傳成功后,F(xiàn)ile API 可以使用簡(jiǎn)單的JavaScript代碼讀取 File 對(duì)象。要讀取 File 對(duì)象,我們需要監(jiān)聽(tīng)文件上傳器的 change 事件。
首先,通過(guò)ID獲取文件上傳器實(shí)例
- const fileUploader = document.getElementById('file-uploader');
然后添加一個(gè) change 事件偵聽(tīng)器,以在上傳完成后讀取文件對(duì)象,我們從 event.target.files 屬性獲取上傳的文件信息。
- fileUploader.addEventListener('change', (event) => {
- const files = event.target.files;
- console.log('files', files);
- });
在瀏覽器控制臺(tái)中觀察輸出,注意 FileList 數(shù)組中的 File 對(duì)象擁有上傳文件的所有元數(shù)據(jù)信息。
下面是相同示例的代碼頁(yè),供您進(jìn)一步研究
CodePen:https://codepen.io/atapas/pen/rNLOyRm
- <div>
- <h1>單個(gè)文件上傳</h1>
- <input type="file" id="file-uploader">
- <p>上傳文件,并在瀏覽器控制臺(tái)中查看輸出。</p>
- <p id="feedback"></p>
- </div>
- const fileUploader = document.getElementById('file-uploader');
- fileUploader.addEventListener('change', (event) => {
- const files = event.target.files;
- console.log('files', files);
- const feedback = document.getElementById('feedback');
- const msg = `File ${files[0].name} uploaded successfully!`;
- feedback.innerHTML = msg;
- });
2.多文件上傳
我們可以一次上傳多個(gè)文件。為此,我們只需要在輸入文件標(biāo)簽中添加一個(gè)名為 multiple 的屬性即可。
- <input type="file" id="file-uploader" multiple />
現(xiàn)在,文件瀏覽器將允許您上傳一個(gè)或多個(gè)要上傳的文件。就像前面的例子一樣,你可以添加一個(gè) change 事件處理程序來(lái)捕獲上傳文件的信息。您是否注意到 FileList 是一個(gè)數(shù)組?對(duì),對(duì)于多個(gè)文件上傳,數(shù)組將具有以下信息:
下面是CodePen鏈接,用于探索多個(gè)文件上傳。
CodePen:https://codepen.io/atapas/pen/MWeamYp
- <div>
- <h1>多文件上傳</h1>
- <input type="file" id="file-uploader" multiple>
- <p>上傳多個(gè)文件并在瀏覽器控制臺(tái)中查看輸出</p>
- <p id="feedback"></p>
- </div>
- const fileUploader = document.getElementById('file-uploader');
- fileUploader.addEventListener('change', (event) => {
- const files = event.target.files;
- console.log('files', files);
- // show the upload feedback
- const feedback = document.getElementById('feedback');
- const msg = `${files.length} file(s) uploaded successfully!`;
- feedback.innerHTML = msg;
- });
3.了解文件元數(shù)據(jù)
每當(dāng)我們上傳一個(gè)文件時(shí),F(xiàn)ile 對(duì)象都有元數(shù)據(jù)信息,如文件名、大小、最后更新時(shí)間、類(lèi)型等,此信息對(duì)于進(jìn)一步的驗(yàn)證和決策很有用。
- // 通過(guò)id獲取文件上傳者
- const fileUploader = document.getElementById('file-uploader');
- // 監(jiān)聽(tīng) change 事件并讀取元數(shù)據(jù)
- fileUploader.addEventListener('change', (event) => {
- // 獲取FileList數(shù)組
- const files = event.target.files;
- // 循環(huán)瀏覽文件并獲取元數(shù)據(jù)
- 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 });
- }
- });
這是單個(gè)文件上傳的輸出:
使用此CodePen進(jìn)行進(jìn)一步探索
CodePen:https://codepen.io/atapas/pen/gOMaRJv
- <div>
- <h1>Read File Metadata</h1>
- <input type="file" id="file-uploader">
- <p id="feedback"></p>
- </div>
- const fileUploader = document.getElementById('file-uploader');
- fileUploader.addEventListener('change', (event) => {
- const files = event.target.files;
- console.log('files', 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});
- const feedback = document.getElementById('feedback');
- const msg = ` File Name: ${name} <br/>
- File Size: ${size} <br/>
- File type: ${type} <br/>
- File Last Modified: ${new Date(lastModified)}`;
- feedback.innerHTML = msg;
- }
- });
4.了解文件 accept屬性
我們可以使用 accept 屬性來(lái)限制要上傳的文件的類(lèi)型,您可能希望在用戶(hù)上傳個(gè)人資料圖片時(shí),只顯示允許瀏覽png格式圖片類(lèi)型。
- <input type="file" id="file-uploader" accept=".jpg, .png" multiple>
在上面的代碼中,文件瀏覽器將只允許擴(kuò)展名為 jpg 和 png 的文件。
請(qǐng)注意,在這種情況下,文件瀏覽器會(huì)自動(dòng)將文件選擇類(lèi)型設(shè)置為自定義而不是全部。但是,如果需要,您始終可以將其更改回所有文件。
使用此CodePen探索 accept 屬性
CodePen:https://codepen.io/atapas/pen/OJXymRP
- <div>
- <h1>只能選擇.png和.jpg文件</h1>
- <input type="file" id="file-uploader" accept=".jpg, .png" multiple>
- <p>Upload files and see the output in browser console</p>
- </div>
- const fileUploader = document.getElementById('file-uploader');
- fileUploader.addEventListener('change', (event) => {
- const files = event.target.files;
- console.log('files', files);
- });
5.管理文件內(nèi)容
您可以在成功上傳文件后顯示文件內(nèi)容。對(duì)于個(gè)人資料圖片,如果上傳后不立即向用戶(hù)展示上傳的圖片,會(huì)造成混亂。
我們可以使用 FileReader 對(duì)象將文件轉(zhuǎn)換為二進(jìn)制字符串。然后添加 load 事件偵聽(tīng)器,以在成功上傳文件時(shí)獲取二進(jìn)制字符串。
- // 獲取FileReader的實(shí)例
- const reader = new FileReader();
- fileUploader.addEventListener('change', (event) => {
- const files = event.target.files;
- const file = files[0];
- // 上傳后獲取文件對(duì)象并讀取
- // 數(shù)據(jù)作為URL二進(jìn)制字符串
- reader.readAsDataURL(file);
- // 加載后,對(duì)字符串進(jìn)行處理
- reader.addEventListener('load', (event) => {
- // 在這里我們創(chuàng)建一個(gè)圖像標(biāo)簽并添加圖片
- const img = document.createElement('img');
- imageGrid.appendChild(img);
- img.src = event.target.result;
- img.alt = file.name;
- });
- });
嘗試在下面的CodePen中選擇一個(gè)圖像文件,然后查看其渲染。
CodePen:https://codepen.io/atapas/pen/zYBvdjZ
- <div>
- <h1>顯示文件內(nèi)容</h1>
- <input type="file" id="file-uploader" accept=".jpg, .jpeg, .png" >
- <div id="image-grid"></div>
- </div>
- const fileUploader = document.getElementById('file-uploader');
- const reader = new FileReader();
- const imageGrid = document.getElementById('image-grid');
- 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;
- });
- });
6.驗(yàn)證文件大小
如我們所見(jiàn),我們可以讀取文件的大小元數(shù)據(jù),實(shí)際上可以將其用于文件大小驗(yàn)證,您可能允許用戶(hù)上傳最大1MB的圖像文件。讓我們看看如何實(shí)現(xiàn)這一目標(biāo)。
- // 文件上傳change事件的偵聽(tīng)器
- fileUploader.addEventListener('change', (event) => {
- // 讀取文件大小
- const file = event.target.files[0];
- const size = file.size;
- let msg = '';
- // 檢查文件大小是否大于1MB,并準(zhǔn)備一條消息。
- 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>`;
- }
- // 向用戶(hù)顯示消息
- feedback.innerHTML = msg;
- });
嘗試上傳不同大小的文件,以查看驗(yàn)證的工作原理
CodePen:https://codepen.io/atapas/pen/pobjMKv
- <div>
- <h1>檢查文件大小</h1>
- <input type="file" id="file-uploader">
- <div id="feedback"></div
- </div>
- const fileUploader = document.getElementById('file-uploader');
- const feedback = document.getElementById('feedback');
- fileUploader.addEventListener('change', (event) => {
- const file = event.target.files[0];
- console.log('file', file);
- const size = file.size;
- console.log('size', size);
- let msg = '';
- 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;
- });
- function returnFileSize(number) {
- if(number < 1024) {
- return number + 'bytes';
- } else if(number >= 1024 && number < 1048576) {
- return (number/1024).toFixed(2) + 'KB';
- } else if(number >= 1048576) {
- return (number/1048576).toFixed(2) + 'MB';
- }
- }
7.顯示文件上傳進(jìn)度
更好的可用性是讓你的用戶(hù)知道文件上傳的進(jìn)程?,F(xiàn)在,我們知道了 FileReader 和讀取和加載文件的事件。
- const reader = new FileReader();
FileReader 有另一個(gè)事件,稱(chēng)為進(jìn)度(progress),知道已加載了多少。我們可以使用HTML5的 progress 標(biāo)簽來(lái)創(chuàng)建帶有此信息的進(jìn)度欄。
- reader.addEventListener('progress', (event) => {
- if (event.loaded && event.total) {
- // 計(jì)算完成百分比
- const percent = (event.loaded / event.total) * 100;
- // 將值設(shè)置為進(jìn)度組件
- progress.value = percent;
- }
- });
不如你試著上傳一個(gè)大一點(diǎn)的文件,看看下面的CodePen中的進(jìn)度條工作情況如何?試試吧。
CodePen:https://codepen.io/atapas/pen/eYzpwYj
- <div>
- <h1>File upload progress</h1>
- <input type="file" id="file-uploader">
- <div id="feedback"></div>
- <label id="progress-label" for="progress"></label>
- <progress id="progress" value="0" max="100"> </progress>
- </div>
- const fileUploader = document.getElementById('file-uploader');
- const feedback = document.getElementById('feedback');
- const progress = document.getElementById('progress');
- const reader = new FileReader();
- fileUploader.addEventListener('change', (event) => {
- const files = event.target.files;
- const file = files[0];
- reader.readAsDataURL(file);
- reader.addEventListener('progress', (event) => {
- if (event.loaded && event.total) {
- const percent = (event.loaded / event.total) * 100;
- progress.value = percent;
- document.getElementById('progress-label').innerHTML = Math.round(percent) + '%';
- if (percent === 100) {
- let msg = `<span style="color:green;">File <u><b>${file.name}</b></u> has been uploaded successfully.</span>`;
- feedback.innerHTML = msg;
- }
- }
- });
- });
8.目錄上傳呢?
我們可以上傳整個(gè)目錄嗎?好吧,這是可能的,但有一些限制。有一個(gè)叫做 webkitdirectory 的非標(biāo)準(zhǔn)屬性(至少在寫(xiě)這篇文章的時(shí)候是這樣),允許我們上傳整個(gè)目錄。
雖然最初只針對(duì)基于WebKit的瀏覽器實(shí)現(xiàn),但webkitdirectory也可以在Microsoft Edge以及Firefox 50和更高版本中使用。但是,即使它具有相對(duì)廣泛的支持,它仍然不是標(biāo)準(zhǔn)的,除非您別無(wú)選擇,否則不應(yīng)該使用它。
您可以將此屬性指定為
- <input type="file" id="file-uploader" webkitdirectory />
這將允許您選擇一個(gè)文件夾(又名目錄)
用戶(hù)必須提供確認(rèn)信息才能上傳目錄,
用戶(hù)單擊“Upload”按鈕后,就會(huì)進(jìn)行上傳。這里要注意的重要一點(diǎn):FileList 數(shù)組將以平面結(jié)構(gòu)的形式包含有關(guān)上載目錄中所有文件的信息。但關(guān)鍵是,對(duì)于每個(gè) File 對(duì)象,webkitRelativePath 屬性都會(huì)有目錄路徑。
例如,讓我們考慮一個(gè) main 目錄及其下的其他文件夾和文件,
現(xiàn)在,F(xiàn)ile 對(duì)象將將 webkitRelativePath 填充為
您可以使用它在您選擇的任何UI結(jié)構(gòu)中呈現(xiàn)文件夾和文件。使用此CodePen進(jìn)行進(jìn)一步探索。
CodePen:https://codepen.io/atapas/pen/dyXYRKp
- <div>
- <h1>Upload directories</h1>
- <input type="file" id="file-uploader" webkitdirectory />
- <ul id="pathList"></ul>
- </div>
- const fileUploader = document.getElementById('file-uploader');
- const pathList = document.getElementById('pathList');
- function removeAllChildNodes(parent) {
- while (parent.firstChild) {
- parent.removeChild(parent.firstChild);
- }
- }
- fileUploader.addEventListener('change', (event) => {
- const files = event.target.files;
- console.log('files', files);
- removeAllChildNodes(pathList);
- [...files].forEach((file, index) => {
- let path = document.createElement('li');
- path.innerHTML = file.webkitRelativePath;
- pathList.appendChild(path);
- });
- });
9.讓我們拖放上傳
不支持拖放功能進(jìn)行文件上傳是一種古老的方式,不是嗎?讓我們看看如何通過(guò)幾個(gè)簡(jiǎn)單的步驟來(lái)實(shí)現(xiàn)這一目標(biāo)。
首先,創(chuàng)建一個(gè)放置區(qū)和一個(gè)可選的區(qū)域以顯示上傳的文件內(nèi)容。我們將使用圖像作為文件拖放到此處。
- <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>
通過(guò)它們各自的ID獲取拖拽和內(nèi)容區(qū)域。
- const dropZone = document.getElementById('drop-zone');
- const content = document.getElementById('content');
添加一個(gè) dragover 事件處理程序,以顯示將要復(fù)制的內(nèi)容的效果,
- dropZone.addEventListener('dragover', event => {
- event.stopPropagation();
- event.preventDefault();
- event.dataTransfer.dropEffect = 'copy';
- });
接下來(lái),定義放置圖像時(shí)我們要做什么,我們將需要一個(gè) drop 事件監(jiān)聽(tīng)器來(lái)處理。
- dropZone.addEventListener('drop', event => {
- // 獲取文件
- const files = event.dataTransfer.files;
- // 現(xiàn)在,我們可以盡一切可能來(lái)展示文件內(nèi)容在一個(gè)HTML元素中,如,DIV。
- });
嘗試在下面的CodePen示例中拖放圖像文件,并查看其工作原理,不要忘記查看代碼以渲染拖放的圖像。
CodePen:https://codepen.io/atapas/pen/ExyVoXN
- <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>
- const dropZone = document.getElementById('drop-zone');
- const content = document.getElementById('content');
- const reader = new FileReader();
- if (window.FileList && window.File) {
- dropZone.addEventListener('dragover', event => {
- event.stopPropagation();
- event.preventDefault();
- event.dataTransfer.dropEffect = 'copy';
- });
- dropZone.addEventListener('drop', event => {
- content.innerHTML = '';
- event.stopPropagation();
- event.preventDefault();
- const files = event.dataTransfer.files;
- console.log(files);
- reader.readAsDataURL(files[0]);
- reader.addEventListener('load', (event) => {
- content.innerHTML = '';
- const img = document.createElement('img');
- img.style.height = '400px';
- img.style.width = '400px';
- content.appendChild(img);
- img.src = event.target.result;
- img.alt = file.name;
- });
- });
- }
10.使用objectURLs處理文件
有一個(gè)稱(chēng)為 URL.createObjectURL() 的特殊方法,可以從文件創(chuàng)建唯一的URL,您也可以使用 URL.revokeObjectURL() 方法釋放它。
DOM URL.createObjectURL() 和 URL.revokeObjectURL() 方法讓你可以創(chuàng)建簡(jiǎn)單的URL字符串,這些字符串可以用來(lái)引用任何可以使用DOM文件對(duì)象引用的數(shù)據(jù),包括用戶(hù)計(jì)算機(jī)上的本地文件。
對(duì)象URL的簡(jiǎn)單用法是:
img.src = URL.createObjectURL(file);
使用此CodePen可以進(jìn)一步瀏覽對(duì)象URL。提示:將此方法與前面#5中提到的方法進(jìn)行比較。
- <div>
- <h1>Use Object URL</h1>
- <input type="file" id="file-uploader" accept=".jpg, .jpeg, .png" >
- <div id="image-grid"></div>
- </div>
- const fileUploader = document.getElementById('file-uploader');
- const reader = new FileReader();
- const imageGrid = document.getElementById('image-grid');
- 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;
- });
結(jié)束
很多時(shí)候,原生HTML功能足以讓我們處理手中的用例。我發(fā)現(xiàn),文件上傳默認(rèn)情況下提供了許多不錯(cuò)的選擇。
原文:https://dev.to/atapas/10-useful-html-file-upload-tips-for-web-developers-2d1d
本文轉(zhuǎn)載自微信公眾號(hào)「前端全棧開(kāi)發(fā)者」,可以通過(guò)以下二維碼關(guān)注。轉(zhuǎn)載本文請(qǐng)聯(lián)系前端全棧開(kāi)發(fā)者公眾號(hào)。