DIV CSS 佈局教程網

AJAX 上傳時參數不更新的問題與 setData 解法
編輯:JavaScript基礎知識     

曾經從網上下載一個 jQuery 的 AJAX 上傳外掛,左側是上傳分類選單。原本規劃是依分類在伺服端建立不同資料夾存放檔案,因此需要把分類名稱當參數送到後端。分類資料由資料庫讀出、以 repeater 產生,點擊某個分類時加上選中樣式,同時把名稱存進變數 uploadCatlog。

症狀

參數確實能取到、也確實傳給了後端,但只有第一次是正確的,之後每次上傳帶的都是第一次的分類值,完全不更新。更奇怪的是,同一個變數在 onComplete 回呼中讀出來的值是正確的、已經更新過了。

原因

問題出在外掛的實例化時機。原本的程式把 new AjaxUpload(...) 寫在 btnUpload.click 裡面,但 data 選項是在建立實例的那一刻被讀取並保存下來的。也就是說,第一次點擊時實例被建立,data: { "catlog": uploadCatlog } 的當時值被固定住;後續再點擊,雖然 uploadCatlog 變了,實例卻沒有重建,data 裡存的仍是舊值。而 onComplete 是在函式閉包中讀取變數本身,自然拿得到最新值。

這是一個典型的「值在建立時被求值,而非呼叫時」的陷阱。

有問題的原始寫法

$(function () {
  var uploadCatlog;
  $("#menu .nav5").addClass("menu_active").siblings().removeClass("menu_active");

  $("#kllst li").click(function () {
    $(this).addClass("currentli").siblings().removeClass();
    uploadCatlog = $(this).text();
  });

  var btnUpload = $('#upload');
  var status = $('#status');

  btnUpload.click(function () {
    if (uploadCatlog == undefined) {
      status.text("必須先選擇上傳文件的類別!").addClass('error');
      return false;
    }
    new AjaxUpload(btnUpload, {
      action: 'handler/doUpload.ashx',
      name: 'uploadfile',
      onSubmit: function (file, ext) {
        if (!(ext && /^(doc|docx|xls)$/.test(ext))) {
          status.text('只支持 WORD、EXCEL 格式上傳!').addClass('error');
          return false;
        }
        status.text('正在上傳,請稍候...');
      },
      data: { "catlog": uploadCatlog }, // 這裡的值在建立實例時就固定了
      onComplete: function (file, response) {
        status.text('').removeClass('error');
        if (response == "success") {
          var fimgtype;
          if (file.indexOf(".doc") != -1 || file.indexOf(".docx") != -1) { fimgtype = "word"; }
          if (file.indexOf(".xls") != -1) { fimgtype = "excel"; }
          $('<li></li>').appendTo('#files')
            .html('<img src="images/' + fimgtype + '.png" alt="" /><br />['
                  + uploadCatlog + ']' + file)
            .addClass('success');
        } else {
          $('<li></li>').appendTo('#files').text(file).addClass('error');
        }
      }
    });
  });
});

解法:用 setData 動態設定

外掛本身提供了 setData() 方法,正是為此設計。在 onSubmit 回呼中呼叫它,就能在每次上傳前寫入最新的參數:

// 建立實例後保存參考
var upload = new AjaxUpload('#div_id', { action: 'upload.php' });

// 例如使用者選擇了某些東西,動態設定參數
upload.setData({ "catlog": uploadCatlog });

套回原本的結構,改動只有兩處:把實例建立移到 click 之外只跑一次,並在 onSubmit 中補上 setData。

其他可行方案

每次點擊都重建實例,讓 data 重新求值。這是最直白的修法,代價是重複建立物件。

把參數寫進表單的隱藏欄位,讓外掛從表單序列化時一併帶走,這樣就不依賴 data 選項的靜態性。

改用 FormData。現代做法直接避開這類外掛的狀態問題:

$('#uploadForm').on('submit', function (e) {
  e.preventDefault();
  var fd = new FormData();
  fd.append('uploadfile', $('#fileInput')[0].files[0]);
  fd.append('catlog', uploadCatlog); // 每次送出時才取值
  $.ajax({
    url: 'handler/doUpload.ashx',
    type: 'POST',
    data: fd,
    processData: false,
    contentType: false,
    success: function (res) { /* 處理回應 */ }
  });
});

FormData 在呼叫 $.ajax 的當下才組裝內容,天然就不會有「值被提前固定」的問題;搭配 processData: false 與 contentType: false 讓瀏覽器自行處理 multipart 邊界,也不必再依賴第三方上傳外掛。

這類問題的通則

遇到「只有第一次正確」的 bug,通常要問三件事:這個值是在哪個時刻被求值的?它存在哪裡(閉包、物件屬性、預設參數)?後續變更會不會反映到那個位置?把求值時機攤開來看,問題幾乎都會浮現。AJAX 上傳的參數提交總是因為各種各樣的細節出問題,唯有理解底層機制,才能穩定地避開它們。

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