普元 EOS 這類平台在表單驗證時會動態產生提示層,但客製驗證(例如單選、多選必填)時,往往需要在驗證通過後把提示層收掉。以下兩個函式就是為此設計的。
// 參數為消息提示層對應的物件,通常是表單裡的欄位
// 特別注意:使用擴展方法裡的 type=radio 或 type=checkbox 時,
// 因為設定消息提示層的物件是 obj.parentElement.parentElement,
// 所以傳入的物件也應該是其上兩級的父節點
function hiddenMessageDiv(obj) {
var div = obj.Eos_Message;
if (div != null) {
// 把該物件從消息陣列中移除,避免刪除標籤物件後導致普元 JS 報錯
Eos_All_Message.remove(obj);
// 觸發提示層的點擊事件
div.click();
}
}
這裡的關鍵是 Eos_All_Message.remove(obj) 這一步。若只把提示層藏起來卻沒有從全域驗證佇列中摘除,後續表單提交或欄位被移除時仍可能觸發空參照錯誤,這是 EOS 平台上相當典型的 bug 來源。
使用方式:extAttr="validateAttr=type=radio;"
function f_check_radio(obj) {
// 取得相同 name 的 radio 群組
var radioNames = $names(obj.name);
var len = radioNames.length;
for (var i = 0; i < len; i++) {
if (radioNames[i].checked) {
var div = obj.parentElement.parentElement.Eos_Message;
if (div != null) {
div.hidden(); // 已選取,移除錯誤提示 div
}
return true;
}
}
// 取 parentElement.parentElement 是為了讓提示訊息顯示在尾端
f_alert(obj.parentElement.parentElement, "該項為必選");
return false;
}
使用方式:extAttr="validateAttr=type=checkbox;"
function f_check_checkbox(obj) {
// 取得相同 name 的 checkbox 群組
var checkboxNames = $names(obj.name);
var len = checkboxNames.length;
for (var i = 0; i < len; i++) {
if (checkboxNames[i].checked) {
var div = obj.parentElement.parentElement.Eos_Message;
if (div != null) {
div.hidden(); // 已勾選,移除錯誤提示 div
}
return true;
}
}
f_alert(obj.parentElement.parentElement, "該項為必選");
return false;
}
單選與多選在 EOS 中的 DOM 結構是「容器 > 群組 > 各個 input」,每個 input 本身並不適合承載提示層——若把錯誤訊息掛在單一 input 旁邊,使用者會看到好幾個一樣的提示。把提示掛到群組層級(parentElement.parentElement),訊息只會出現一次且位於整組的尾端,這才是合理的呈現方式。
改寫這類驗證函式時,建議保留「通過時主動清除提示」的邏輯,而不只是「失敗時新增提示」。因為表單驗證通常是多次往返的過程,使用者修正後再次送出,若舊提示沒有被清掉,畫面上就會累積出多餘的錯誤訊息。