在 WinForm 開發中,我們常用 MessageBox 彈出提示,功能簡單卻非常實用。Web 頁面裡,瀏覽器也提供了 alert 與 confirm 這類腳本語句:

問題是這些彈出視窗的樣式單調到無法設定,標題還會因瀏覽器而異,對講究外觀的現代網站來說實在扣分。
jQuery 這麼流行,網上卻似乎沒有類似 MessageBox 的外掛(也可能只是我沒找到)。模態視窗外掛倒是很多,但都不是我要的。既然沒有現成的,只好把過去寫在自己 JS 框架上的 MessageBox 移植過來,也就是本文的 jMessageBox。
使用方式很簡單,CSS 與 JS 搭配即可:CSS 負責自訂視窗外觀,JavaScript 負責呼叫。
jQuery.jMessageBox.show('Hello word!');
是不是有找到 MessageBox 的感覺?但這種寫法無法控制標題內容,也無法定義「確定」按鈕的行為——點下去就只是關閉視窗。

jQuery.jMessageBox.show('系統消息', '您好!');
這次可以改標題了,但「確定」按鈕的行為依然只能關閉視窗。

jQuery.jMessageBox.show({
width : 350,
title : '系統消息',
message : '是否繼續下一步操作?',
yesButton : {
text : '是',
click : function(){ jQuery.jMessageBox.hide(); }
},
noButton : {
text : '否',
click : function(){ jQuery.jMessageBox.hide(); }
},
cancelButton : {
text : '取消',
click : function(){ jQuery.jMessageBox.hide(); }
},
bottom : {
text : '說明: 如果你想繼續操作,請點擊"是"!',
click : function(){ alert('你在點我嗎?'); }
}
});
這個範例中我們定義了:視窗寬度、標題、內容、yes 按鈕的文字與動作、no 按鈕的文字與動作、cancel 按鈕的文字與動作,以及底部說明的文字與動作。

1. 全域設定參數:jQuery.jMessageBox.settings
注意:全域參數只在第一次呼叫 show 之前、或使用簡易版 show 時生效。
width —— 預設視窗寬度,預設值 350。
title —— 預設標題,預設為空。
bottomText —— 視窗底部說明文字,預設為空。
yesButtonText —— yes 按鈕文字,預設為空。
noButtonText —— no 按鈕文字,預設為空。
cancelButtonText —— cancel 按鈕文字,預設為空。
2. 視窗參數
這組參數可在每次呼叫 show 時傳入,用來設定該次顯示的視窗樣式。
width —— 視窗寬度,不設定則取全域設定的 width。
height —— 視窗高度,不設定則為自動(建議保持自動)。
top —— 視窗顯示時的上邊距。
left —— 視窗顯示時的左邊距。
注意:top 與 left 必須同時設定或同時不設定。不設定(建議)時預設固定置中顯示。
title —— 視窗標題,不設定則取全域設定的 title;若設為 null 或空字串,會隱藏標題欄。
message —— 視窗顯示的內容;不設定或設為 null、空字串則隱藏內容區。
yesButton —— 設定 yes 按鈕的文字(text)與點擊事件(click);不設定則不顯示該按鈕。
noButton —— 同上,對應 no 按鈕。
cancelButton —— 同上,對應 cancel 按鈕。
bottom —— 設定底部文字欄的描述文字(text)與點擊事件(click);不設定則不顯示底部文字欄。
這個設計讓「三個按鈕任意組合」成為可能:需要「確定/取消」就只傳 yesButton 與 cancelButton,需要三選一就三個都傳,搭配 onclose 之類的收尾邏輯,就能取代絕大多數原本用 alert 與 confirm 硬湊的場合。