表單驗證失敗時,除了把欄位框起來,還可以在旁邊彈出一個小氣泡說明原因。jCallout 就是專門做這件事的輕量插件。
專案下載:https://github.com/anupamsmaurya/jCallout
使用前提是先引入 jQuery 與 jCallout 的腳本。

欄位本身很普通,只用一個 class 標記為必填:
<tr>
<td class="columnName">用戶名:</td>
<td><input id="hTbxUserName" class="needCheck" type="text"/><span class="necessary">*</span></td>
</tr>
$('#hTbxUserName').jCallout(
'initWithoutShow', {
message: "必填項!",
position: "right",
backgroundColor: "#f00",
textColor: "#fff",
showEffect: "fade",
showSpeed: 300,
hideEffect: "fade",
hideSpeed: 300,
$closeElement: $('')
});
插件提供兩個初始化模式:init 呼叫後氣泡立刻顯示;initWithoutShow 則只註冊而不顯示,等到需要時再叫它出來。表單驗證的情境幾乎都用後者。
var $userNameInput = $("#hTbxUserName");
$userNameInput.blur(function() {
if($userNameInput.val().length == 0){
$userNameInput.jCallout('show');
}
});
參數 $closeElement 決定氣泡上的關閉鈕長什麼樣子。看插件源碼可以發現它的預設值是:
$closeElement: $('<span style="float: right; cursor: pointer">(X)</span>'),
若不特別設成 $(''),氣泡右上角就會出現一個 (X),點它即可關閉:

另外,氣泡內容接受 HTML 字串,所以也能放圖片:
message: "<img src='images/11.png'>必填項!"

實務上使用時記得兩件事:一是氣泡是浮動層,若父元素有 overflow:hidden 可能會被裁切;二是同一欄位重複呼叫 jCallout('show') 前,最好先判斷是否已在顯示中,避免疊出多個氣泡。