DIV CSS 佈局教程網

uploadify 外掛實作 AJAX 圖片上傳(含後端處理)
編輯:關於JavaScript     

這個範例用 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>

三、HTML 結構

<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 只是前端限制,後端必須再檢查一次副檔名甚至實際的檔案內容,否則使用者可以繞過前端直接送出惡意檔案。

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