ExtJS 提供強大的客戶端表單驗證體系,涵蓋空值檢查、內建格式、自定義邏輯、正則表達式等多層次驗證。本文系統梳理常見驗證模式與最佳實踐。
Ext.onReady(function() {
Ext.QuickTips.init(); // 啟用提示功能
Ext.form.Field.prototype.msgTarget = 'side'; // 錯誤提示顯示位置:側邊圖標
// 可選值:'qtip' | 'title' | 'under' | 'side' | 'id'
});
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
items: [{
fieldLabel: '電子郵件',
vtype: 'email', // 內建 email 格式
vtypeText: '不是有效的郵箱地址', // 自定義錯誤訊息
anchor: '90%'
}]
alpha:僅允許字母alphanum:字母+數字email:郵箱格式url:URL 格式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
}]
new Ext.form.TextField({
fieldLabel: '姓名',
name: 'author_name',
regex: /^[\u4e00-\u9fa5]+$/, // 僅允許中文
regexText: '只能輸入中文!',
allowBlank: false
});
注意:正則需用 /.../ 包裹,regexText 定義失敗提示。
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(); }
}]
});
});
Ext.apply(Ext.form.VTypes, ...) 中維護validator: function(v){...}field.setDisabled(true) 或 field.allowBlank = true