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"
}
]
});
ExtJS 內建了幾種常用的格式驗證,用 vtype 指定即可:
items: [
{
fieldLabel: "不能為空",
vtype: "email", // email 格式驗證
vtypeText: "不是有效的郵箱地址", // 錯誤提示資訊
id: "blanktest",
anchor: "90%"
}
]
alpha:只能輸入字母,數字與符號都不接受alphanum:只能輸入字母和數字email:email 格式驗證url:url 格式驗證,如 https://www.example.com內建的驗證不敷使用時,可以用 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,最簡單。vtype。regex。/[一-龥]/ 只要字串中包含一個中文字就會通過,若要求「全部為中文」應寫成 /^[一-龥]+$/。Ext.create('Ext.form.Panel', {...}) 的形式,Ext.form.FormPanel 已不再是主要寫法,vtype 擴充的 API 也有所調整。維護新版本專案時請對照該版本文件。