萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

ExtJS 表單驗證完整指南:從基礎到進階

前言

ExtJS 提供強大的客戶端表單驗證體系,涵蓋空值檢查、內建格式、自定義邏輯、正則表達式等多層次驗證。本文系統梳理常見驗證模式與最佳實踐。

全域配置初始化

Ext.onReady(function() {
    Ext.QuickTips.init(); // 啟用提示功能
    Ext.form.Field.prototype.msgTarget = 'side'; // 錯誤提示顯示位置:側邊圖標
    // 可選值:'qtip' | 'title' | 'under' | 'side' | 'id'
});

1. 空值驗證

var form1 = new Ext.form.FormPanel({
    width: 350,
    renderTo: 'form1',
    title: 'FormPanel',
    defaults: { xtype: 'textfield', inputType: 'password' },
    items: [{
        fieldLabel: '不能為空',
        allowBlank: false,        // 禁止為空
        blankText: '不能為空',    // 自定義錯誤訊息
        id: 'blanktest'
    }]
});

關鍵屬性:allowBlank:false、blankText

2. 內建 VType 格式驗證

items: [{
    fieldLabel: '電子郵件',
    vtype: 'email',                 // 內建 email 格式
    vtypeText: '不是有效的郵箱地址', // 自定義錯誤訊息
    anchor: '90%'
}]

ExtJS 內建 VType 列表

  • alpha:僅允許字母
  • alphanum:字母+數字
  • email:郵箱格式
  • url:URL 格式

3. 進階自定義驗證:密碼確認

步驟一:註冊自定義 VType

Ext.apply(Ext.form.VTypes, {
    password: function(val, field) {
        // val: 當前欄位值,field: 當前欄位組件
        if (field.confirmTo) {
            var pwd = Ext.get(field.confirmTo); // 取得確認密碼欄位
            return (val == pwd.getValue());
        }
        return true;
    },
    passwordText: '兩次密碼不一致!' // 預設錯誤訊息
});

步驟二:表單配置

items: [{
    fieldLabel: '密碼',
    id: 'pass1',
    inputType: 'password'
}, {
    fieldLabel: '確認密碼',
    id: 'pass2',
    inputType: 'password',
    vtype: 'password',          // 使用自定義 VType
    vtypeText: '兩次密碼不一致!',
    confirmTo: 'pass1'          // 指定要比對的欄位 ID
}]

4. 正則表達式驗證

new Ext.form.TextField({
    fieldLabel: '姓名',
    name: 'author_name',
    regex: /^[\u4e00-\u9fa5]+$/,  // 僅允許中文
    regexText: '只能輸入中文!',
    allowBlank: false
});

注意:正則需用 /.../ 包裹,regexText 定義失敗提示。

5. 綜合實戰範例:用戶註冊表單

Ext.onReady(function() {
    Ext.QuickTips.init();
    Ext.form.Field.prototype.msgTarget = 'side';

    // 自定義 VType: 手機號
    Ext.apply(Ext.form.VTypes, {
        mobile: function(v) { return /^1[3-9]\d{9}$/.test(v); },
        mobileText: '請輸入有效的手機號碼',
        mobileMask: /[\d]/ // 輸入掩碼:僅允許數字
    });

    var registerForm = new Ext.form.FormPanel({
        title: '用戶註冊',
        renderTo: 'register-form',
        width: 400,
        frame: true,
        labelWidth: 80,
        defaultType: 'textfield',
        defaults: { anchor: '95%', msgTarget: 'side' },
        items: [{
            fieldLabel: '用戶名',
            name: 'username',
            allowBlank: false,
            minLength: 4,
            maxLength: 16,
            blankText: '用戶名不能為空',
            minLengthText: '用戶名至少4位',
            maxLengthText: '用戶名最多16位'
        }, {
            fieldLabel: '密碼',
            name: 'password',
            inputType: 'password',
            allowBlank: false,
            minLength: 6,
            regex: /^(?=.*[A-Za-z])(?=.*\d)[A-Za-z\d]{6,}$/,
            regexText: '密碼需包含字母和數字,至少6位'
        }, {
            fieldLabel: '確認密碼',
            name: 'repassword',
            inputType: 'password',
            vtype: 'password',
            confirmTo: 'pass1' // 需配合上方 id="pass1"
        }, {
            fieldLabel: '郵箱',
            name: 'email',
            vtype: 'email'
        }, {
            fieldLabel: '手機',
            name: 'mobile',
            vtype: 'mobile'
        }],
        buttons: [{
            text: '註冊',
            handler: function() {
                var form = registerForm.getForm();
                if (form.isValid()) {
                    form.submit({
                        url: '/api/register',
                        waitMsg: '註冊中...',
                        success: function(fp, action) {
                            Ext.Msg.alert('成功', action.result.msg);
                        },
                        failure: function(fp, action) {
                            Ext.Msg.alert('失敗', action.result.msg);
                        }
                    });
                }
            }
        }, {
            text: '重置',
            handler: function() { registerForm.getForm().reset(); }
        }]
    });
});

驗證最佳實踐總結

  1. 客戶端驗證 ≠ 伺服器端驗證:前端僅為用戶體驗,後端必須重複驗證
  2. 善用 msgTarget:'side' 適合表單密集場景,'qtip' 適合寬鬆佈局
  3. 自定義 VType 歸檔管理:集中在 Ext.apply(Ext.form.VTypes, ...) 中維護
  4. 正則效能:避免過度複雜正則,必要時改用函數驗證 validator: function(v){...}
  5. 動態驗證:根據業務狀態啟用/禁用驗證 field.setDisabled(true) 或 field.allowBlank = true
copyright © 萬盛學電腦網 all rights reserved