這個範例用 uploadify 搭配一般處理程序(.ashx)完成圖片上傳,並在上傳成功後即時顯示預覽圖。前端負責互動與提示,後端負責存檔與回傳檔名,兩邊透過一個簡單的約定溝通:成功回傳檔名,失敗回傳 0。
常用選項
auto(布林):加入佇列時是否自動上傳。buttonImg / buttonText:瀏覽按鈕的背景圖路徑/顯示文字。cancelImg:取消按鈕的背景圖路徑。checkScript:上傳前檢查伺服器是否已有同名檔的後端腳本路徑。displayData:上傳過程中在佇列裡顯示的資訊類型。fileDataName:後端要處理的檔案欄位名稱(即 file input 的 name)。fileDesc / fileExt:檔案類型下拉選單顯示的文字/允許的副檔名。folder:上傳後檔案要存放的路徑。height / width:瀏覽按鈕的高與寬。hideButton:設為 true 可隱藏 flash 按鈕,改由自己的 div 定義樣式。method:送往後端的表單方法。multi:是否允許多檔上傳。queueID:作為檔案佇列容器的元素 id。queueSizeLimit:佇列中允許的檔案數量。removeCompleted:完成上傳後是否自動移出佇列。rollover:是否啟用按鈕的滑鼠移入狀態。script:處理上傳的後端腳本路徑。scriptData:隨上傳一併送給後端的 JSON 資料。simUploadLimit:允許同時上傳的檔案數。sizeLimit:單檔大小限制(位元組)。uploader:uploadify.swf 的路徑。常用事件:onAllComplete、onCancel、onCheck、onClearQueue、onComplete、onError、onInit、onOpen、onProgress、onQueueFull、onSelect、onSelectOnce、onSWFReady。
常用方法:.uploadify() 建立實例、.uploadifyCancel() 移除單一檔案、.uploadifyClearQueue() 清空佇列並取消所有上傳、.uploadifySettings() 變更設定、.uploadifyUpload() 觸發上傳。
實際開發時不需要把這些全部背起來,知道有哪些、要用時再查即可。
先載入樣式:
<link href="../Plugin/uploadify.css" rel="stylesheet" type="text/css" />
再載入 JS。順序至關重要:uploadify 是以 jQuery 開發的,必須先載入 jQuery,否則會直接報錯。
<script type="text/javascript" src="../js/jquery-1.4.2.min.js"></script>
<script src="../Plugin/swfobject.js" type="text/javascript"></script>
<script src="../Plugin/jquery.uploadify.v2.1.4.min.js" type="text/javascript"></script>
<tr>
<th scope="row">圖片:</th>
<td>
<div style="float:left;width:125px;height:35px;">
<input type="file" name="uploadify" id="uploadify" />
<%-- 上傳時的進度條 --%>
</div>
<div id="fileQueue" style="float:left;height:35px;"></div>
<div style="float:left;height:35px;">
<a href="javascript:$('#uploadify').uploadifyUpload()" class="btn-lit"><span>上傳</span></a>
<a href="javascript:$('#uploadify').uploadifyClearQueue()" class="btn-lit"><span>取消上傳</span></a>
</div>
</td>
</tr>
<tr>
<th scope="row"> </th>
<td><asp:Image ID="pic" runat="server" /></td>
<%-- 成功上傳後的圖片預覽 --%>
</tr>
$(document).ready(function () {
$("#uploadify").uploadify({
'uploader': '../Plugin/uploadify.swf',
'script': 'UploadImg.ashx',
'cancelImg': '../Plugin/cancel.png',
'folder': '../upload',
'buttonText': 'SELECT Pic',
'fileExt': '*.jpg;*.gif;*.png', // 允許的格式
'fileDesc': 'Web Image Files(.JPG,.GIF,.PNG)',
'queueID': 'fileQueue',
'sizeLimit': '2048000', // 單檔上限 2MB
'auto': false, // 需手動觸發上傳
'multi': false, // 一次只允許一張
'onCancel': funCancel, // 使用者取消時
'onComplete': funComplete, // 完成上傳時
'OnError': funError // 上傳出錯時
});
});
// 使用者取消
function funCancel(event, ID, fileObj, data) {
jBox.tip('您取消了' + fileObj.name + '操作', 'info');
}
// 上傳完成:回傳檔名則顯示預覽,回傳 0 視為失敗
function funComplete(event, ID, fileObj, response, data) {
if (response == 0) {
jBox.tip('圖片' + fileObj.name + '操作失敗', 'info');
return;
}
$("#pic").attr("src", "../upload/" + response).height(200).width(300);
jBox.tip('圖片' + fileObj.name + '操作成功', 'info');
}
// 上傳出錯
function funError(event, ID, fileObj, errorObj) {
jBox.tip(errorObj.info);
}
context.Response.ContentType = "text/plain";
context.Response.Charset = "utf-8";
HttpPostedFile file = context.Request.Files["Filedata"];
string uploadPath = HttpContext.Current.Server.MapPath(context.Request["folder"]) + "\\";
if (file != null) {
string[] fn = file.FileName.Split('.');
string ext = fn[fn.Length - 1];
// 以時間戳命名,避免同名覆蓋
string filename = DateTime.Now.ToString("yyyyMMddhhmmss") + "." + ext;
if (!Directory.Exists(uploadPath)) {
Directory.CreateDirectory(uploadPath);
}
file.SaveAs(uploadPath + filename);
// 少了這段,上傳成功後佇列的顯示不會自動消失
context.Session[context.Session["userName"].ToString()] = filename;
context.Response.Write(filename); // 成功:回傳檔名
} else {
context.Response.Write("0"); // 失敗:回傳 0
}
前後端的約定很單純:成功回傳檔名,失敗回傳 0。前端不解析複雜結構,只要判斷是不是 0,不為 0 就動態幫 img 加上 src。
原始碼下載:https://xiazai.baidu.com/201606/yuanma/jQuery-uploadify-ajax-upload(baidu.com).rar
最後提醒:範例中的 fileExt 只是前端限制,後端必須再檢查一次副檔名甚至實際的檔案內容,否則使用者可以繞過前端直接送出惡意檔案。