Extjs 控件属性(部分)

时间:2023-12-27 14:47:13
  1. Ext.form.TimeField:
  2. 配置项:
  3. maxValue:列表中允许的最大时间
  4. maxText:当时间大于最大值时的错误提示信息
  5. minValue:列表中允许的最小时间
  6. minText:当时间小于最小值时的错误提示信息
  7. increment:两个相邻选项间的时间间隔,默认为15分钟
  8. format:显示格式,默认为“g:i A”。一般使用“H:i:s”
  9. H:带前缀0的24小时
  10. i:带前缀0的分钟
  11. s:带前缀0的秒
  12. invalidText:当时间值非法时显示的提示信息
  13. altFormats:多个时间输入格式组成的字符串,不同的格式之间使用“|”进行分割
  14. Ext.form.FieldSet
  15. animCollapse:动画折叠,默认为false
  16. checkboxToggle:设置是否显示字段集的checkbox选择框,默认为false
  17. checkboxName:指定字段集中用于展开或隐藏字段集面板的checkbox的名字,该属性只有在checkboxToggle为true时生效
  18. labelWidth:字段标签的宽度,可以级联到子容器
  19. layout:布局,默认为form
  20. Ext.form.DateFied
  21. maxValue:允许选择的最大日期
  22. maxText:当日期大于最大值时的错误提示信息
  23. minValue:允许选择的最小时间
  24. minText:当日期小于最小值时的错误提示信息
  25. format:日期显示格式,默认为“m/d/y”,一般使用“Y-m-d”
  26. Y:四位年份
  27. m:带前缀0的月份
  28. d:带前缀0的日期
  29. y:两位年份
  30. n:不带前缀0的月份
  31. j:不带前缀0的日期
  32. w:星期的数字,0表示星期日,1代表星期一
  33. showToday:是否显示今天按钮,默认为true
  34. 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'
  35. disabledDates:禁止选择的日期组成的数组
  36. disabledDatesText:选择禁选日期时显示的提示信息
  37. disabledDays:禁止选择的星期组成的数组,0代表星期日,1代表星期一
  38. disabledDaysText:选择禁选星期时显示的提示信息
  39. invalidText:当日期值非法时显示的提示信息
  40. 方法:
  41. getValue():取得日期值
  42. Ext.form.ComboBox
  43. displayField:被显示在下拉框中的字段名
  44. editable:是否可编辑,默认为true
  45. forceSelection:输入值是否严格为待选列表中存在的值。如果输入不存在的值,会自动选择第一个最接近的值。
  46. hiddenName:隐藏字段的名字,如果提供该参数则一个隐藏字段将被创建,用来存储所选值,当表单提交时在服务器端可以通过该名字取得列表中的所选值
  47. listWidth:下拉列表的宽度
  48. minListWidth:下拉列表的最小宽度,默认为70像素
  49. loadingText:当下拉框加载数据时显示的提示信息,只有当mode='remote'时才会生效
  50. maxHeight:下拉列表框的最大高度,默认为300像素
  51. minChars:下拉列表框自动选择前用户需要输入的最小字符数量。mode='remote'默认为4,mode='local'默认为0
  52. mode:下拉列表框的数据读取模式。remote读取远程数据,local读取本地数据
  53. pageSize:下拉列表框的分页大小。该项设置只在mode='remote'时生效
  54. queryParam:查询的名字,默认为'query',将被传递到查询字符串中
  55. allQuery:一个发往服务器用来查询全部信息的查询字符串,默认为空字符串''
  56. selectOnFocus:当获得焦点时立刻选择一个已存在的列表项。默认为false,此项只有在editable=true时才会生效
  57. store:列表框绑定的数据源
  58. transform:将页面中已存在的元素转换为组合框
  59. lazyInit:延时初始化下拉列表,默认为true
  60. lazyRender:延时渲染,默认为false
  61. triggerAction:设置单击触发按钮时执行的默认操作,有效值包括all和query,默认为query,如果设置为all则会执行allQuery中设置的查询
  62. typeAhead:设置在输入过程中是否自动选择匹配的剩余部分文本(选择第一个满足条件的),默认为false
  63. value:初始化组合框中的值
  64. valueField:组合框的值字段
  65. valueNotFoundText:值不存在时的提示信息
  66. tpl:Ext模板字符串或模板对象,可以通过该配置项自定义下拉列表的显示方式
  67. 方法:
  68. clearValue():清空字段当前值
  69. doQuery( String query, Boolean forceAll ):
  70. getValue():
  71. getStore():
  72. setValue( String value ):
  73. Ext.from.RadioGroup
  74. allowBlank:
  75. blankText:
  76. Ext.form.Radio;
  77. getGroupValue():
  78. setValue( value {String/Boolean} ):
  79. Ext.form.CheckboxGroup
  80. allowBlank:是否允许不选择,默认为true
  81. blankText:
  82. columns:显示的列数,可选值包括:固定值auto、数值、数组(整数、小数)
  83. items:对象数组
  84. vertical:是否垂直方向显示对象,默认为false
  85. Ext.form.Checkbox
  86. boxLabel:复选框的文字描述
  87. checked:复选框是否被选择,默认为false
  88. handler:当checked值改变时触发的函数,函数包含两个参数:checkbox、checked
  89. inputValue:
  90. 方法:
  91. getValue():返回复选框的checked状态
  92. setValue( Boolean/String checked ):
  93. Ext.form.NumberField
  94. allowDecimals:是否允许输入小数,默认为true
  95. allowNegative:是否允许输入负数,默认为true
  96. baseChars:输入的有效数字集合,默认为'0123456789'
  97. decimalPrecision:数字的精度,默认保留小数点后2位
  98. decimalSeparator:十进制分隔符,默认为'.'
  99. maxValue:允许输入的最大数值
  100. maxText:超过最大值之后的提示信息
  101. minValue:允许输入的最小数值
  102. minText:超过最小值之后的提示信息
  103. nanText:输入非有效数值之后的提示信息
  104. Ext.form.TextArea
  105. preventScrollbars:是否禁止出现滚动条,默认为false
  106. Ext.form.TextField
  107. allowBlank:是否允许为空,默认为true
  108. blankText:空验证失败后显示的提示信息
  109. emptyText:在一个空字段中默认显示的信息
  110. grow:字段是否自动伸展和收缩,默认为false
  111. growMin:收缩的最小宽度
  112. growMax:伸展的最大宽度
  113. inputType:字段类型:默认为text
  114. maskRe:用于过滤不匹配字符输入的正则表达式
  115. maxLength:字段允许输入的最大长度
  116. maxLengthText:最大长度验证失败后显示的提示信息
  117. minLength:字段允许输入的最小长度
  118. minLengthText:最小长度验证失败后显示的提示信息
  119. regex:正则表达式
  120. regexText:正则表达式验证失败后显示的提示信息
  121. vtype:验证类型的名字
  122. alpha:限制只能输入字母
  123. alphanum:限制只能输入字母和数字
  124. email
  125. url
  126. vtypeText:验证失败时的提示信息
  127. validator:自定义验证函数
  128. selectOnFocus:当字段得到焦点时自动选择已存在的文本,默认为false
  129. Ext.form.Field
  130. name:字段名
  131. value:字段的初始化值
  132. disabled:字段是否不可用,默认为false
  133. fieldLabel:字段标签说明
  134. hideLabel:隐藏字段标签,默认为false
  135. labelSeparator:字段标签与字段之间的分隔符,默认为':'
  136. labelStyle:字段标签样式
  137. inputType:默认为text
  138. invalidClass:默认为x-form-invalid
  139. invalidText:字段非法文本提示
  140. msgTarget:错误信息显示的位置,默认为qtip
  141. qtip:显示一个浮动的提示信息
  142. title:显示一个浏览器的浮动提示信息
  143. under:在字段下方显示一个提示信息
  144. side:在字段右边显示一个提示信息
  145. readOnly:字段是否只读,默认为false
  146. validateOnBlur:字段在失去焦点时被验证,默认为true
  147. 方法:
  148. clearInvalid():
  149. getRawValue()
  150. setRawValue( Mixed value )
  151. getValue()
  152. setValue( Mixed value )
  153. isDirty():字段值在装载后是否被修改过
  154. isValid( Boolean preventMark ):当前字段值是否合法
  155. markInvalid( [String msg] )
  156. validate()
  157. reset()
  158. Ext.form.FormPanel
  159. items:一个元素或元素数组
  160. buttons:一个按钮配置对象的数组,按钮将被添加到表单页脚中
  161. buttonAlign:按钮的对齐方式,可选值有left、center、right,默认为center
  162. labelWidth:表单标签的宽度
  163. labelAlign:表单标签的对齐方式,可选值有left、top、right,默认为left
  164. labelSeparator:字段标签与字段之间的分隔符,默认为':'
  165. minButtonWidth:按钮的最小宽度,默认为75
  166. 方法:
  167. getForm() : Ext.form.BasicForm
  168. load( Object options )
  169. startMonitoring()
  170. stopMonitoring()
  171. Ext.form.BaseicForm
  172. baseParams:传递到请求中的参数
  173. method:表单的提交方式,有效值包括GET、POST
  174. url:表单默认的提交路径
  175. fileUpload:表单是否进行文件上传
  176. timeout:表单动作的超时时间,默认为30秒
  177. trackResetOnLoad:是否在表单初次创建时清楚数据
  178. 方法:
  179. doAction( String/Object actionName, [Object options] ):执行一个预订的动作,可用选项包括:
  180. url:动作提交的路径
  181. method:表单的提交方式,有效值包括GET、POST
  182. params:传递到请求中的参数
  183. headers:
  184. success:执行成功后回调的函数,包括两个参数:form和action
  185. failure:执行失败后回调的函数,包括两个参数:form和action
  186. clientValidation:是否客户端验证
  187. clearInvalid():清除表单中所有的无效验证信息
  188. findField( String id ):查找表单字段
  189. getValues( [Boolean asString] ):
  190. isDirty():表单数据是否被更改过
  191. isValid():客户端验证是否成功
  192. load( Object options ):执行表单读取动作
  193. loadRecord( Record record ):从一个数据记录中读取数据到表单中
  194. markInvalid( Array/Object errors ):成批设置表单字段为验证无效
  195. reset():重置表单
  196. setValues( Array/Object values ):成批设置表单字段值
  197. submit( Object options ):执行表单提交动作
  198. updateRecord( Record record ):持久化表单数据到记录集中
  199. Ext.form.Action
  200. success:执行成功后回调的函数,包括两个参数:form和action
  201. failure:执行失败后回调的函数,包括两个参数:form和action
  202. method:表单的提交方式,有效值包括GET、POST
  203. params:传递到请求中的参数
  204. url:动作提交的路径
  205. waitMsg:动作执行时显示的等待信息
  206. 属性:
  207. Action.CLIENT_INVALID:客户端验证错误
  208. Action.CONNECT_FAILURE:通信错误
  209. Action.LOAD_FAILURE:加载数据时,没有包含data属性的字段被返回
  210. Action.SERVER_INVALID:服务端验证错误
  211. failureType:错误类型
  212. result:包含布尔类型的success属性和其他属性,如{success: true, msg: 'ok'}
  213. type:动作类型,可选值有submit和load
  214. Ext.form.Action.Submit:返回的信息中要包含一个布尔类型的success属性和一个可选的errors属性
  215. Ext.form.Action.Load:返回的信息中要包含一个布尔类型的success属性和一个data属性
  216. Ext.grid.EditorGridPanel
  217. clicksToEdit:设置点击单元格进入编辑模式的点击次数,默认为2
  218. autoEncode:是否自动编码/解码HTML内容,默认为false
  219. selModel:默认为Ext.grid.CellSelectionModel
  220. 主要方法:
  221. startEditing( Number rowIndex, Number colIndex ):开始编辑指定单元格
  222. stopEditing( [Boolean cancel] ):结束编辑操作
  223. Ext.grid.GroupinView
  224. enableGroupingMenu:是否在表头菜单中进行分组控制,默认为true
  225. groupByText:表头菜单中分组控制的菜单文字,默认为'Group By This Field'
  226. enableNoGroups:是否允许用户关闭分组功能,默认为true
  227. showGroupsText:在表头菜单中启用分组和禁用分组的菜单文字,默认为'Show in Groups'
  228. groupTextTpl:用于渲染分组信息的模板,默认为'{text}',常用的可选值有:
  229. text:列标题:组字段值
  230. gvalue:组字段的值
  231. startRow:组行索引
  232. enableGrouping:是否对数据分组,默认为true
  233. hideGroupedColumn:是否隐藏分组列,默认为false
  234. ignoreAdd:在向表格中添加数据时是否刷新表格,默认为false
  235. showGroupName:是否在分组行上显示分组字段的名字,默认为true
  236. startCollapsed:初次显示时分组是否处于收缩状态,默认为false
  237. 主要方法:
  238. collapseAllGroups():收缩所有分组行
  239. expandAllGroups():展开所有分组行
  240. getGroupId( String value ):根据分组字段值取得组id
  241. toggleAllGroups( [Boolean expanded] ):切换所有分组行的展开或收缩状态
  242. toggleGroup( String groupId, [Boolean expanded] ):切换指定分组行的展开或收缩状态
  243. 2、Ext.data.GroupingStore
  244. groupField:分组字段
  245. groupOnSort:是否在分组字段上排序,默认为false
  246. remoteGroup:是否远程分组数据,默认为false。如果是远程分组数据,则通过groupBy参数发送分组字段名
  247. 3、范例源码
  248. var datas = [[1,"张三",24,"男",new Date(1986,06,09)], [2,"李四",30,"女",new Date(1980,09,13)], [3,"王五",28,"男",new Date(1982,01,10)]];
  249. var person = Ext.data.Record.create([
  250. {name: "personId", mapping: 0},
  251. {name: "personName", mapping: 1},
  252. {name: "personAge", mapping: 2},
  253. {name: "personGender", mapping: 3},
  254. {name: "personBirth", mapping: 4}
  255. ]);
  256. var grid = new Ext.grid.GridPanel({
  257. title: "GroupingView实例",
  258. renderTo: "div1",
  259. width: 500,
  260. height: 300,
  261. frame: true,
  262. tbar: [
  263. {
  264. text: "展开/收缩",
  265. iconCls: "search",
  266. handler: function(){
  267. var view = grid.getView();
  268. //var groupId = view.getGroupId("男");
  269. //view.toggleGroup(groupId);
  270. view.toggleAllGroups();
  271. }
  272. }
  273. ],
  274. store: new Ext.data.GroupingStore({
  275. reader: new Ext.data.ArrayReader({id:0}, person),
  276. data: datas,
  277. sortInfo: {field:"personId", direction:"ASC"}, //数据排序
  278. groupField: "personGender" //分组字段
  279. }),
  280. view: new Ext.grid.GroupingView({
  281. sortAscText: "升序",
  282. sortDescText: "降序",
  283. columnsText: "表格字段",
  284. groupByText: "使用当前字段进行分组",
  285. showGroupsText: "表格分组",
  286. groupTextTpl: "{text}(共{[values.rs.length]}条)"
  287. }),
  288. columns: [
  289. {id:"personId", header:"编号", width:50, dataIndex:"personId"},
  290. {id:"personName", header:"姓名", width:70, dataIndex:"personName"},
  291. {id:"personAge", header:"年龄", width:45, dataIndex:"personAge"},
  292. {id:"personGender", header:"性别", width:45, dataIndex:"personGender"},
  293. {id:"personBirth", header:"出生日期", width:120, dataIndex:"personBirth", renderer:Ext.util.Format.dateRenderer("Y年m月d日")}
  294. ]
  295. });
  296. Ext.grid.GridPanel:
  297. store:表格的数据集
  298. columns:表格列模式的配置数组,可自动创建ColumnModel列模式
  299. autoExpandColumn:自动充满表格未用空间的列,参数为列id,该id不能为0
  300. stripeRows:表格是否隔行换色,默认为false
  301. cm、colModel:表格的列模式,渲染表格时必须设置该配置项
  302. sm、selModel:表格的选择模式,默认为Ext.grid.RowSelectionModel
  303. enableHdMenu:是否显示表头的上下文菜单,默认为true
  304. enableColumnHide:是否允许通过标题中的上下文菜单隐藏列,默认为true
  305. loadMask:是否在加载数据时显示遮罩效果,默认为false
  306. view:表格视图,默认为Ext.grid.GridView
  307. viewConfig:表格视图的配置对象
  308. autoExpandMax:自动扩充列的最大宽度,默认为1000
  309. autoExpandMin:自动扩充列的最小宽度,默认为50
  310. columnLines:是否显示列分割线,默认为false
  311. disableSelection:是否禁止行选择,默认为false
  312. enableColumnMove:是否允许拖放列,默认为true
  313. enableColumnResize:是否允许改变列宽,默认为true
  314. hideHeaders:是否隐藏表头,默认为false
  315. maxHeight:最大高度
  316. minColumnWidth:最小列宽,默认为25
  317. trackMouseOver:是否高亮显示鼠标所在的行,默认为true
  318. 主要方法:
  319. getColumnModel():取得列模式
  320. getSelectionModel():取得选择模式
  321. getStore():取得数据集
  322. getView():取得视图对象
  323. reconfigure( Ext.data.Store store, Ext.grid.ColumnModel colModel ):使用一个新的数据集和列模式重新配置表格组件
  324. 2、Ext.grid.Column
  325. 主要配置项:
  326. id:列id
  327. header:表头文字
  328. dataIndex:设置列与数据集中数据记录的对应关系,值为数据记录中的字段名称。如果没有设置该项则使用列索引与数据记录中字段的索引进行对应
  329. width:列宽
  330. align:列数据的对齐方式
  331. hidden:是否隐藏列,默认为false
  332. fixed:是否固定列宽,默认为false
  333. menuDisabled:是否禁用列的上下文菜单,默认为false
  334. resizable:是否允许改变列宽,默认为true
  335. sortable:是否允许排序,默认为true
  336. renderer:设置列的自定义单元格渲染函数
  337. 传入函数的参数有:
  338. value:数据的原始值
  339. metadata:元数据对象,用于设置单元格的样式和属性,该对象包含的属性有:
  340. css:应用到单元格TD元素上的样式名称
  341. attr:一个HTML属性定义字符串,例如'style="color:blue"'
  342. record:当前数据记录对象
  343. rowIndex:单元格的行索引
  344. colIndex:单元格的列索引
  345. store:数据集对象
  346. xtype:列渲染器类型,默认为gridcolumn,其它可选值有booleancolumn、numbercolumn、datecolumn、templatecolumn等
  347. editable:是否可编辑,默认为true
  348. editor:编辑器
  349. groupName:
  350. emptyGroupText:
  351. groupable:
  352. 3、Ext.grid.ColumnModel
  353. 主要配置项:
  354. columns:字段数组
  355. defaultSortable:是否进行默认排序,默认为false
  356. defaultWidth:默认宽度
  357. 主要方法:
  358. findColumnIndex( String col ):根据给定的dataIndex查找列索引
  359. getColumnById( String id ):取得指定id对应的列
  360. getColumnCount( Boolean visibleOnly ):取得列总数
  361. getColumnHeader( Number col ):取得列的表头
  362. getColumnId( Number index ):取得列id
  363. getDataIndex( Number col ):取得列对应的数据字段名
  364. getIndexById( String id ):取得列索引
  365. getTotalWidth( Boolean includeHidden )
  366. isCellEditable( Number colIndex, Number rowIndex )
  367. isFixed()
  368. isHidden( Number colIndex )
  369. setColumnHeader( Number col, String header )
  370. setColumnWidth( Number col, Number width, Boolean suppressEvent )
  371. setDataIndex( Number col, String dataIndex )
  372. setEditable( Number col, Boolean editable )
  373. setEditor( Number col, Object editor )
  374. setHidden( Number colIndex, Boolean hidden )
  375. setRenderer( Number col, Function fn )
  376. 4、Ext.grid.AbstractSelectionModel
  377. 主要方法:
  378. lock():锁定选择区域
  379. unlock():解锁选择区域
  380. isLocked():当前选择区域是否被锁定
  381. 5、Ext.grid.CellSelectionModel
  382. 主要方法:
  383. clearSelections( Boolean preventNotify ):清除选择区域
  384. getSelectedCell():取得当前选择的单元格,返回一数组,其格式:[rowIndex, colIndex]
  385. hasSelection():当前是否有选择区域
  386. select( Number rowIndex, Number colIndex, [Boolean preventViewNotify], [Boolean preventFocus], [Ext.data.Record r] ):选择指定单元格
  387. 6、Ext.grid.RowSelectionModel
  388. 主要配置项:
  389. singleSelect:是否单选模式,默认为false,即可以选择多条数据
  390. 主要方法:
  391. clearSelections( [Boolean fast] ):清除所有选择区域
  392. deselectRange( Number startRow, Number endRow ):取消范围内的行选择
  393. deselectRow( Number row, [Boolean preventViewNotify] ):取消指定行的选择状态
  394. each( Function fn, [Object scope] ):遍历所有选择行,并调用指定函数。当前被选行将传入该函数中
  395. getCount():得到选择的总行数
  396. getSelected():得到第一个被选记录
  397. getSelections():得到所有被选记录的数组
  398. hasNext():判断当前被选行之后是否还有记录可以选择
  399. hasPrevious():判断当前被选行之前是否还有记录可以选择
  400. hasSelection():是否已选择了数据
  401. isIdSelected( String id ):判断指定id的记录是否被选择
  402. isSelected( Number/Record index ):判断指定记录或记录索引的数据是否被选择
  403. selectAll():选择所有行
  404. selectFirstRow():选择第一行
  405. selectLastRow( [Boolean keepExisting] ):选择最后行
  406. keepExisting:是否保持已有的选择
  407. selectNext( [Boolean keepExisting] ):选择当前选择行的下一行
  408. selectPrevious( [Boolean keepExisting] ):选择当前选择行的上一行
  409. selectRange( Number startRow, Number endRow, [Boolean keepExisting] ):选择范围内的所有行
  410. selectRecords( Array records, [Boolean keepExisting] ):选择一组指定记录
  411. selectRow( Number row, [Boolean keepExisting], [Boolean preventViewNotify] ):选择一行
  412. row:行索引
  413. selectRows( Array rows, [Boolean keepExisting] ):选择多行
  414. rows:行索引数组
  415. 7、Ext.grid.CheckboxSelectionModel
  416. 主要配置项:
  417. singleSelect:是否单选模式,默认为false,即可以选择多条数据
  418. checkOnly:是否只能通过点击checkbox列进行选择,默认为false
  419. sortable:是否允许checkbox列排序,默认为false
  420. width:checkbox列的宽度,默认为20
  421. 8、Ext.grid.RowNumberer
  422. 主要配置项:
  423. header:行号列表头显示的内容
  424. width:列宽,默认为23
  425. 9、Ext.grid.GridView
  426. 主要配置项:
  427. enableRowBody:是否包含行体
  428. sortAscText:表格标题菜单中升序的文字描述
  429. sortDescText:表格标题菜单中降序的文字描述
  430. columnsText:表格标题菜单中列对应的文字描述
  431. autoFill:是否自动扩展列以充满整个表格,默认为false
  432. forceFit:是否强制调整表格列宽以适用表格的整体宽度,防止出现水平滚动条,默认为false
  433. 主要方法:
  434. focusCell( Number row, Number col ):将焦点移到指定单元格
  435. focusRow( Number row ):将焦点移动指定行
  436. getCell( Number row, Number col ):取得指定单元格对应的td元素
  437. getHeaderCell( Number index ):取得指定表头对应的td元素
  438. getRow( Number index ):取得指定行对应的tr元素
  439. getRowClass( Record record, Number index, Object rowParams, Store store ):得到附加到表格行上的样式名
  440. record:当前行的数据记录对象
  441. index:当前行的索引
  442. rowParams:渲染时传入到行模板中的配置对象,通过它可以为行体定制样式,该对象只在enableRowBody为true时才生效,可能的属性如下:
  443. body:渲染到行体中的HTML代码片段
  444. bodyStyle:应用到行体tr元素style属性的字符串
  445. cols:应用到行体td元素colspan属性的值,默认为总列数
  446. store:表格数据集
  447. refresh( [Boolean headersToo] ):刷新表格组件
  448. scrollToTop():滚动表格到顶端
  449. Ext.TabPanel:
  450. activeTab:初始激活的tab,索引或者id值,默认为none
  451. autoTabs:是否自动将带有'x-tab'样式类的div转成tabs添加到TabPanel中,默认为false。
  452. 当该配置项设为true时,需要设置deferredRender为false,还必须使用applyTo。
  453. deferredRender:是否延迟渲染,默认为true。
  454. autoTabSelector:默认为'div.x-tab'。
  455. resizeTabs:是否可以改变tab的尺寸,默认为false。
  456. minTabWidth:tab的最小宽度,默认为30。
  457. tabWidth:每个新增加的tab宽度,默认为120。
  458. tabTip:tab的提示信息
  459. tabPosition:tab位置,可选值有top、bottom,默认为top。
  460. enableTabScroll:是否允许Tab溢出时可以滚动,默认为false。
  461. closable:tab是否可关闭,默认为false
  462. scrollDuration:每次的滚动时长,默认为0.35毫秒。
  463. scrollIncrement:每次的滚动步长,默认为100像素。
  464. wheelIncrement:每次鼠标滑轮的滚动步长,默认为20像素。
  465. 2、主要方法:
  466. activate( String/Panel tab )
  467. getActiveTab():获取当前活动的tab
  468. get( String/Number key ):根据组件id或者索引获取组件
  469. getItem(String id):根据tab id获取tab
  470. setActiveTab( String/Number item )
  471. remove( Component/String component, [Boolean autoDestroy] )
  472. removeAll( [Boolean autoDestroy] )
  473. 3、范例
  474. new Ext.TabPanel({
  475. id: "mainTab",
  476. renderTo: "div1",
  477. width: 500,
  478. height: 300,
  479. activeTab: 0,
  480. defaults: {
  481. autoScroll: true,
  482. autoHeight:true,
  483. style: "padding:5"
  484. },
  485. items:[
  486. {title:"normal", tabTip:"mormal", html:"tab1", iconCls:"add"},
  487. {title:"ajax1", autoLoad:"messagebox.action", iconCls:"delete"},
  488. {title:"ajax2", autoLoad:{url:"test.action", params:"p1=v1", nocache:true}, iconCls:"search"},
  489. {title:"event", iconCls:"save", listeners:{activate:activateHandler}}
  490. ],
  491. enableTabScroll: true
  492. });
  493. function activateHandler(tab){
  494. //alert(tab.title);
  495. }
  496. var index = 0;
  497. function addTab(){
  498. var tabs = Ext.getCmp("mainTab");
  499. var t = tabs.getItem("tab"+index);
  500. if(t) tabs.remove(t);
  501. tabs.add({
  502. id: "tab" + (++index),
  503. title: "NewTab" + index,
  504. html: "new tab" + index,
  505. closable: true
  506. }).show();
  507. }
  508. //按钮渲染到div1元素之前
  509. new Ext.Button({
  510. text:"add tab",
  511. handler:addTab,
  512. iconCls:"add"
  513. }).render(document.body, "div1");
  514. 在使用TabPanel时需要注意:
  515. 1、在创建Ext.TabPanel时deferredRender配置项经常会被忽略。该配置项的默认值是true。true表示只有在用户第一次访问 选项卡时,该选项卡的panel才会被渲染。 所以当我们有可能使用脚本操作选项卡时,谨记将该配置项设置为false。
  516. 2、在FormPanel中使用TabPanel,如果在TabPanel中不定义deferredRender的值为false,那么,当你使用 Load方法为Form加载数据,或使用setValue为没有激活过的Panel的控件赋值时,将会发生错误。原因是,在默认设置下 deferredRender为true,TabPanel并不会渲染所有Panel上的控件,只有在该Panel被激活时才渲染控件,所以当你为这些控 件设置数据时,将会找不到这些控件,会出现错误。因而,在FormPanel中使用TabPanel,一定要在TabPanel中设置 deferredRender的值为false,强制TabPanel在Layout渲染时同时渲染所有Panel上的控件。