DIV CSS 佈局教程網

ExtJS 表單驗證四式:空值、vtype、自訂驗證與正則
編輯:JavaScript綜合知識     

ExtJS 的表單驗證機制相當完整,從最簡單的必填檢查到自訂驗證函式都有現成支援。以下依難易度整理四種常見做法。

前置設定:提示訊息的顯示方式

// 放在 onReady 的 function(){} 中
Ext.QuickTips.init();   // 為元件提供提示訊息功能

// 提示方式,枚舉值如下:
// qtip   - 滑鼠移到元件上時顯示提示
// title  - 在瀏覽器標題顯示
// under  - 在元件下方顯示錯誤提示
// side   - 在元件右邊顯示錯誤圖標,滑鼠指向時顯示提示(預設值)
// id     - 顯示在指定 id 的 HTML 元件中
Ext.form.Field.prototype.msgTarget = 'side';

這個全域設定決定了所有驗證失敗時錯誤訊息的外觀。開發階段用 qtip 比較方便,正式環境 side 或 under 對使用者更友善。

第一式:空值驗證

最基礎的必填檢查,兩個參數即可:

// allowBlank: false  - 不允許為空(預設 true)
// blankText: string   - 為空時的錯誤提示(預設 This field is required!)

var form1 = new Ext.form.FormPanel({
    width: 350,
    renderTo: "form1",
    title: "FormPanel",
    defaults: { xtype: "textfield", inputType: "password" },
    items: [
        {
            fieldLabel: "不能為空",
            allowBlank: false,          // 不允許為空
            blankText: "不能為空",       // 錯誤提示資訊
            id: "blanktest"
        }
    ]
});

第二式:vtype 格式驗證

ExtJS 內建了幾種常用的格式驗證,用 vtype 指定即可:

items: [
    {
        fieldLabel: "不能為空",
        vtype: "email",                 // email 格式驗證
        vtypeText: "不是有效的郵箱地址",   // 錯誤提示資訊
        id: "blanktest",
        anchor: "90%"
    }
]

內建 vtype 類型

  • alpha:只能輸入字母,數字與符號都不接受
  • alphanum:只能輸入字母和數字
  • email:email 格式驗證
  • url:url 格式驗證,如 https://www.example.com

第三式:自訂 vtype 驗證(以密碼確認為例)

內建的驗證不敷使用時,可以用 Ext.apply 擴充 VTypes:

// 添加自訂的 password 驗證函式
Ext.apply(Ext.form.VTypes, {

    password: function(val, field) {
        // val 是這個文字框的值,field 是這個文字框元件
        if (field.confirmTo) {
            // confirmTo 是我們自訂的設定參數,用來保存另一個元件的 id
            var pwd = Ext.get(field.confirmTo);
            return (val == pwd.getValue());
        }
        return true;
    },

    passwordText: '兩次密碼不一致!'    // 對應的提示文字
});

// 設定 items
items: [
    { fieldLabel: "密碼", id: "pass1" },
    {
        fieldLabel: "確認密碼",
        id: "pass2",
        vtype: "password",           // 使用自訂的驗證類型
        vtypeText: "兩次密碼不一致!",
        confirmTo: "pass1"           // 要比較的另一個元件的 id
    }
]

這個設計的巧妙之處在於用一個自訂參數 confirmTo 把兩個欄位關聯起來,讓同一個 vtype 可以套用到任何需要確認的欄位上。

第四式:正則表達式驗證

最靈活的方式,任何能用正則描述的規則都能處理:

new Ext.form.TextField({
    fieldLabel: "姓名",
    name: "author_nam",
    regex: /[一-龥]/,          // 正則表示式寫在 /...../ 之間
                                // [一-龥] 表示只能輸入中文
    regexText: "只能輸入中文!",   // 正則驗證錯誤提示
    allowBlank: false           // 此驗證依然有效,不許為空
})

原文中使用的 /[u4e00-u9fa5]/ 是 Unicode 跳脫寫法,涵蓋 CJK 基本漢字區,效果等同於 /[\u4e00-\u9fa5]/(注意原文少了反斜線,這樣寫會變成比對英文字母)。

四種方式的選擇建議

  • 只是必填檢查 → 用 allowBlank,最簡單。
  • 常見格式(email、url、純字母數字)→ 用內建 vtype。
  • 欄位間有邏輯關聯(密碼確認、日期區間)→ 自訂 vtype。
  • 特殊格式規則(身分證、手機、特定編碼)→ 用 regex。

幾點實務提醒

  • 前端驗證只是使用者體驗,不是安全防線。所有規則在伺服器端必須重新驗證一次,因為前端可以被任意繞過或竄改。
  • 正則的錨點要明確。像 /[一-龥]/ 只要字串中包含一個中文字就會通過,若要求「全部為中文」應寫成 /^[一-龥]+$/。
  • 密碼強度不建議用簡單正則檢查。密碼確認欄位的一致性驗證沒問題,但強度要求(大小寫、數字、長度)用自訂 vtype 表達會更清楚,且提示訊息更具體。
  • 這份程式碼基於 ExtJS 3.x 語法。ExtJS 4 之後改為 Ext.create('Ext.form.Panel', {...}) 的形式,Ext.form.FormPanel 已不再是主要寫法,vtype 擴充的 API 也有所調整。維護新版本專案時請對照該版本文件。
XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved