DIV CSS 佈局教程網

打造萬能表單驗證:用 class 驅動的前端檢查機制
編輯:關於JavaScript     

表單驗證幾乎每個專案都要寫一次,而每寫一次就重複一次。與其到處複製貼上,不如把規則抽成一套「用 class 宣告、由程式統一讀取」的通用機制。以下這份封裝示範了如何用 jQuery 做到這件事。

設計思路

核心精神是:驗證規則寫在 HTML 上,邏輯寫在 JavaScript 裡。當同一頁有多個 form 需要送出時,程式能準確判斷「目前這個按鈕」該檢查哪些欄位,不會互相干擾。

約定好的 class 與屬性

  • 表單容器:class="form"
  • 送出按鈕:class="check"
  • 刪除確認按鈕:class="confirm",並用 title 放提示文字
  • 必填欄位:class="notnull",搭配 nullmsg="xx不能為空!"
  • 需要格式檢查的欄位:class="need",搭配型別 class(如 num)與 logicmsg 提示
  • 錯誤訊息容器:class="errorMessage";訊息文字:class="warn"
  • 下拉必選:class="select";核取方塊必選:class="checkbox"

若不想走型別對應,也可以直接在欄位上自訂屬性 regex="/^\d+$/",交給程式用正則表達式判斷。

對外開放的回呼

驗證通過後要做什麼,交給外部決定:Global.submitCallback 負責送出後的回呼,Global.confirmCallback 負責刪除確認後的回呼。

主體程式碼

function Global() {
    var _self = this;
}
Global.submitCallback = null;
Global.confirmCallback = null;

$(document).ready(function () {
    // 為每一個表單容器掛上點擊攔截
    $("body").find(".form").each(function () {
        this.onclick = function (e) {
            var button = null;
            try {
                button = e.srcElement == null ? document.activeElement : e.srcElement;
            } catch (ex) {
                console.log(ex.message);
                button = document.activeElement;
            }

            if ($(button).is(".check")) {           // 送出
                var sub = (checkform(this) && CheckInputRex(this)
                        && checkselect(this) && checkChecked(this));
                if (sub) {
                    Global.submitCallback.call(this, [e]);
                }
                return sub;
            } else if ($(button).is(".confirm")) {  // 刪除確認
                var sub = confirm($(button).attr("title"));
                if (sub) {
                    Global.confirmCallback.call(this, [e]);
                }
                return sub;
            } else {
                return true;
            }
        }
    });

    /* 檢查必填欄位 */
    function checkform(form) {
        var b = true;
        $(form).find(".notnull").each(function () {
            if ($.trim($(this).val()).length <= 0) {
                $(this).parents(".form").find(".warn").text($(this).attr("nullmsg"));
                $(this).parents(".form").find(".errorMessage").show();
                $(this).select();
                $(this).focus();
                return b = false;
            }
        });
        if (b == true) {
            $(form).find(".warn").text("");
            $(form).find(".errorMessage").hide();
        }
        return b;
    }

    /* 檢查必選的下拉選單 */
    function checkselect(form) {
        var b = true;
        $(form).find(".select").each(function (i) {
            var ck = $(this).find('option:selected').text();
            if (ck.indexOf("選擇") > -1) {
                $(this).parents(".form").find(".warn").text($(this).attr("nullmsg"));
                $(this).parents(".form").find(".errorMessage").show();
                $(this).focus();
                return b = false;
            }
        });
        return b;
    }

    /* 檢查必選的核取方塊 */
    function checkChecked(form) {
        var b = true;
        $(form).find(".checkbox").each(function (i) {
            if (!$(this)[0].checked) {
                $(this).parents(".form").find(".warn").text($(this).attr("nullmsg"));
                $(this).parents(".form").find(".errorMessage").show();
                $(this).focus();
                return b = false;
            }
        });
        return b;
    }

    /* 正則比對,失敗時顯示提示 */
    function GetFlase(value, reg, ele) {
        if (reg.test(value)) {
            return true;
        }
        $(ele).parents(".form").find(".warn").text($(ele).attr("logicmsg"));
        $(ele).parents(".form").find(".errorMessage").show();
        $(ele).focus();
        $(ele).select();
        return false;
    }

    /* 依欄位自訂的 regex 屬性做格式檢查 */
    function CheckInputRex(form) {
        var b = true;
        $(form).find("input[type='text']").each(function () {
            if (typeof ($(this).attr("regex")) == 'string') {
                if ($.trim($(this).val()).length > 0 && $(this).val() != this.defaultValue) {
                    var value = $(this).attr("value") || $(this).val();
                    var regx = eval($(this).attr("regex"));
                    return b = GetFlase(value, regx, this);
                }
            }
        });
        return b;
    }
});

原始版本還附帶一個以 switch 對應型別的 CheckInput(),內含手機號、信箱、身份證字、郵遞區號、護照號碼、銀行帳號等大量正則規則,但作者已標註為廢棄方法,改用上面的 regex 屬性寫法即可彈性覆蓋所有情境。

HTML 使用範例

<form class="form">
    <input type="text" class="notnull" nullmsg="姓名不能為空!" />
    <input type="text" class="num" logicmsg="年齡只能是數字" regex="/^\d+$/" />
    <select class="select" nullmsg="請選擇地區">
        <option>--請選擇--</option>
        <option>台北</option>
    </select>
    <div class="errorMessage" style="display:none">
        <span class="warn"></span>
    </div>
    <input type="button" class="check" value="送出" />
</form>

這套設計的優點

  • 新增欄位時只需加上 class 與提示屬性,不必改動 JavaScript。
  • 同一頁多個表單互不干擾,因為所有查詢都以當前 .form 容器為範圍。
  • 驗證通過後的行為透過回呼函式交給呼叫端決定,與後端請求或路由邏輯完全解耦。

這樣封裝之後,表單驗證就從「每次重寫」變成「掛上 class 即可」。

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