DIV CSS 佈局教程網

jBox 彈窗在 ASP.NET 中一閃而過?阻止表單預設提交與事件冒泡的正確做法
編輯:關於JavaScript     

jBox 是個相當好用的對話框元件。但在 ASP.NET Web Forms 裡用它,會遇到一個很典型的困擾:在按鈕的用戶端點擊事件中呼叫 jBox,對話框還沒看清楚,頁面就已經刷新跳走了——甚至根本沒看見。原因不在 jBox,而在 ASP.NET 的表單模型。

問題根源

ASP.NET 的 <asp:Button> 預設會觸發表單提交(postback)。而提交表單就是一次完整的頁面往返:瀏覽器送出請求、伺服器處理、回傳新頁面並重新載入。你的 jBox 才剛 show 出來,整個 DOM 就被新頁面取代了,於是「一閃而過」。

所以解法分兩半:點擊時阻止提交,對話框關閉時才真的提交。

第一步:阻止預設行為

function stopDefault(e) {
  // W3C 標準做法
  if (e && e.preventDefault)
    e.preventDefault();
  else
    // IE 的寫法
    window.event.returnValue = false;

  return false;
}

這段同時照顧了標準瀏覽器與舊 IE,是跨瀏覽器阻止預設行為的固定寫法。

第二步:在對話框關閉時提交

jBox 的 options 裡有 closed 回呼,正好拿來做這件事——用 jQuery 找到表單並呼叫 submit():

// 找到需要提交的表單
$("#" + form1Id).submit();

注意這是 jQuery 物件的 submit(),它會觸發 submit 事件並執行驗證流程,跟原生 form.submit() 不同(後者會跳過 submit 事件處理器)。在 ASP.NET 裡若有用到 RequireFieldValidator 等驗證控制項,通常要保留 jQuery 版本或直接觸發 WebForm_DoPostBackWithOptions。

第三步:取得控制項的用戶端 ID

ASP.NET 會把控制項 ID 加上命名容器前綴(例如 ctl00_ContentPlaceHolder1_btnSave),所以不能硬寫,要從伺服器端語法取出:

var btnSaveId = "<%= this.btnSave.ClientID %>";
var form1Id   = "<%= this.form1.ClientID %>";

完整組裝

// 註冊按鈕的點擊事件處理
$("#" + btnSaveId).click(function (e) {

  // 設定在關閉對話時提交表單
  var options = {
    closed: function () {
      alert("submit");
      $("#" + form1Id).submit();
    }
  };

  // 顯示 jBox 對話框
  var info = 'jQuery jBox<br /><br />版本:v2.0<br />日期:2011-7-24<br />';
  info += '官網:<a target="_blank" href="https://kudystudio.com/jbox">https://kudystudio.com/jbox</a>';
  $.jBox(info, options);

  // 阻止預設的事件處理
  stopDefault(e);
});

return false 與 stopDefault 的差別

這兩者常被混用,但行為不同,值得記清楚:

  • return false(在 jQuery 事件處理器中)同時阻止預設行為與事件冒泡,等同於呼叫 preventDefault() 加 stopPropagation()。
  • stopDefault() 只阻止預設行為,事件照樣往上冒泡,父層的處理器仍會收到。

如果你只想阻止冒泡,那要另外寫一個函式:

function stopBubble(e) {
  if (e && e.stopPropagation)
    // 標準瀏覽器
    e.stopPropagation();
  else
    // 舊 IE
    window.event.cancelBubble = true;
}

實務上的判斷很簡單:要攔表單提交用 preventDefault,要防止父容器誤觸用 stopPropagation,兩者需求不同不要互相代替。「一閃而過」這種狀況只需要前者。

還要注意的幾件事

  • ScriptManager 與 partial postback:若按鈕在 UpdatePanel 內,用戶端攔截後要手動觸發 __doPostBack 才能進行非同步回傳,單純的 $("#form").submit() 會變成整頁刷新。
  • 確認再送出才是重點:這類「彈確認框再提交」的互動,記得把「取消」路徑也處理掉,否則使用者按了取消卻發現資料還是送出去了。
  • UseSubmitBehavior:ASP.NET 有另一個更直接的處理方式——把 <asp:Button> 的 UseSubmitBehavior="false" 設為停用,它就不再使用原生 submit 行為,改由 ASP.NET 的 script 觸發,能避開不少這類衝突。

一句話總結:jBox 沒問題,問題是你攔住了表單的一半、卻忘了安排另一半什麼時候放行。把「阻止提交」和「關閉後提交」配成一對,行為就正常了。

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