日韩无码专区无码一级三级片|91人人爱网站中日韩无码电影|厨房大战丰满熟妇|AV高清无码在线免费观看|另类AV日韩少妇熟女|中文日本大黄一级黄色片|色情在线视频免费|亚洲成人特黄a片|黄片wwwav色图欧美|欧亚乱色一区二区三区

RELATEED CONSULTING
相關(guān)咨詢(xún)
選擇下列產(chǎn)品馬上在線溝通
服務(wù)時(shí)間:8:30-17:00
你可能遇到了下面的問(wèn)題
關(guān)閉右側(cè)工具欄

新聞中心

這里有您想知道的互聯(lián)網(wǎng)營(yíng)銷(xiāo)解決方案
文件上傳,搞懂這8種場(chǎng)景就夠了

本文轉(zhuǎn)載自微信公眾號(hào)「全棧修仙之路」,作者阿寶哥 。轉(zhuǎn)載本文請(qǐng)聯(lián)系全棧修仙之路公眾號(hào)。

專(zhuān)注于為中小企業(yè)提供網(wǎng)站設(shè)計(jì)制作、成都網(wǎng)站建設(shè)服務(wù),電腦端+手機(jī)端+微信端的三站合一,更高效的管理,為中小企業(yè)汪清免費(fèi)做網(wǎng)站提供優(yōu)質(zhì)的服務(wù)。我們立足成都,凝聚了一批互聯(lián)網(wǎng)行業(yè)人才,有力地推動(dòng)了成百上千家企業(yè)的穩(wěn)健成長(zhǎng),幫助中小企業(yè)通過(guò)網(wǎng)站建設(shè)實(shí)現(xiàn)規(guī)模擴(kuò)充和轉(zhuǎn)變。

在日常工作中,文件上傳是一個(gè)很常見(jiàn)的功能。在項(xiàng)目開(kāi)發(fā)過(guò)程中,我們通常都會(huì)使用一些成熟的上傳組件來(lái)實(shí)現(xiàn)對(duì)應(yīng)的功能。一般來(lái)說(shuō),成熟的上傳組件不僅會(huì)提供漂亮 UI 或好的交互體驗(yàn),而且還會(huì)提供多種不同的上傳方式,以滿(mǎn)足不同的場(chǎng)景需求。

一般在我們工作中,主要會(huì)涉及到 8 種文件上傳的場(chǎng)景,每一種場(chǎng)景背后都使用不同的技術(shù),其中也有很多細(xì)節(jié)需要我們額外注意。今天阿寶哥就來(lái)帶大家總結(jié)一下這 8 種場(chǎng)景,讓大家能更好地理解成熟上傳組件所提供的功能。閱讀本文后,你將會(huì)了解以下的內(nèi)容:

  • 單文件上傳:利用 input 元素的 accept 屬性限制上傳文件的類(lèi)型、利用 JS 檢測(cè)文件的類(lèi)型及使用 Koa 實(shí)現(xiàn)單文件上傳的功能;
  • 多文件上傳:利用 input 元素的 multiple 屬性支持選擇多文件及使用 Koa 實(shí)現(xiàn)多文件上傳的功能;
  • 目錄上傳:利用 input 元素上的 webkitdirectory 屬性支持目錄上傳的功能及使用 Koa 實(shí)現(xiàn)目錄上傳并按文件目錄結(jié)構(gòu)存放的功能;
  • 壓縮目錄上傳:在目錄上傳的基礎(chǔ)上,利用 JSZip 實(shí)現(xiàn)壓縮目錄上傳的功能;
  • 拖拽上傳:利用拖拽事件和 DataTransfer 對(duì)象實(shí)現(xiàn)拖拽上傳的功能;
  • 剪貼板上傳:利用剪貼板事件和 Clipboard API 實(shí)現(xiàn)剪貼板上傳的功能;
  • 大文件分塊上傳:利用 Blob.slice、SparkMD5 和第三方庫(kù) async-pool 實(shí)現(xiàn)大文件并發(fā)上傳的功能;
  • 服務(wù)端上傳:利用第三方庫(kù) form-data 實(shí)現(xiàn)服務(wù)端文件流式上傳的功能。

一、單文件上傳

對(duì)于單文件上傳的場(chǎng)景來(lái)說(shuō),最常見(jiàn)的是圖片上傳的場(chǎng)景,所以我們就以圖片上傳為例,先來(lái)介紹單文件上傳的基本流程。

1.1 前端代碼

html

在以下代碼中,我們通過(guò) input 元素的 accept 屬性限制了上傳文件的類(lèi)型。這里使用 image/* 限制只能選擇圖片文件,當(dāng)然你也可以設(shè)置特定的類(lèi)型,比如 image/png 或 image/png,image/jpeg。

 
 
 
 
  1.  
  2. 上傳文件 

需要注意的是,雖然我們把 input 元素的 accept 屬性設(shè)置為 image/png。但如果用戶(hù)把 jpg/jpeg 格式的圖片后綴名改為 .png,就可以成功繞過(guò)這個(gè)限制。要解決這個(gè)問(wèn)題,我們可以通過(guò)讀取文件中的二進(jìn)制數(shù)據(jù)來(lái)識(shí)別正確的文件類(lèi)型。

要查看圖片對(duì)應(yīng)的二進(jìn)制數(shù)據(jù),我們可以借助一些現(xiàn)成的編輯器,比如 Windows 平臺(tái)下的 WinHex 或 macOS 平臺(tái)下的 Synalyze It! Pro 十六進(jìn)制編輯器。這里我們使用 Synalyze It! Pro 這個(gè)編輯器,來(lái)查看阿寶哥頭像對(duì)應(yīng)的二進(jìn)制數(shù)據(jù)。

那么在前端能否不借助工具,讀取文件的二進(jìn)制數(shù)據(jù)呢?答案是可以的,這里阿寶哥就不展開(kāi)介紹了。感興趣的話(huà),你可以閱讀 JavaScript 如何檢測(cè)文件的類(lèi)型? 這篇文章。另外,需要注意的是 input 元素 accept 屬性有存在兼容性問(wèn)題。比如 IE 9 以下不支持,具體如下圖所示:

(圖片來(lái)源 —— https://caniuse.com/input-file-accept)

js

 
 
 
 
  1. const uploadFileEle = document.querySelector("#uploadFile"); 
  2.  
  3. const request = axios.create({ 
  4.   baseURL: "http://localhost:3000/upload", 
  5.   timeout: 60000,  
  6. }); 
  7.  
  8. async function uploadFile() { 
  9.   if (!uploadFileEle.files.length) return; 
  10.   const file = uploadFileEle.files[0]; // 獲取單個(gè)文件 
  11.   // 省略文件的校驗(yàn)過(guò)程,比如文件類(lèi)型、大小校驗(yàn) 
  12.   upload({ 
  13.     url: "/single", 
  14.     file, 
  15.   }); 
  16.  
  17. function upload({ url, file, fieldName = "file" }) { 
  18.   let formData = new FormData(); 
  19.   formData.set(fieldName, file); 
  20.   request.post(url, formData, { 
  21.     // 監(jiān)聽(tīng)上傳進(jìn)度 
  22.     onUploadProgress: function (progressEvent) { 
  23.       const percentCompleted = Math.round( 
  24.         (progressEvent.loaded * 100) / progressEvent.total 
  25.       ); 
  26.       console.log(percentCompleted); 
  27.      }, 
  28.   }); 

在以上代碼中,我們先把讀取的 File 對(duì)象封裝成 FormData 對(duì)象,然后利用 Axios 實(shí)例的 post 方法實(shí)現(xiàn)文件上傳的功能。在上傳前,通過(guò)設(shè)置請(qǐng)求配置對(duì)象的 onUploadProgress 屬性,就可以獲取文件的上傳進(jìn)度。

1.2 服務(wù)端代碼

Koa 是一個(gè)簡(jiǎn)單易用的 Web 框架,它的特點(diǎn)是優(yōu)雅、簡(jiǎn)潔、輕量、自由度高。所以我們選擇它來(lái)搭建文件服務(wù),并使用以下中間件來(lái)實(shí)現(xiàn)相應(yīng)的功能:

  • koa-static:處理靜態(tài)資源的中間件;
  • @koa/cors:處理跨域請(qǐng)求的中間件;
  • @koa/multer:處理 multipart/form-data 的中間件;
  • @koa/router:處理路由的中間件。
 
 
 
 
  1. const path = require("path"); 
  2. const Koa = require("koa"); 
  3. const serve = require("koa-static"); 
  4. const cors = require("@koa/cors"); 
  5. const multer = require("@koa/multer"); 
  6. const Router = require("@koa/router"); 
  7.  
  8. const app = new Koa(); 
  9. const router = new Router(); 
  10. const PORT = 3000; 
  11. // 上傳后資源的URL地址 
  12. const RESOURCE_URL = `http://localhost:${PORT}`; 
  13. // 存儲(chǔ)上傳文件的目錄 
  14. const UPLOAD_DIR = path.join(__dirname, "/public/upload"); 
  15.  
  16. const storage = multer.diskStorage({ 
  17.   destination: async function (req, file, cb) { 
  18.     // 設(shè)置文件的存儲(chǔ)目錄 
  19.     cb(null, UPLOAD_DIR); 
  20.   }, 
  21.   filename: function (req, file, cb) { 
  22.     // 設(shè)置文件名 
  23.     cb(null, `${file.originalname}`); 
  24.   }, 
  25. }); 
  26.  
  27. const multerUpload = multer({ storage }); 
  28.  
  29. router.get("/", async (ctx) => { 
  30.   ctx.body = "歡迎使用文件服務(wù)(by 阿寶哥)"; 
  31. }); 
  32.  
  33. router.post( 
  34.   "/upload/single", 
  35.   async (ctx, next) => { 
  36.     try { 
  37.       await next(); 
  38.       ctx.body = { 
  39.         code: 1, 
  40.         msg: "文件上傳成功", 
  41.         url: `${RESOURCE_URL}/${ctx.file.originalname}`, 
  42.       }; 
  43.     } catch (error) { 
  44.       ctx.body = { 
  45.         code: 0, 
  46.         msg: "文件上傳失敗" 
  47.       }; 
  48.     } 
  49.   }, 
  50.   multerUpload.single("file") 
  51. ); 
  52.  
  53. // 注冊(cè)中間件 
  54. app.use(cors()); 
  55. app.use(serve(UPLOAD_DIR)); 
  56. app.use(router.routes()).use(router.allowedMethods()); 
  57.  
  58. app.listen(PORT, () => { 
  59.   console.log(`app starting at port ${PORT}`); 
  60. }); 

以上代碼相對(duì)比較簡(jiǎn)單,我們就不展開(kāi)介紹了。Koa 內(nèi)核很簡(jiǎn)潔,擴(kuò)展功能都是通過(guò)中間件來(lái)實(shí)現(xiàn)。比如示例中使用到的路由、CORS、靜態(tài)資源處理等功能都是通過(guò)中間件實(shí)現(xiàn)。因此要想掌握 Koa 這個(gè)框架,核心是掌握它的中間件機(jī)制。如果你想深入了解的話(huà),可以閱讀 如何更好地理解中間件和洋蔥模型 這篇文章。其實(shí)除了單文件上傳外,在文件上傳的場(chǎng)景中,我們也可以同時(shí)上傳多個(gè)文件。

單文件上傳示例:single-file-upload

https://github.com/semlinker/file-upload-demos/tree/master/single-file-upload

二、多文件上傳

要上傳多個(gè)文件,首先我們需要允許用戶(hù)同時(shí)選擇多個(gè)文件。要實(shí)現(xiàn)這個(gè)功能,我們可以利用 input 元素的 multiple 屬性。跟前面介紹的 accept 屬性一樣,該屬性也存在兼容性問(wèn)題,具體如下圖所示:

(圖片來(lái)源 —— https://caniuse.com/mdn-api_htmlinputelement_multiple)

2.1 前端代碼

html

相比單文件上傳的代碼,多文件上傳場(chǎng)景下的 input 元素多了一個(gè) multiple 屬性:

 
 
 
 
  1.  
  2. 上傳文件 

js

在單文件上傳的代碼中,我們通過(guò) uploadFileEle.files[0] 獲取單個(gè)文件,而對(duì)于多文件上傳來(lái)說(shuō),我們需要獲取已選擇的文件列表,即通過(guò) uploadFileEle.files 來(lái)獲取,它返回的是一個(gè) FileList 對(duì)象。

 
 
 
 
  1. async function uploadFile() { 
  2.   if (!uploadFileEle.files.length) return; 
  3.   const files = Array.from(uploadFileEle.files); 
  4.   upload({ 
  5.     url: "/multiple", 
  6.     files, 
  7.   }); 

因?yàn)橐С稚蟼鞫鄠€(gè)文件,所以我們需要同步更新一下 upload 函數(shù)。對(duì)應(yīng)的處理邏輯就是遍歷文件列表,然后使用 FormData 對(duì)象的 append 方法來(lái)添加多個(gè)文件,具體代碼如下所示:

 
 
 
 
  1. function upload({ url, files, fieldName = "file" }) { 
  2.   let formData = new FormData(); 
  3.   files.forEach((file) => { 
  4.     formData.append(fieldName, file); 
  5.   }); 
  6.   request.post(url, formData, { 
  7.     // 監(jiān)聽(tīng)上傳進(jìn)度 
  8.     onUploadProgress: function (progressEvent) { 
  9.       const percentCompleted = Math.round( 
  10.         (progressEvent.loaded * 100) / progressEvent.total 
  11.       ); 
  12.       console.log(percentCompleted); 
  13.     }, 
  14.   }); 

2.2 服務(wù)端代碼

在以下代碼中,我們定義了一個(gè)新的路由 —— /upload/multiple 來(lái)處理多文件上傳的功能。當(dāng)所有文件都成功上傳后,就會(huì)返回一個(gè)已上傳文件的 url 地址列表:

 
 
 
 
  1. router.post( 
  2.   "/upload/multiple", 
  3.   async (ctx, next) => { 
  4.     try { 
  5.       await next(); 
  6.       urls = ctx.files.file.map(file => `${RESOURCE_URL}/${file.originalname}`); 
  7.       ctx.body = { 
  8.         code: 1, 
  9.         msg: "文件上傳成功", 
  10.         urls 
  11.       }; 
  12.     } catch (error) { 
  13.       ctx.body = { 
  14.         code: 0, 
  15.         msg: "文件上傳失敗", 
  16.       }; 
  17.     } 
  18.   }, 
  19.   multerUpload.fields([ 
  20.     { 
  21.       name: "file", // 與FormData表單項(xiàng)的fieldName相對(duì)應(yīng) 
  22.     }, 
  23.   ]) 
  24. ); 

介紹完單文件和多文件上傳的功能,接下來(lái)我們來(lái)介紹目錄上傳的功能。

多文件上傳示例:multiple-file-upload

https://github.com/semlinker/file-upload-demos/tree/master/multiple-file-upload

三、目錄上傳

可能你還不知道,input 元素上還有一個(gè)的 webkitdirectory 屬性。當(dāng)設(shè)置了 webkitdirectory 屬性之后,我們就可以選擇目錄了。

 
 
 
 
  1.  

當(dāng)我們選擇了指定目錄之后,比如阿寶哥桌面上的 images 目錄,就會(huì)顯示以下確認(rèn)框:

點(diǎn)擊上傳按鈕之后,我們就可以獲取文件列表。列表中的文件對(duì)象上含有一個(gè) webkitRelativePath 屬性,用于表示當(dāng)前文件的相對(duì)路徑。

雖然通過(guò) webkitdirectory 屬性可以很容易地實(shí)現(xiàn)選擇目錄的功能,但在實(shí)際項(xiàng)目中我們還需要考慮它的兼容性。比如在 IE 11 以下的版本就不支持該屬性,其它瀏覽器的兼容性如下圖所示:

(圖片來(lái)源 —— https://caniuse.com/?search=webkitdirectory)

了解完 webkitdirectory 屬性的兼容性,我們先來(lái)介紹前端的實(shí)現(xiàn)代碼。

3.1 前端代碼

為了讓服務(wù)端能按照實(shí)際的目錄結(jié)構(gòu)來(lái)存放對(duì)應(yīng)的文件,在添加表單項(xiàng)時(shí)我們需要把當(dāng)前文件的路徑提交到服務(wù)端。此外,為了確保@koa/multer 能正確處理文件的路徑,我們需要對(duì)路徑進(jìn)行特殊處理。即把 / 斜杠替換為 @ 符號(hào)。對(duì)應(yīng)的處理方式如下所示:

 
 
 
 
  1. function upload({ url, files, fieldName = "file" }) { 
  2.   let formData = new FormData(); 
  3.   files.forEach((file, i) => { 
  4.     formData.append( 
  5.       fieldName,  
  6.       files[i], 
  7.       files[i].webkitRelativePath.replace(/\//g, "@"); 
  8.     ); 
  9.   }); 
  10.   request.post(url, formData); // 省略上傳進(jìn)度處理 

3.2 服務(wù)端代碼

目錄上傳與多文件上傳,服務(wù)端代碼的主要區(qū)別就是 @koa/multer 中間件的配置對(duì)象不一樣。在 destination 屬性對(duì)應(yīng)的函數(shù)中,我們需要把文件名中 @ 還原成 /,然后根據(jù)文件的實(shí)際路徑來(lái)生成目錄。

 
 
 
 
  1. const fse = require("fs-extra"); 
  2. const storage = multer.diskStorage({ 
  3.   destination: async function (req, file, cb) { 
  4.     // images@image-1.jpeg => images/image-1.jpeg 
  5.     let relativePath = file.originalname.replace(/@/g, path.sep); 
  6.     let index = relativePath.lastIndexOf(path.sep); 
  7.     let fileDir = path.join(UPLOAD_DIR, relativePath.substr(0, index)); 
  8.     // 確保文件目錄存在,若不存在的話(huà),會(huì)自動(dòng)創(chuàng)建 
  9.     await fse.ensureDir(fileDir);  
  10.     cb(null, fileDir); 
  11.   }, 
  12.   filename: function (req, file, cb) { 
  13.     let parts = file.originalname.split("@"); 
  14.     cb(null, `${parts[parts.length - 1]}`);  
  15.   }, 
  16. }); 

現(xiàn)在我們已經(jīng)實(shí)現(xiàn)了目錄上傳的功能,那么能否把目錄下的文件壓縮成一個(gè)壓縮包后再上傳呢?答案是可以的,接下來(lái)我們來(lái)介紹如何實(shí)現(xiàn)壓縮目錄上傳的功能。

目錄上傳示例:directory-upload

https://github.com/semlinker/file-upload-demos/tree/master/directory-upload

四、壓縮目錄上傳

在 JavaScript 如何在線解壓 ZIP 文件? 這篇文章中,介紹了在瀏覽器端如何使用 JSZip 這個(gè)庫(kù)實(shí)現(xiàn)在線解壓 ZIP 文件的功能。JSZip 這個(gè)庫(kù)除了可以解析 ZIP 文件之外,它還可以用來(lái) 創(chuàng)建和編輯 ZIP 文件。利用 JSZip 這個(gè)庫(kù)提供的 API,我們就可以把目錄下的所有文件壓縮成 ZIP 文件,然后再把生成的 ZIP 文件上傳到服務(wù)器。

4.1 前端代碼

JSZip 實(shí)例上的 file(name, data [,options]) 方法,可以把文件添加到 ZIP 文件中?;谠摲椒ㄎ覀兛梢苑庋b了一個(gè) generateZipFile 函數(shù),用于把目錄下的文件列表壓縮成一個(gè) ZIP 文件。以下是 generateZipFile 函數(shù)的具體實(shí)現(xiàn):

 
 
 
 
  1. function generateZipFile( 
  2.   zipName, files, 
  3.   options = { type: "blob", compression: "DEFLATE" } 
  4. ) { 
  5.   return new Promise((resolve, reject) => { 
  6.     const zip = new JSZip(); 
  7.     for (let i = 0; i < files.length; i++) { 
  8.       zip.file(files[i].webkitRelativePath, files[i]); 
  9.     } 
  10.     zip.generateAsync(options).then(function (blob) { 
  11.       zipName = zipName || Date.now() + ".zip"; 
  12.       const zipFile = new File([blob], zipName, { 
  13.         type: "application/zip", 
  14.       }); 
  15.       resolve(zipFile); 
  16.     }); 
  17.   }); 

在創(chuàng)建完 generateZipFile 函數(shù)之后,我們需要更新一下前面已經(jīng)介紹過(guò)的 uploadFile 函數(shù):

 
 
 
 
  1. async function uploadFile() { 
  2.   let fileList = uploadFileEle.files; 
  3.   if (!fileList.length) return; 
  4.   let webkitRelativePath = fileList[0].webkitRelativePath; 
  5.   let zipFileName = webkitRelativePath.split("/")[0] + ".zip"; 
  6.   let zipFile = await generateZipFile(zipFileName, fileList); 
  7.   upload({ 
  8.     url: "/single", 
  9.     file: zipFile, 
  10.     fileName: zipFileName 
  11.   }); 

在以上的 uploadFile 函數(shù)中,我們會(huì)對(duì)返回的 FileList 對(duì)象進(jìn)行處理,即調(diào)用 generateZipFile 函數(shù)來(lái)生成 ZIP 文件。此外,為了在服務(wù)端接收壓縮文件時(shí),能獲取到文件名,我們?yōu)?upload 函數(shù)增加了一個(gè) fileName 參數(shù),該參數(shù)用于調(diào)用 formData.append 方法時(shí),設(shè)置上傳文件的文件名:

 
 
 
 
  1. function upload({ url, file, fileName, fieldName = "file" }) { 
  2.   if (!url || !file) return; 
  3.   let formData = new FormData(); 
  4.   formData.append( 
  5.     fieldName, file, fileName 
  6.   ); 
  7.   request.post(url, formData); // 省略上傳進(jìn)度跟蹤 

以上就是壓縮目錄上傳,前端部分的 JS 代碼,服務(wù)端的代碼可以參考前面單文件上傳的相關(guān)代碼。

壓縮目錄上傳示例:directory-compress-upload

https://github.com/semlinker/file-upload-demos/tree/master/directory-compress-upload

五、拖拽上傳

要實(shí)現(xiàn)拖拽上傳的功能,我們需要先了解與拖拽相關(guān)的事件。比如 drag、dragend、dragenter、dragover 或 drop 事件等。這里我們只介紹接下來(lái)要用到的拖拽事件:

  • dragenter:當(dāng)拖拽元素或選中的文本到一個(gè)可釋放目標(biāo)時(shí)觸發(fā);
  • dragover:當(dāng)元素或選中的文本被拖到一個(gè)可釋放目標(biāo)上時(shí)觸發(fā)(每100毫秒觸發(fā)一次);
  • dragleave:當(dāng)拖拽元素或選中的文本離開(kāi)一個(gè)可釋放目標(biāo)時(shí)觸發(fā);
  • drop:當(dāng)元素或選中的文本在可釋放目標(biāo)上被釋放時(shí)觸發(fā)。

基于上面的這些事件,我們就可以提高用戶(hù)拖拽的體驗(yàn)。比如當(dāng)用戶(hù)拖拽的元素進(jìn)入目標(biāo)區(qū)域時(shí),對(duì)目標(biāo)區(qū)域進(jìn)行高亮顯示。當(dāng)用戶(hù)拖拽的元素離開(kāi)目標(biāo)區(qū)域時(shí),移除高亮顯示。很明顯當(dāng) drop 事件觸發(fā)后,拖拽的元素已經(jīng)放入目標(biāo)區(qū)域了,這時(shí)我們就需要獲取對(duì)應(yīng)的數(shù)據(jù)。

那么如何獲取拖拽對(duì)應(yīng)的數(shù)據(jù)呢?這時(shí)我們需要使用 DataTransfer 對(duì)象,該對(duì)象用于保存拖動(dòng)并放下過(guò)程中的數(shù)據(jù)。它可以保存一項(xiàng)或多項(xiàng)數(shù)據(jù),這些數(shù)據(jù)項(xiàng)可以是一種或者多種數(shù)據(jù)類(lèi)型。若拖動(dòng)操作涉及拖動(dòng)文件,則我們可以通過(guò) DataTransfer 對(duì)象的 files 屬性來(lái)獲取文件列表。

介紹完拖拽上傳相關(guān)的知識(shí)后,我們來(lái)看一下具體如何實(shí)現(xiàn)拖拽上傳的功能。

5.1 前端代碼

html

  
 
 
 
  1.  
  2.    

    拖拽上傳文件

     
  3.    
 
  •  

    css

     
     
     
     
    1. #dropArea { 
    2.   width: 300px; 
    3.   height: 300px; 
    4.   border: 1px dashed gray; 
    5.   margin-bottom: 20px; 
    6. #dropArea p { 
    7.   text-align: center; 
    8.   color: #999; 
    9. #dropArea.highlighted { 
    10.   background-color: #ddd; 
    11. #imagePreview { 
    12.   max-height: 250px; 
    13.   overflow-y: scroll; 
    14. #imagePreview img { 
    15.   width: 100%; 
    16.   display: block; 
    17.   margin: auto; 

    js

    為了讓大家能夠更好地閱讀拖拽上傳的相關(guān)代碼,我們把代碼拆成 4 部分來(lái)講解:

    1、阻止默認(rèn)拖拽行為

     
     
     
     
    1. const dropAreaEle = document.querySelector("#dropArea"); 
    2. const imgPreviewEle = document.querySelector("#imagePreview"); 
    3. const IMAGE_MIME_REGEX = /^image\/(jpe?g|gif|png)$/i; 
    4.  
    5. ["dragenter", "dragover", "dragleave", "drop"].forEach((eventName) => { 
    6.    dropAreaEle.addEventListener(eventName, preventDefaults, false); 
    7.    document.body.addEventListener(eventName, preventDefaults, false); 
    8. }); 
    9.  
    10. function preventDefaults(e) { 
    11.   e.preventDefault(); 
    12.   e.stopPropagation(); 

    2、切換目標(biāo)區(qū)域的高亮狀態(tài)

     
     
     
     
    1. ["dragenter", "dragover"].forEach((eventName) => { 
    2.     dropAreaEle.addEventListener(eventName, highlight, false); 
    3. }); 
    4. ["dragleave", "drop"].forEach((eventName) => { 
    5.     dropAreaEle.addEventListener(eventName, unhighlight, false); 
    6. }); 
    7.  
    8. // 添加高亮樣式 
    9. function highlight(e) { 
    10.   dropAreaEle.classList.add("highlighted"); 
    11.  
    12. // 移除高亮樣式 
    13. function unhighlight(e) { 
    14.   dropAreaEle.classList.remove("highlighted"); 

    3、處理圖片預(yù)覽

     
     
     
     
    1. dropAreaEle.addEventListener("drop", handleDrop, false); 
    2.  
    3. function handleDrop(e) { 
    4.   const dt = e.dataTransfer; 
    5.   const files = [...dt.files]; 
    6.   files.forEach((file) => { 
    7.     previewImage(file, imgPreviewEle); 
    8.   }); 
    9.   // 省略文件上傳代碼 
    10.  
    11. function previewImage(file, container) { 
    12.   if (IMAGE_MIME_REGEX.test(file.type)) { 
    13.     const reader = new FileReader(); 
    14.     reader.onload = function (e) { 
    15.       let img = document.createElement("img"); 
    16.       img.src = e.target.result; 
    17.       container.append(img); 
    18.     }; 
    19.     reader.readAsDataURL(file); 
    20.   } 

    4、文件上傳

     
     
     
     
    1. function handleDrop(e) { 
    2.   const dt = e.dataTransfer; 
    3.   const files = [...dt.files]; 
    4.   // 省略圖片預(yù)覽代碼 
    5.   files.forEach((file) => { 
    6.     upload({ 
    7.       url: "/single", 
    8.       file, 
    9.     }); 
    10.   }); 
    11.  
    12. const request = axios.create({ 
    13.   baseURL: "http://localhost:3000/upload", 
    14.   timeout: 60000, 
    15. }); 
    16.  
    17. function upload({ url, file, fieldName = "file" }) { 
    18.   let formData = new FormData(); 
    19.   formData.set(fieldName, file); 
    20.   request.post(url, formData, { 
    21.     // 監(jiān)聽(tīng)上傳進(jìn)度 
    22.     onUploadProgress: function (progressEvent) { 
    23.       const percentCompleted = Math.round( 
    24.         (progressEvent.loaded * 100) / progressEvent.total 
    25.       ); 
    26.       console.log(percentCompleted); 
    27.     }, 
    28.   }); 

    拖拽上傳算是一個(gè)比較常見(jiàn)的場(chǎng)景,很多成熟的上傳組件都支持該功能。其實(shí)除了拖拽上傳外,還可以利用剪貼板實(shí)現(xiàn)復(fù)制上傳的功能。

    拖拽上傳示例:drag-drop-upload

    https://github.com/semlinker/file-upload-demos/tree/master/drag-drop-upload

    六、剪貼板上傳

    在介紹如何實(shí)現(xiàn)剪貼板上傳的功能前,我們需要了解一下 Clipboard API。Clipboard 接口實(shí)現(xiàn)了 Clipboard API,如果用戶(hù)授予了相應(yīng)的權(quán)限,就能提供系統(tǒng)剪貼板的讀寫(xiě)訪問(wèn)。在 Web 應(yīng)用程序中,Clipboard API 可用于實(shí)現(xiàn)剪切、復(fù)制和粘貼功能。該 API 用于取代通過(guò) document.execCommand API 來(lái)實(shí)現(xiàn)剪貼板的操作。

    在實(shí)際項(xiàng)目中,我們不需要手動(dòng)創(chuàng)建 Clipboard 對(duì)象,而是通過(guò) navigator.clipboard 來(lái)獲取 Clipboard 對(duì)象:

    在獲取 Clipboard 對(duì)象之后,我們就可以利用該對(duì)象提供的 API 來(lái)訪問(wèn)剪貼板,比如:

     
     
     
     
    1. navigator.clipboard.readText().then( 
    2.   clipText => document.querySelector(".editor").innerText = clipText 
    3. ); 

    以上代碼將 HTML 中含有 .editor 類(lèi)的第一個(gè)元素的內(nèi)容替換為剪貼板的內(nèi)容。如果剪貼板為空,或者不包含任何文本,則元素的內(nèi)容將被清空。這是因?yàn)樵诩糍N板為空或者不包含文本時(shí),readText 方法會(huì)返回一個(gè)空字符串。

    利用 Clipboard API 我們可以很方便地操作剪貼板,但實(shí)際項(xiàng)目使用過(guò)程中也得考慮它的兼容性:

    (圖片來(lái)源 —— https://caniuse.com/async-clipboard)

    要實(shí)現(xiàn)剪貼板上傳的功能,可以分為以下 3 個(gè)步驟:

    • 監(jiān)聽(tīng)容器的粘貼事件;
    • 讀取并解析剪貼板中的內(nèi)容;
    • 動(dòng)態(tài)構(gòu)建 FormData 對(duì)象并上傳。

    了解完上述步驟,接下來(lái)我們來(lái)分析一下具體實(shí)現(xiàn)的代碼。

    6.1 前端代碼

    html

      
     
     
     
    1.  
    2.    

      請(qǐng)先復(fù)制圖片后再執(zhí)行粘貼操作

       
     

    css

     
     
     
     
    1. #uploadArea { 
    2.    width: 400px; 
    3.    height: 400px; 
    4.    border: 1px dashed gray; 
    5.    display: table-cell; 
    6.    vertical-align: middle; 
    7. #uploadArea p { 
    8.    text-align: center; 
    9.    color: #999; 
    10. #uploadArea img { 
    11.    max-width: 100%; 
    12.    max-height: 100%; 
    13.    display: block; 
    14.    margin: auto; 

    js

    在以下代碼中,我們使用 addEventListener 方法為 uploadArea 容器添加 paste 事件。在對(duì)應(yīng)的事件處理函數(shù)中,我們會(huì)優(yōu)先判斷當(dāng)前瀏覽器是否支持異步 Clipboard API。如果支持的話(huà),就會(huì)通過(guò) navigator.clipboard.read 方法來(lái)讀取剪貼板中的內(nèi)容。在讀取內(nèi)容之后,我們會(huì)通過(guò)正則判斷剪貼板項(xiàng)中是否包含圖片資源,如果有的話(huà)會(huì)調(diào)用 previewImage 方法執(zhí)行圖片預(yù)覽操作并把返回的 blob 對(duì)象保存起來(lái),用于后續(xù)的上傳操作。

     
     
     
     
    1. const IMAGE_MIME_REGEX = /^image\/(jpe?g|gif|png)$/i; 
    2. const uploadAreaEle = document.querySelector("#uploadArea"); 
    3.  
    4. uploadAreaEle.addEventListener("paste", async (e) => { 
    5.   e.preventDefault(); 
    6.   const files = []; 
    7.   if (navigator.clipboard) { 
    8.     let clipboardItems = await navigator.clipboard.read(); 
    9.     for (const clipboardItem of clipboardItems) { 
    10.       for (const type of clipboardItem.types) { 
    11.         if (IMAGE_MIME_REGEX.test(type)) { 
    12.            const blob = await clipboardItem.getType(type); 
    13.            insertImage(blob, uploadAreaEle); 
    14.            files.push(blob); 
    15.          } 
    16.        } 
    17.      } 
    18.   } else { 
    19.       const items = e.clipboardData.items; 
    20.       for (let i = 0; i < items.length; i++) { 
    21.         if (IMAGE_MIME_REGEX.test(items[i].type)) { 
    22.           let file = items[i].getAsFile(); 
    23.           insertImage(file, uploadAreaEle); 
    24.           files.push(file); 
    25.         } 
    26.       } 
    27.   } 
    28.   if (files.length > 0) { 
    29.     confirm("剪貼板檢測(cè)到圖片文件,是否執(zhí)行上傳操作?")  
    30.       && upload({ 
    31.            url: "/multiple", 
    32.            files, 
    33.       }); 
    34.    } 
    35. }); 

    若當(dāng)前瀏覽器不支持異步 Clipboard API,則我們會(huì)嘗試通過(guò) e.clipboardData.items 來(lái)訪問(wèn)剪貼板中的內(nèi)容。需要注意的是,在遍歷剪貼板內(nèi)容項(xiàng)的時(shí)候,我們是通過(guò) getAsFile 方法來(lái)獲取剪貼板的內(nèi)容。當(dāng)然該方法也存在兼容性問(wèn)題,具體如下圖所示:

    (圖片來(lái)源 —— https://caniuse.com/mdn-api_datatransferitem_getasfile)

    前面已經(jīng)提到,當(dāng)從剪貼板解析到圖片資源時(shí),會(huì)讓用戶(hù)進(jìn)行預(yù)覽,該功能是基于 FileReader API 來(lái)實(shí)現(xiàn)的,對(duì)應(yīng)的代碼如下所示:

     
     
     
     
    1. function previewImage(file, container) { 
    2.   const reader = new FileReader(); 
    3.   reader.onload = function (e) { 
    4.     let img = document.createElement("img"); 
    5.     img.src = e.target.result; 
    6.     container.append(img); 
    7.   }; 
    8.   reader.readAsDataURL(file); 

    當(dāng)用戶(hù)預(yù)覽完成后,如果確認(rèn)上傳我們就會(huì)執(zhí)行文件的上傳操作。因?yàn)槲募菑募糍N板中讀取的,所以在上傳前我們會(huì)根據(jù)文件的類(lèi)型,自動(dòng)為它生成一個(gè)文件名,具體是采用時(shí)間戳加文件后綴的形式:

     
     
     
     
    1. function upload({ url, files, fieldName = "file" }) { 
    2.   let formData = new FormData(); 
    3.   files.forEach((file) => { 
    4.     let fileName = +new Date() + "." + IMAGE_MIME_REGEX.exec(file.type)[1]; 
    5.     formData.append(fieldName, file, fileName); 
    6.   }); 
    7.   request.post(url, formData); 

    前面我們已經(jīng)介紹了文件上傳的多種不同場(chǎng)景,接下來(lái)我們來(lái)介紹一個(gè) “特殊” 的場(chǎng)景 —— 大文件上傳。

    剪貼板上傳示例:clipboard-upload

    https://github.com/semlinker/file-upload-demos/tree/master/clipboard-upload

    七、大文件分塊上傳

    相信你可能已經(jīng)了解大文件上傳的解決方案,在上傳大文件時(shí),為了提高上傳的效率,我們一般會(huì)使用 Blob.slice 方法對(duì)大文件按照指定的大小進(jìn)行切割,然后通過(guò)多線程進(jìn)行分塊上傳,等所有分塊都成功上傳后,再通知服務(wù)端進(jìn)行分塊合并。具體處理方案如下圖所示:

    因?yàn)樵?JavaScript 中如何實(shí)現(xiàn)大文件并發(fā)上傳? 這篇文章中,阿寶哥已經(jīng)詳細(xì)介紹了大文件并發(fā)上傳的方案,所以這里就不展開(kāi)介紹了。我們只回顧一下大文件并發(fā)上傳的完整流程:

    前面我們都是介紹客戶(hù)端文件上傳的場(chǎng)景,其實(shí)也有服務(wù)端文件上傳的場(chǎng)景。比如在服務(wù)端動(dòng)態(tài)生成海報(bào)后,上傳到另外一臺(tái)服務(wù)器或云廠商的 OSS(Object Storage Service)。下面我們就以 Node.js 為例來(lái)介紹在服務(wù)端如何上傳文件。

    大文件分塊上傳示例:big-file-upload

    https://github.com/semlinker/file-upload-demos/tree/master/big-file-upload

    八、服務(wù)端上傳

    服務(wù)器上傳就是把文件從一臺(tái)服務(wù)器上傳到另外一臺(tái)服務(wù)器。借助 Github 上 form-data 這個(gè)庫(kù)提供的功能,我們可以很容易地實(shí)現(xiàn)服務(wù)器上傳的功能。下面我們來(lái)簡(jiǎn)單介紹一下單文件和多文件上傳的功能:

    8.1 單文件上傳

     
     
     
     
    1. const fs = require("fs"); 
    2. const path = require("path"); 
    3. const FormData = require("form-data"); 
    4.  
    5. const form1 = new FormData(); 
    6. form1.append("file", fs.createReadStream(path.join(__dirname, "images/image-1.jpeg"))); 
    7. form1.submit("http://localhost:3000/upload/single", (error, response) => { 
    8.   if(error) { 
    9.     console.log("單圖上傳失敗"); 
    10.     return; 
    11.   } 
    12.   console.log("單圖上傳成功"); 
    13. }); 

    8.2 多文件上傳

     
     
     
     
    1. const form2 = new FormData(); 
    2. form2.append("file", fs.createReadStream(path.join(__dirname, "images/image-2.jpeg"))); 
    3. form2.append("file", fs.createReadStream(path.join(__dirname, "images/image-3.jpeg"))); 
    4. form2.submit("http://localhost:3000/upload/multiple", (error, response) => { 
    5.   if(error) { 
    6.     console.log("多圖上傳失敗"); 
    7.     return; 
    8.   } 
    9.   console.log("多圖上傳成功"); 
    10. }); 

    觀察以上代碼可知,創(chuàng)建完 FormData 對(duì)象之后,我們只需要通過(guò) fs.createReadStream API 創(chuàng)建可讀流,然后調(diào)用 FormData 對(duì)象的 append 方法添加表單項(xiàng),最后再調(diào)用 submit 方法執(zhí)行提交操作即可。

    其實(shí)除了 ReadableStream 之外,F(xiàn)ormData 對(duì)象的 append 方法還支持以下類(lèi)型:

     
     
     
     
    1. const FormData = require('form-data'); 
    2. const http = require('http'); 
    3.  
    4. const form = new FormData(); 
    5. http.request('http://nodejs.org/images/logo.png', function(response) { 
    6.   form.append('my_field', 'my value'); 
    7.   form.append('my_buffer', new Buffer(10)); 
    8.   form.append('my_logo', response); 
    9. }); 

    服務(wù)端文件上傳的內(nèi)容就介紹到這里,關(guān)于 form-data 這個(gè)庫(kù)的其他用法,感興趣的話(huà),可以閱讀對(duì)應(yīng)的使用文檔。其實(shí)除了以上介紹的八種場(chǎng)景外,在日常工作中,你也可能會(huì)使用一些同步工具,比如 Syncthing 文件同步工具實(shí)現(xiàn)文件傳輸。好的,本文的所有內(nèi)容都已經(jīng)介紹完了,最后我們來(lái)做一個(gè)總結(jié)。

    服務(wù)端上傳示例:server-upload

    https://github.com/semlinker/file-upload-demos/tree/master/server-upload

    九、總結(jié)

    本文阿寶哥詳細(xì)介紹了文件上傳的八種場(chǎng)景,希望閱讀完本文后,你對(duì)八種場(chǎng)景背后使用的技術(shù)有一定的了解。由于篇幅有限,阿寶哥就沒(méi)有展開(kāi)介紹與 multipart/form-data 類(lèi)型相關(guān)的內(nèi)容,感興趣的小伙伴可以自行了解一下。

    此外,在實(shí)際項(xiàng)目中,你可以考慮直接使用成熟的第三方組件,比如 Github 上的 Star 數(shù) 11K+ 的 filepond。該組件采用插件化的架構(gòu),以插件的方式,提供了非常多的功能,比如 File encode、File rename、File poster、Image preview 和 Image crop 等??傊且粋€(gè)很不錯(cuò)的組件,以后有機(jī)會(huì)的話(huà),大家可以嘗試一下。

    十、參考資源

    MDN- Clipboard

    MDN - DataTransfer

    JSZip- API

    JavaScript 如何檢測(cè)文件的類(lèi)型?

    JavaScript 中如何實(shí)現(xiàn)大文件并發(fā)上傳?


    網(wǎng)站標(biāo)題:文件上傳,搞懂這8種場(chǎng)景就夠了
    轉(zhuǎn)載注明:http://www.5511xx.com/article/ccdphic.html