Extjs校驗配置項
Extjsform組件
1、Ext.form.Action
配置項:
success:執行成功後回調的函數,包括兩個參數:form和action
failure:執行失敗後回調的函數,包括兩個參數:form和action
method:表單的提交方式,有效值包括GET、POST
params:傳遞到請求中的參數
url:動作提交的路徑
waitMsg:動作執行時顯示的等待信息
屬性:
Action.CLIENT_INVALID:客戶端驗證錯誤
Action.CONNECT_FAILURE:通信錯誤
Action.LOAD_FAILURE:加載數據時,沒有包含data屬性的字段被返回
Action.SERVER_INVALID:服務端驗證錯誤
failureType:錯誤類型
result:包含布爾類型的success屬性和其他屬性,如{success:true,msg:‘ok‘}
type:動作類型,可選值有submit和load
Ext.form.Action.Submit:返回的信息中要包含一個布爾類型的success屬性和一個可選的errors屬性
Ext.form.Action.Load:返回的信息中要包含一個布爾類型的success屬性和一個data屬性
2、Ext.form.BasicForm
配置項:
baseParams:傳遞到請求中的參數
method:表單的提交方式,有效值包括GET、POST
url:表單默認的提交路徑
fileUpload:表單是否進行文件上傳
timeout:表單動作的超時時間,默認為30秒
trackResetOnLoad:是否在表單初次創建時清楚數據
方法:
doAction(String/ObjectactionName,[Objectoptions]):執行一個預訂的動作,可用選項包括:
url:動作提交的路徑
method:表單的提交方式,有效值包括GET、POST
params:傳遞到請求中的參數
headers:
success:執行成功後回調的函數,包括兩個參數:form和action
failure:執行失敗後回調的函數,包括兩個參數:form和action
clientValidation:是否客戶端驗證
clearInvalid():清除表單中所有的無效驗證信息
findField(Stringid):查找表單字段
getValues([BooleanasString]):
isDirty():表單數據是否被更改過
isValid():客戶端驗證是否成功
load(Objectoptions):執行表單讀取動作
loadRecord(Recordrecord):從一個數據記錄中讀取數據到表單中
markInvalid(Array/Objecterrors):成批設置表單字段為驗證無效
reset():重置表單
setValues(Array/Objectvalues):成批設置表單字段值
submit(Objectoptions):執行表單提交動作
updateRecord(Recordrecord):持久化表單數據到記錄集中
3、Ext.form.FormPanel
配置項:
items:一個元素或元素數組
buttons:一個按鈕配置對象的數組,按鈕將被添加到表單頁腳中
buttonAlign:按鈕的對齊方式,可選值有left、center、right,默認為center
labelWidth:表單標簽的寬度
labelAlign:表單標簽的對齊方式,可選值有left、top、right,默認為left
labelSeparator:字段標簽與字段之間的分隔符,默認為‘:‘
minButtonWidth:按鈕的最小寬度,默認為75
方法:
getForm():Ext.form.BasicForm
load(Objectoptions)
startMonitoring()
stopMonitoring()
4、Ext.form.Field
配置項:
name:字段名
value:字段的初始化值
disabled:字段是否不可用,默認為false
fieldLabel:字段標簽說明
hideLabel:隱藏字段標簽,默認為false
labelSeparator:字段標簽與字段之間的分隔符,默認為‘:‘
labelStyle:字段標簽樣式
inputType:默認為text
invalidClass:默認為x-form-invalid
invalidText:字段非法文本提示
msgTarget:錯誤信息顯示的位置,默認為qtip
qtip:顯示一個浮動的提示信息
title:顯示一個瀏覽器的浮動提示信息
under:在字段下方顯示一個提示信息
side:在字段右邊顯示一個提示信息
readOnly:字段是否只讀,默認為false
validateOnBlur:字段在失去焦點時被驗證,默認為true
方法:
clearInvalid():
getRawValue()
setRawValue(Mixedvalue)
getValue()
setValue(Mixedvalue)
isDirty():字段值在裝載後是否被修改過
isValid(BooleanpreventMark):當前字段值是否合法
markInvalid([Stringmsg])
validate()
reset()
5、Ext.form.Hidden
6、Ext.form.Label
配置項:
html:
text:
7、Ext.form.TextField
配置項:
allowBlank:是否允許為空,默認為true
blankText:空驗證失敗後顯示的提示信息
emptyText:在一個空字段中默認顯示的信息
grow:字段是否自動伸展和收縮,默認為false
growMin:收縮的最小寬度
growMax:伸展的最大寬度
inputType:字段類型:默認為text
maskRe:用於過濾不匹配字符輸入的正則表達式
maxLength:字段允許輸入的最大長度
maxLengthText:最大長度驗證失敗後顯示的提示信息
minLength:字段允許輸入的最小長度
minLengthText:最小長度驗證失敗後顯示的提示信息
regex:正則表達式
regexText:正則表達式驗證失敗後顯示的提示信息
vtype:驗證類型的名字
alpha:限制只能輸入字母
alphanum:限制只能輸入字母和數字
email:校驗郵箱格式
url:校驗url格式
vtypeText:驗證失敗時的提示信息
validator:自定義驗證函數
selectOnFocus:當字段得到焦點時自動選擇已存在的文本,默認為false
8、Ext.form.TextArea
配置項:
preventScrollbars:是否禁止出現滾動條,默認為false
9、Ext.form.NumberField
配置項:
allowDecimals:是否允許輸入小數,默認為true
allowNegative:是否允許輸入負數,默認為true
baseChars:輸入的有效數字集合,默認為‘0123456789‘
decimalPrecision:數字的精度,默認保留小數點後2位
decimalSeparator:十進制分隔符,默認為‘.‘
maxValue:允許輸入的最大數值
maxText:超過最大值之後的提示信息
minValue:允許輸入的最小數值
minText:超過最小值之後的提示信息
nanText:輸入非有效數值之後的提示信息
10、Ext.form.Checkbox
配置項:
boxLabel:復選框的文字描述
checked:復選框是否被選擇,默認為false
handler:當checked值改變時觸發的函數,函數包含兩個參數:checkbox、checked
inputValue:
方法:
getValue():返回復選框的checked狀態
setValue(Boolean/Stringchecked):
11、Ext.form.CheckboxGroup
配置項:
allowBlank:是否允許不選擇,默認為true
blankText:
columns:顯示的列數,可選值包括:固定值auto、數值、數組(整數、小數)
items:對象數組
vertical:是否垂直方向顯示對象,默認為false
12、Ext.form.Radio
方法:
getGroupValue():
setValue(value{String/Boolean}):
13、Ext.form.RadioGroup
配置項:
allowBlank:
blankText:
14、Ext.form.ComboBox
配置項:
displayField:被顯示在下拉框中的字段名
editable:是否可編輯,默認為true
forceSelection:輸入值是否嚴格為待選列表中存在的值。如果輸入不存在的值,會自動選擇第一個最接近的值。
hiddenName:隱藏字段的名字,如果提供該參數則一個隱藏字段將被創建,用來存儲所選值,當表單提交時在服務器端可以通過該名字取得列表中的所選值
listWidth:下拉列表的寬度
minListWidth:下拉列表的最小寬度,默認為70像素
loadingText:當下拉框加載數據時顯示的提示信息,只有當mode=‘remote‘時才會生效
maxHeight:下拉列表框的最大高度,默認為300像素
minChars:下拉列表框自動選擇前用戶需要輸入的最小字符數量。mode=‘remote‘默認為4,mode=‘local‘默認為0
mode:下拉列表框的數據讀取模式。remote讀取遠程數據,local讀取本地數據
pageSize:下拉列表框的分頁大小。該項設置只在mode=‘remote‘時生效
queryParam:查詢的名字,默認為‘query‘,將被傳遞到查詢字符串中
allQuery:一個發往服務器用來查詢全部信息的查詢字符串,默認為空字符串‘‘
selectOnFocus:當獲得焦點時立刻選擇一個已存在的列表項。默認為false,此項只有在editable=true時才會生效
store:列表框綁定的數據源
transform:將頁面中已存在的元素轉換為組合框
lazyInit:延時初始化下拉列表,默認為true
lazyRender:延時渲染,默認為false
triggerAction:設置單擊觸發按鈕時執行的默認操作,有效值包括all和query,默認為query,如果設置為all則會執行allQuery中設置的查詢
typeAhead:設置在輸入過程中是否自動選擇匹配的剩余部分文本(選擇第一個滿足條件的),默認為false
value:初始化組合框中的值
valueField:組合框的值字段
valueNotFoundText:值不存在時的提示信息
tpl:Ext模板字符串或模板對象,可以通過該配置項自定義下拉列表的顯示方式
方法:
clearValue():清空字段當前值
doQuery(Stringquery,BooleanforceAll):
getValue():
getStore():
setValue(Stringvalue):
15、Ext.form.DateField
配置項:
maxValue:允許選擇的最大日期
maxText:當日期大於最大值時的錯誤提示信息
minValue:允許選擇的最小時間
minText:當日期小於最小值時的錯誤提示信息
format:日期顯示格式,默認為“m/d/y”,一般使用“Y-m-d”
Y:四位年份
m:帶前綴0的月份
d:帶前綴0的日期
y:兩位年份
n:不帶前綴0的月份
j:不帶前綴0的日期
w:星期的數字,0表示星期日,1代表星期一
showToday:是否顯示今天按鈕,默認為true
altFormats:多個日期輸入格式組成的字符串,不同的格式之間使用“|”進行分割,默認值為‘m/d/Y|n/j/Y|n/j/y|m/j/y|n/d/y|m/j/Y|n/d/Y|m-d-y|m-d-Y|m/d|m-d|md|mdy|mdY|d|Y-m-d‘
disabledDates:禁止選擇的日期組成的數組
disabledDatesText:選擇禁選日期時顯示的提示信息
disabledDays:禁止選擇的星期組成的數組,0代表星期日,1代表星期一
disabledDaysText:選擇禁選星期時顯示的提示信息
invalidText:當日期值非法時顯示的提示信息
方法:
getValue():取得日期值
16、Ext.form.FieldSet
配置項:
animCollapse:動畫折疊,默認為false
checkboxToggle:設置是否顯示字段集的checkbox選擇框,默認為false
checkboxName:指定字段集中用於展開或隱藏字段集面板的checkbox的名字,該屬性只有在checkboxToggle為true時生效
labelWidth:字段標簽的寬度,可以級聯到子容器
layout:布局,默認為form
17、Ext.form.TimeField
配置項:
maxValue:列表中允許的最大時間
maxText:當時間大於最大值時的錯誤提示信息
minValue:列表中允許的最小時間
minText:當時間小於最小值時的錯誤提示信息
increment:兩個相鄰選項間的時間間隔,默認為15分鐘
format:顯示格式,默認為“g:iA”。一般使用“H:i:s”
H:帶前綴0的24小時
i:帶前綴0的分鐘
s:帶前綴0的秒
invalidText:當時間值非法時顯示的提示信息
altFormats:多個時間輸入格式組成的字符串,不同的格式之間使用“|”進行分割
Extjs校驗配置項