最近在專案裡替表單加上驗證提示,想用氣泡(tooltip)而不是低調的紅字。理論上新版 jquery.validate 本身就支援這類效果,但實際跑起來在我的環境裡不太順手,於是決定自己接一個。
先試的是 qtip2,樣式確實漂亮,官方也附了與 jquery.validate 整合的範例。問題是範例能跑、換成我的頁面就不顯示,折騰一陣後推測是 jQuery 版本差異所致——用它附的 jQuery 可以,用我專案裡的就不行。時間不等人,放棄。
最後選了 poshytip-1.1,樣式同樣體面,接入也乾脆。其中 positionX 與 positionY 這兩個自訂屬性用來控制氣泡出現的方向:
$(document).ready(function () {
// validate the comment form when it is submitted
var myForm = $('form:first');
myForm.validate({
onkeyup: false,
success: function (element) {
var elem = $(element);
elem.poshytip('disable');
elem.poshytip('destroy');
},
errorPlacement: function (error, element) {
var elem = $(element);
if (!error.is(':empty')) {
//右:x=right;y=center
//左:x=left;y=center
//上:x=inner-left
//下:x=center;y=bottom
var aX = "center";
if (elem.attr("positionX") != null) {
aX = elem.attr("positionX");
}
var aY = "bottom";
if (elem.attr("positionY") != null) {
aY = elem.attr("positionY");
}
elem.filter(':not(.valid)').poshytip({
content: error,
alignTo: 'target',
alignX: aX,
alignY: aY,
offsetX: 0,
offsetY: 5
});
} else {
elem.poshytip('disable');
elem.poshytip('destroy');
}
}
});
});
errorPlacement 取代 errorElement。驗證失敗時,我們不產生任何提示節點,而是把 error 物件直接當作 poshytip 的內容。驗證通過時(success)就把已存在的氣泡 disable 再 destroy,避免殘留。
用 data 屬性控制每個欄位的方向。與其為每個輸入框寫一份規則,不如在 HTML 上標註 positionX / positionY,程式讀取後套用。這樣提示方向的調整完全由頁面結構決定,不必回頭改 JS。
offsetY 留一點間距。氣泡緊貼輸入框邊緣視覺上會很擠,給 5px 的垂直偏移剛剛好。
onkeyup 不能設為 true。一旦開啟,某些欄位的氣泡會在輸入過程中反覆出現又消失,甚至停留不去,體驗相當怪異。目前的做法是關掉它,改由 blur 或 submit 觸發驗證。如果各位有更好的處理方式,歡迎指教——理想狀態應該是「已顯示的氣泡在內容變合法時即時消失,但不合法時不要每秒跳出來一次」。