ExtJS属性详解:ComboBox与TextField特性

需积分: 9 1 下载量 180 浏览量 更新于2024-09-16 收藏 26KB TXT 举报
"本文将全面介绍ExtJS框架中的属性,主要关注Ext.form.ComboBox和Ext.form.TextField组件的关键属性,包括它们的用途、默认值以及如何使用这些属性来定制用户界面的行为。" 在ExtJS中,控件的属性是定义其行为和外观的关键元素。下面将深入探讨`Ext.form.ComboBox`和`Ext.form.TextField`这两个组件的一些主要属性。 **Ext.form.ComboBox** `Ext.form.ComboBox`是一种常用的下拉选择框,它可以用于显示列表供用户选择。以下是它的一些重要属性: 1. **displayField**:定义了列表项中显示的字段名。 2. **editable**:布尔值,表示用户是否可以手动编辑输入框的内容,默认为`true`。 3. **forceSelection**:布尔值,如果设置为`true`,用户只能从列表中选择,不能输入自定义值。 4. **hiddenName**:隐藏字段的名称,用于提交表单时传递选择的值。 5. **listWidth**:下拉列表的宽度。 6. **minListWidth**:下拉列表的最小宽度,默认为70。 7. **loadingText**:在远程加载数据时显示的提示信息,仅当`mode='remote'`时有效。 8. **maxHeight**:下拉列表的最大高度,默认为300。 9. **minChars**:在进行远程查询前用户需要输入的最少字符数,`mode='remote'`时默认为4,`mode='local'`时默认为0。 10. **mode**:定义数据获取方式,可以是`'local'`或`'remote'`。 11. **pageSize**:分页大小,仅在`mode='remote'`时生效。 12. **queryParam**:发送查询请求时携带的参数名,默认为'query'。 13. **allQuery**:全查询的查询字符串,当触发`allQuery`时执行的查询。 14. **selectOnFocus**:布尔值,表示焦点落在输入框上时是否自动选择一个项,`editable=true`时有效,默认为`false`。 15. **store**:关联的数据存储对象。 16. **transform**:转换一个HTML元素为ComboBox。 17. **lazyInit**:布尔值,决定是否延迟初始化,`true`表示延迟,默认。 18. **lazyRender**:布尔值,控制是否延迟渲染,默认为`false`。 19. **triggerAction**:触发查询操作的类型,如`'query'`或`'all'`,默认为`'query'`。 20. **typeAhead**:布尔值,开启后,用户停止输入时自动填充最匹配的项,`false`为默认。 21. **value**:初始值,即默认选中的值。 22. **valueField**:存储实际值的字段名。 23. **valueNotFoundText**:当找不到与输入匹配的值时显示的文本。 24. **tpl**:模板,用于自定义列表项的展示方式。 25. **clearValue()**:清除当前选中的值。 26. **doQuery(String query, Boolean forceAll)**:执行查询操作。 27. **getValue()**:获取当前选中的值。 28. **getStore()**:获取关联的Store。 29. **setValue(String value)**:设置选中的值。 **Ext.form.TextField** `Ext.form.TextField`是基本的文本输入框,以下是一些重要的属性: 1. **allowBlank**:布尔值,表示是否允许输入框为空,默认为`true`。 2. **blankText**:空字段时的错误提示信息。 3. **emptyText**:输入框的默认提示文字。 4. **grow**:布尔值,表示是否根据输入内容自动调整宽度,默认为`false`。 5. **growMin**:自动增长时的最小宽度。 6. **growMax**:自动增长时的最大宽度。 7. **inputType**:输入框的类型,如`'text'`、`'password'`等。 8. **maskRe**:正则表达式,用于屏蔽输入,如禁止输入某些字符。 9. **maxLength**:最大输入长度。 10. **maxLengthText**:超过最大长度时的错误提示信息。 11. **minLength**:最小输入长度。 12. **minLengthText**:低于最小长度时的错误提示信息。 13. **regex**:正则表达式,用于验证输入。 14. **regexText**:正则验证失败时的错误提示信息。 15. **vtype**:预定义的验证类型,如`'alpha'`、`'alphanum'`、`'email'`、`'url'`等。 16. **vtypeText**:vtype验证失败时的错误提示信息。 17. **validator**:自定义验证函数。 18. **select**:在文本框中选择文本的方法,可以指定起始位置和长度。 了解并熟练运用这些属性,可以有效地创建功能丰富的交互式用户界面,满足不同场景的需求。在实际开发中,可以根据项目需求进一步调整和扩展这些属性。