DIV CSS 佈局教程網

Dropzone.js 實作檔案拖拽上傳(含參數說明與免表單寫法)
編輯:關於JavaScript     

Dropzone.js 是一個開源的 JavaScript 函式庫,專門解決「拖曳上傳」這件事。它把 AJAX 非同步上傳、檔案大小限制、類型白名單、上傳進度與縮圖預覽都做好了,而且不依賴 jQuery,這在現在的前端環境裡算是相當友善的一點。

效果預覽 · 原始碼下載

最基礎用法:一個 class 就搞定

寫一個正常的表單,加上 dropzone 這個 class,剩下的 Dropzone 會自己處理:

<form id="mydropzone" action="/upload.php" class="dropzone"></form>

Dropzone 會自動找出帶有 .dropzone 的表單,並依 action 屬性把檔案 POST 到後端,後端收到的就跟你處理一個普通的檔案輸入欄位一樣:

<input type="file" name="file" />

接著在 upload.php 裡寫上傳邏輯即可。官方下載包裡只有前端程式碼,不含後端範例,本站另外提供了 PHP 版的完整實作可以參考。

最後把函式庫載入:

<script src="dropzone.min.js"></script>

就這樣,打開瀏覽器已經可以拖檔案進去測試了。樣式要自己寫也沒問題,或直接沿用範例檔裡的 CSS。

不想用 form?換成 div 也可以

有些介面(例如彈出式視窗裡的上傳區)根本不會有 <form>。這時候放一個 div 上去,再手動初始化:

<div id="mydropzone" class="dropzone"></div>
var myDropzone = new Dropzone("div#mydropzone", { url: "upload.php" });

如果你的專案裡還有 jQuery,也能寫成:

$("#dropz").dropzone({ url: "upload.php" })

常用參數整理

Dropzone 最強的地方是夠靈活,參數與事件又多又細。以下幾個是實務上最常調整的:

url:最重要的參數,決定檔案要送到哪一支程式。
method:預設 POST,必要時可改為 PUT。
paramName:對應檔案欄位名稱,預設是 file。
maxFilesize:單檔大小上限,單位是 MB。
maxFiles:預設 null,可指定數字來限制總檔數。
addRemoveLinks:預設 false,設為 true 會為每個檔案加上刪除連結。
acceptedFiles:允許的檔案類型,逗號分隔的 MIME type 或副檔名,例如 image/*,application/pdf,.psd。
uploadMultiple:是否一次送出多檔,預設 false;開啟後等同在表單上加了 multiple。
headers:額外的自訂標頭,例如 {"custom-header": "value"}。
init:初始化時呼叫的函式,用來掛自己的事件監聽。
forceFallback:Fallback 是瀏覽器不支援時的替代方案,設為 true 會強制走這條路。
fallback:當瀏覽器不支援外掛時被呼叫的函式。

實務上的小提醒

前端限制永遠只是使用者體驗的優化,真正的檔案大小與類型驗證一定要在後端再做一次;maxFilesize 與 acceptedFiles 都只是提示,攔不住刻意繞過的請求。另外若要顯示自訂進度條或縮圖,init 裡掛 addedfile、uploadprogress、success 這幾個事件是最省事的做法。

以上就是 Dropzone.js 實現拖拽上傳的整理,需要的朋友可以搭配範例原始碼一起看。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved