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。
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(在 jQuery 事件處理器中)同時阻止預設行為與事件冒泡,等同於呼叫 preventDefault() 加 stopPropagation()。stopDefault() 只阻止預設行為,事件照樣往上冒泡,父層的處理器仍會收到。如果你只想阻止冒泡,那要另外寫一個函式:
function stopBubble(e) {
if (e && e.stopPropagation)
// 標準瀏覽器
e.stopPropagation();
else
// 舊 IE
window.event.cancelBubble = true;
}
實務上的判斷很簡單:要攔表單提交用 preventDefault,要防止父容器誤觸用 stopPropagation,兩者需求不同不要互相代替。「一閃而過」這種狀況只需要前者。
__doPostBack 才能進行非同步回傳,單純的 $("#form").submit() 會變成整頁刷新。<asp:Button> 的 UseSubmitBehavior="false" 設為停用,它就不再使用原生 submit 行為,改由 ASP.NET 的 script 觸發,能避開不少這類衝突。一句話總結:jBox 沒問題,問題是你攔住了表單的一半、卻忘了安排另一半什麼時候放行。把「阻止提交」和「關閉後提交」配成一對,行為就正常了。