萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 電腦基礎知識 >  >> 電腦基本常識

Ext JS TextField 完整屬性配置速查表

Ext.form.TextField 是 Ext JS 表單中最基礎的輸入元件,支援驗證、遮罩、提示等豐富功能。以下整理最常用屬性與最小可用範例,方便開發快速查閱。

最小可用範例

Ext.onReady(function() {
    Ext.QuickTips.init(); // 啟用提示功能

    var textfieldName = new Ext.form.TextField({
        renderTo: 'Bind_TextField', // 渲染目標容器 ID
        fieldLabel: '使用者名稱',
        name: 'username',
        allowBlank: false,          // 必填
        blankText: '請輸入使用者名稱',
        maxLength: 20,
        maxLengthText: '長度不可超過 20 字元',
        regex: /^[a-zA-Z0-9_]+$/,   // 僅允許英數字底線
        regexText: '僅限英數字與底線',
        width: 300
    });
});

核心屬性分類速查

1. 基本顯示與行為

屬性型別預設說明
idString自動產生元件唯一識別碼,建議自行指定便於 Ext.getCmp() 取得。
fieldLabelString''標籤文字,配合 FormLayout 顯示。
hideLabelBooleanfalsetrue 時隱藏標籤但保留間距。
hiddenBooleanfalsetrue 時完全隱藏元件。
disabledBooleanfalsetrue 時禁用輸入,表單提交時不包含此欄位。
readOnlyBooleanfalsetrue 時唯讀,但表單提交仍包含值。
inputTypeString'text''text'|'password'|'file'|'hidden' 等原生 type。
width/heightNumber/String'auto'寬高,數值為像素,'auto' 自適應。

2. 空值與提示

屬性型別預設說明
allowBlankBooleantruefalse 表示必填,配合 blankText。
blankTextString'This field is required'空值錯誤提示。
emptyTextStringnull輸入框為空時顯示的灰色提示文字(HTML5 placeholder 效果)。
validateOnBlurBooleantrue失去焦點時驗證。
validationDelayNumber250驗證延遲毫秒數(配合 keyup 事件)。
validationEventString/Boolean'keyup'觸發驗證事件:'keyup'、'blur'、false 關閉即時驗證。

3. 長度與格式驗證

屬性型別說明
minLengthNumber最小長度,配合 minLengthText。
maxLengthNumber最大長度,配合 maxLengthText;注意:原文重複定義 maxLengthText,應分別對應 min/max。
regexRegExp正則驗證,不符合時顯示 regexText。
regexTextString正則失敗提示。
maskReRegExp輸入遮罩,僅允許符合字元輸入(如 /[0-9]/ 僅限數字)。
stripCharsReRegExp自動移除不符合字元(如 /[^0-9]/g 只保留數字)。

4. 進階自訂驗證

屬性型別說明
validatorFunction自訂驗證函式,回傳 true 通過,回傳字串視為錯誤訊息。範例:
validator: function(v) { return v.length >= 6 ? true : '至少 6 字元'; }
vtypeString內建驗證類型:'email'、'url'、'alpha'、'alphanum' 等;可自訂 Ext.apply(Ext.form.field.VTypes, {...})。

5. 狀態與渲染

屬性型別說明
valueMixed初始值。
hideModeString'display'|'offsets'|'visibility' 隱藏模式。
renderToString/HTMLElement指定渲染容器,或加入 Container/FormPanel 的 items 陣列。

常見坑點提醒

  • 必須呼叫 Ext.QuickTips.init(),否則 blankText、regexText 等提示不會顯示。
  • maxLength 僅做前端驗證,資料庫仍需設定欄位長度約束。
  • regex 使用正則字面量 /pattern/,勿用字串 '/pattern/'。
  • 表單提交時,disabled:true 的欄位不會送出,readOnly:true 會送出。

延伸閱讀: Ext JS 6+ 現代工具包建議改用 Ext.field.Text(Modern toolkit),API 相似但支援觸控優化與雙向綁定(ViewModel)。

copyright © 萬盛學電腦網 all rights reserved