DIV CSS 佈局教程網

基於 HTML5 的多圖 Ajax 上傳:可預覽、可拖拽
編輯:AJAX基礎知識     

一、圖片上傳的演進

在 XHTML 時代,一個 file 控件一次只能選一張圖。想一次傳多張,只能借 Flash 之手,比如曾經很流行的 swfupload.js。但 Flash 方案的使用成本不低:swf 文件必須與頁面放在同一目錄,JavaScript 文件本體也不小。

後來出現過所謂的「Ajax Upload 多文件上傳插件」,它的巧思是用隱藏的 iframe 模擬 Ajax 上傳——但本質上仍然是一次一張,只是可以反覆添加。

HTML5 把這件事變簡單了:原生支援多圖選擇、支援 Ajax 上傳、支援上傳前本地預覽、還支援拖拽上傳,而且幾乎只用 file 控件本身,JS 代碼寥寥可數。

二、效果預覽

使用最新的 Firefox 或 Chrome 打開 demo 頁面,點擊 file 控件即可一次選多張:

若選到了非圖片檔案,或圖片尺寸過大,會即時彈出提示:

也可以直接把桌面上的圖片拖進接收區域:

鬆手之後立刻可預覽(此時尚未上傳到服務器):

預覽階段就能提前刪除不想要的圖,確認無誤再點上傳:

上傳成功後,頁面地址直接返回:

對應的 upload 目錄下,圖片已經就位:

提醒一句:demo 的空間有限,圖片目錄會定期清理,別把它當免費圖床。

三、骨架腳本 zxxFile.js

核心邏輯被抽成一個只有幾 K、百來行的小文件 zxxFile.js,負責檔案的選擇、刪除等上傳相關邏輯。它是原生 JS 寫的,因此可以與 jQuery、YUI、MooTools 等庫共存不衝突。

本質上它就是一個小對象:

 var ZXXFILE = { //骨架們... } 

補充說明:文中多次提到的 file 參數指的是 file object 對象,自帶 name、size、type 等屬性;在 zxxFile.js 中還額外附加了一個便於定位元素的 index 索引屬性。

光有骨架什麼也做不了。demo 之所以有效果,是按骨架填入了血肉——直接「右鍵查看源代碼」即可看到全部 JavaScript。也就是說,拿著 zxxFile.js 這個骨架,配上你自己熟悉的 JS 庫,就能寫出屬於自己的 HTML5 多文件 Ajax 上傳插件。

四、demo 頁面的關鍵代碼

整體結構是「骨架 + 血肉」:

 var params = { //血肉們 }; ZXXFILE = $.extend(ZXXFILE, params); ZXXFILE.init(); 

fileInput / dragDrop / upButton

 fileInput: $("#fileImage").get(0), dragDrop: $("#fileDragArea").get(0), upButton: $("#fileSubmit").get(0) 

因為需要的是原生 DOM 對象,所以用 jQuery 的 get 方法取出。多選能力的關鍵就在那個 multiple 屬性:

<input id="fileImage" type="file" size="30" name="fileselect[]" multiple />

url

直接取表單的 action 作為 Ajax 上傳地址:url: $("#uploadForm").attr("action")

filter:上傳前先過一遍

file 控件什麼檔案都能選,但 demo 只做圖片,而且空間有限,超大圖必須攔下來:

 filter: function(files) { var arrFiles = []; for (var i = 0, file; file = files[i]; i++) { if (file.type.indexOf("image") == 0) { if (file.size >= 512000) { alert('您這張"'+ file.name +'"圖片大小過大,應小於500k'); } else { arrFiles.push(file); } } else { alert('文件"' + file.name + '"不是圖片。'); } } return arrFiles; }

過濾後的列表交給 zxxFile.js 自動整合,確保上傳準確。

onSelect:本地預覽的核心

實現「上傳前先看見」,靠的是 FileReader:

 var reader = new FileReader(), htmlImage; reader.onload = function(e) { htmlImage = '<img src="'+ e.target.result +'" />'; } reader.readAsDataURL(file); 

完整實現如下,看似很長,其實只是在組裝 HTML 片段:

 onSelect: function(files) { var html = '', i = 0; //等待載入gif動畫 $("#preview").html('<div class="upload_loading"></div>'); var funAppendImage = function() { file = files[i]; if (file) { var reader = new FileReader() reader.onload = function(e) { html = html + '<div id="uploadList_'+ i +'" class="upload_append_list"><p><strong>' + file.name + '</strong>'+ '<a href="javascript:" class="upload_delete" title="刪除" data-index="'+ i +'">刪除</a><br />' + '<img id="uploadImage_' + i + '" src="' + e.target.result + '" class="upload_image" /></p>'+ '<span id="uploadProgress_' + i + '" class="upload_progress"></span>' + '</div>'; i++; funAppendImage(); } reader.readAsDataURL(file); } else { //圖片相關HTML片段載入 $("#preview").html(html); if (html) { //刪除方法 $(".upload_delete").click(function() { ZXXFILE.funDeleteFile(files[parseInt($(this).attr("data-index"))]); return false; }); //提交按鈕顯示 $("#fileSubmit").show(); } else { //提交按鈕隱藏 $("#fileSubmit").hide(); } } }; //執行圖片HTML片段的載入 funAppendImage(); } 

留意 HTML 裡到處用到的索引 i,它是後續刪除時定位元素的依據。刪除事件必須調用 ZXXFILE.funDeleteFile(),這樣才會真正把檔案從列表中移除,並觸發 onDelete 回調。

其餘回調方法

 //刪除時漸隱 onDelete: function(file) { $("#uploadList_" + file.index).fadeOut(); } //拖入時加類名 onDragOver: function() { $(this).addClass("upload_drag_hover"); } //移出時去類名 onDragLeave: function() { $(this).removeClass("upload_drag_hover"); } //上傳進度 onProgress: function(file, loaded, total) { var eleProgress = $("#uploadProgress_" + file.index), percent = (loaded / total * 100).toFixed(2) + '%'; eleProgress.show().html(percent); } //單張成功 onSuccess: function(file, response) { $("#uploadInf").append("<p>上傳成功,圖片地址是:" + response + "</p>"); } //單張失敗 onFailure: function(file) { $("#uploadInf").append("<p>圖片" + file.name + "上傳失敗!</p>"); $("#uploadImage_" + file.index).css("opacity", 0.2); } //全部完成 onComplete: function() { $("#fileSubmit").hide(); $("#fileImage").val(""); $("#uploadInf").append("<p>當前圖片全部上傳完畢,可繼續添加上傳。</p>"); }

服務端(PHP)

HTML5 的二進制上傳可以直接從 php://input 讀取原始流,配合自定義的檔案名標頭即可:

 $fn = (isset($_SERVER['HTTP_X_FILENAME']) ? $_SERVER['HTTP_X_FILENAME'] : false); if ($fn) { file_put_contents( 'uploads/' . $fn, file_get_contents('php://input') ); echo "https://www.zhangxinxu.com/study/201109/uploads/$fn"; exit(); } 

五、什麼時候能用、什麼時候別用

坦白說,IE 系列不支持,Windows 下的 Safari、Opera 對 HTML5 檔案上傳的支援也不完整。那還學它幹什麼?

要分場合。面向廣大公眾用戶的外部項目,現在就上這套技術為時過早;但公司內網項目用它完全沒問題。有意思的是,很多內網系統反而一味遷就老版本 IE,對現代瀏覽器支援不佳,這其實走反了方向。

我們公司近期的做法是:內網開發以 Chrome 等現代瀏覽器為基準(IE 仍可用),內部人員統一使用 Chrome。反饋很不錯,無論界面、交互還是速度都有明顯提升。此後再給內網同事做多圖上傳,直接用 HTML5 就好——簡單、快速,開發體驗也愉快得多。

最後說明一下,demo 主要用於示範,若有疏漏還請包容;zxxFile.js 也是新出爐的骨架,未經充分打磨,歡迎提出改進意見。

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