DIV CSS 佈局教程網

基於 JS 實作 EOS 表單的錯誤提示層隱藏與單多選驗證
編輯:關於JavaScript     

普元 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),訊息只會出現一次且位於整組的尾端,這才是合理的呈現方式。

改寫這類驗證函式時,建議保留「通過時主動清除提示」的邏輯,而不只是「失敗時新增提示」。因為表單驗證通常是多次往返的過程,使用者修正後再次送出,若舊提示沒有被清掉,畫面上就會累積出多餘的錯誤訊息。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved