DIV CSS 佈局教程網

jQuery 表單驗證擴充實作(二):支援 radio 與 checkbox 的必填驗證
編輯:JQuery特效代碼     

一、這次要解決什麼

上一版有兩個明顯的侷限:提示可以用「文字」或「樣式」呈現,但兩者只能擇一使用;必填驗證也只覆蓋了 text 與 textarea 兩種元素。這一版把兩件事一起補完——文字與樣式可以同時套用,驗證對象擴充到 radio 與 checkbox。

二、參數設計

為了讓同一個驗證器能對應不同情境,參數拆得比前版細:

  • required:是否必填,true 會在標籤前顯示 (*)
  • onFocusText / onFocusClass:取得焦點時的提示文字與樣式
  • onErrorText / onErrorClass:驗證失敗的文字與樣式
  • onSuccessText / onSuccessClass:驗證通過的文字與樣式
  • targetId:負責顯示提示的目標元素 id

與前一版相比,最大的結構調整是把「樣式」與「文字」彻底分開,兩者不再綁在同一個參數裡;錯誤提示的參數名稱也一併改了。

三、原始碼解析

$.fn.extend({
  checkRequired: function(inputArg){
    // 非必填項沒有驗證的意義,直接略過
    if (!inputArg.required) return;

    if ($(this).is("input") || $(this).is("textarea")) {
      // 取得焦點
      $(this).bind("focus", function(){
        if ($(this).val() != undefined && $(this).val() != "") {
          addText(inputArg.targetId, inputArg.onSuccessText);
          addClass(inputArg.targetId, inputArg.onSuccessClass);
        } else {
          addText(inputArg.targetId, inputArg.onFocusText);
          addClass(inputArg.targetId, inputArg.onFocusClass);
        }
      });

      // 失去焦點
      $(this).bind("blur", function(){
        if ($(this).attr("type") == "radio" || $(this).attr("type") == "checkbox") {
          var name = $(this).attr("name");
          var items = $('input[name="'+name+'"][checked]');
          addMessage(items.length > 0, inputArg);
        } else {
          addMessage($(this).val() != undefined && $(this).val() != "", inputArg);
        }
      });
    }
  }
});

這裡 if($(this).attr("type")=="radio" || $(this).attr("type")=="checkbox") 是整段程式的樞紐:單選與核取不能用 val() 判斷,必須回頭看同名元素中是否有任何一個處於選取狀態。

四、三個共用方法

每次驗證都離不開「寫入提示文字」與「替換樣式」這兩件事,把它們抽成獨立函式後,主流程清爽很多:

/** 依驗證結果顯示對應的文字與樣式 */
function addMessage(flag, inputArg){
  if (flag) {
    addText(inputArg.targetId, inputArg.onSuccessText);
    addClass(inputArg.targetId, inputArg.onSuccessClass);
  } else {
    addText(inputArg.targetId, inputArg.onErrorText);
    addClass(inputArg.targetId, inputArg.onErrorClass);
  }
}

/** 寫入提示文字,未傳入時清空 */
function addText(targetId, text){
  if (text == undefined) text = "";
  $("#" + targetId).html(" " + text);
}

/** 替換樣式,先清空再掛上新的 */
function addClass(targetId, className){
  if (className != undefined && className != "") {
    $("#" + targetId).removeClass();
    $("#" + targetId).addClass(className);
  }
}

五、使用方式

<script src="jquery-1.3.2.min.js"></script>
<script src="jquery-extend-1.0.0.js"></script>
<script type="text/javascript">
$(document).ready(function(){
  $("#txtName").checkRequired({
    required: true,
    onFocusText: "必填項",
    onFocusClass: "notice",
    onErrorText: "錯誤提示",
    onErrorClass: "error",
    onSuccessClass: "correct",
    targetId: "txtNameTip"
  });

  // radio:同一提示目標共用一個 targetId
  $("#rdbMan").checkRequired({ /* 同上,targetId: "txtSexTip" */ });
  $("#rdbWoman").checkRequired({ /* 同上,targetId: "txtSexTip" */ });

  // checkbox:多個 id 一次掛上
  $("#rdbMan1,#rdbWoman2,#rdbMan3,#rdbWoman4").checkRequired({
    /* 同上,targetId: "txthobbyTip" */
  });
});
</script>
<p>
  <label>姓名:</label>
  <input type="text" id="txtName" value="" />
  <span id="txtNameTip"></span>
</p>
<p>
  <label>性別:</label>
  <span>
    <input id="rdbMan" type="radio" name="sex" value="男" />男
    <input id="rdbWoman" type="radio" name="sex" value="女" />女
  </span>
  <span id="txtSexTip"></span>
</p>
<p>
  <label>愛好:</label>
  <span>
    <input id="rdbMan1" type="checkbox" name="hobby" value="hobby1" />aa
    <input id="rdbWoman2" type="checkbox" name="hobby" value="hobby2" />bb
  </span>
  <span id="txthobbyTip"></span>
</p>

六、效果示意

文字框取得焦點時的提示:

文字框失去焦點後的錯誤提示:

驗證通過時的正確提示:

radio 群組:

checkbox 驗證失敗與成功:

七、還可以往哪走

jQuery 之所以好擴充,就在於 $.fn.extend 這道開口。目前的驗證器只處理「必填」,後續可以沿同一套骨架加上長度、格式(Email、手機)、自訂正則等規則,共用方法那三個小函式完全不必改動。

一個實務提醒:範例中的 $('input[name="x"][checked]') 寫法在 jQuery 1.3 之後已被標記為不建議使用,新專案請改用 $('input[name="x"]:checked');同理,attr("checked") 也建議換成 prop("checked")。

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