ecside帮助文档.doc

1.原版ec里不再被支持的属性: 2.imagePath 3.showPagination 4.form 这个肯定有人有意见,但是提供另外的方法间接实现需要的功能. 5. 6.form属性原先的目的是,可以让你把ectable包含在一个已经存在的表单内. 7.但是现在的思路是需要你把 那个已经存在的表单里的信息加入到ectable的form内. 8.(使用 . ) 9.这么做可能显得霸道些,但是没有办法,目前很多地方要求必须这么做,因为ecside最终生成的form相对复杂. 10.不过,我总的建议还是不要把ec:table 和别的过多的与ectable无关的表单混合使用. 11.一个页面里完全可以使用多个表单. 12.render_code();标签部分属性说明代码1. 属性: tableId 2.描述: 3.设置列表的唯一标识,默认为ec,当一个页面内有多个ECSIDE列表时,必须为每个列表指定不同的tableId. 4. 5. 属性: theme 6.描述: 7.设置列表的风格所使用的主题. 默认为ecside. 8. 9. 属性: generateScript. 10.描述: 11.是否自动生成ECSide所需的js脚本. 可选 true/false ( 默认:true ) 12. 13. 属性: useAjax 14.描述: 15.是否使用ajax技术进行翻页、过滤、排序等操作. 可选 true/false ( 默认:true ) 16. 17. 属性: doPreload 18.描述: 19.是否使用预读取技术. 可选 true/false ( 默认:true ) 20. 21. 属性: classic 22.描述: 23.是否使用传统的简单列表. 可选 true/false ( 默认:false ) 24. 25. 属性: autoIncludeParameters 26.描述: 27.是否开启自动保留特性.翻页 过滤 排序时当前页的表单域将以hidden input的形式被保留(传递到新页面). 可选 true/false ( 默认:true ) 28.关于此项的更多说明可参见原版ec手册 29. 30. 属性: includeParameters 31.描述: 32.在关闭自动保留时,希望被自动保留的表单域的标示,支持多个,用,分割 33. 34. 属性: excludeParameters 35.描述: 36.在开启自动保留时,希望不被自动保留的表单域的标示,支持多个,用,分割 37. 38.补充: 39.如果理解了 autoIncludeParameters 的用处 就不难理解以上两个属性的用处了 40.注意: excludeParameters 比 includeParameters 有更高的优先级 41.即 excludeParameters=a includeParameters =a 时 a仍然将被排除 42.建议尽量使用 excludeParameters 不要使用 includeParameters ，除非你非常明确自己要包含的东西。 43.includeParameters 使用不当会使你忘记包含一些必须包含的东西. 44. 45.excludeParameters=表单属性名称1,表单属性名称2 (表单属性名称不能含有半角的逗号) 46.includeParameters=表单属性名称3,表单属性名称4 47. 48. 属性: toolbarContent 49.描述: 50.设置工具条要显示的内容,以及各个元素的前后位置. 51.默认状态是 toolbarContent=navigation|pagejump |pagesize|refresh save add del|export|extend|status 52.例子 toolbarContent=pagejump|navigation|export|extend|status 53.此时 工具条将不显示页面行数调整框和刷新 保存 增删按钮 同时顺序也会和默认的发生变化 54. 55.navigation 导航条 56.pagejump 页面跳转 57.pagesize 页面行数设置 58.refresh 刷新当前页 59.save 保存列表记录 60.add 添加记录 61.del 删除记录 62.export 导出按钮区 63.extend 自定义扩展区 64.status 数据信息区 65. 属性: toolbarLocation 66.描述: 67.设置工具条要显示的位置(列表的上面还是下面). 可选top/bottom/none, 默认top. 68. 69. 属性: paginationLocation 70.描述: 71.同toolbarLocation. 72. 73. 属性: rowsDisplayed 74.描述: 75.设置每页显示的默认记录条数. 76. 77. 属性: pageSizeList 78.描述: 79.设置调整每页记录数的下拉框内的候选值. 80.例如: pageSizeList=10,20,50,100,1000,2000,all 81.其中的all为增加全部显示功能。 82.例子 pageSizeList=10,20,50 83.此时列表里将只显示 10 20 50供选择 84.max:数字 特性 : 85.pageSizeList=max:200,10,15,30,50,100,all 86.如果 10-100以及all中，某一项大过了max的200则 不在列表中显示。 87.也可以只使用pageSizeList=max:200 此时将 使用默认设置，并用max限制。 88. 89. 属性: nearPageNum 90.描述: 91.设置邻近页导航的前后区间范围 92. 93. 属性: maxRowsExported 94.描述: 95.设置导出和打印操作所允许的最大记录条数 96. 97. 属性: resizeColWidth 98.描述: 99.是否允许调整列宽. 可选 true/false ( 默认:true ) 100. 101. 属性: minColWidth 102.描述: 103.设置调整列宽时,任意一列所允许的最小宽度 104. 105. 属性: height 106.描述: 107.设置列表的高度. 108. 109. 属性: minHeight 110.描述: 111.设置列表的最小高度 112. 113. 属性: xlsFileName 114.描述: 115.设置导出xls的文件的文件名. 不指定时为不允许导出xls文件 116. 117. 属性: pdfFileName 118.描述: 119.设置导出pdf的文件的文件名. 不指定时为不允许导出pdf文件 120. 121. 属性: csvFileName 122.描述: 123.设置导出csv的文件的文件名. 不指定时为不允许导出csv文件 124. 属性: showPrint 125.描述: 126.是否显示打印按钮. true/false. 127. 128. 属性: action 129.描述: 130.列表执行翻页 过滤 排序等操作时所要提交的ACTION 131. 132. 属性: insertAction 133.描述: 134.可编辑列表时,插入数据所要提交的ACTION 135. 136. 属性: updateAction 137.描述: 138.可编辑列表时,更新数据所要提交的ACTION 139. 140. 属性: deleteAction 141.描述: 142.可编辑列表时,删除数据所要提交的ACTION 143. 144. 属性: shadowRowAction 145.描述: 146.显示shadowRow时所要提交的ACTION 147. 148. 属性: editable 149.描述: 150.是否开启可编辑列表功能. 151. 152. 属性: sortable 153.描述: 154.是否允许对列表进行按列排序 155. 156. 属性: filterable 157.描述: 158.是否开启过滤功能. 159. 160. 属性: title 161.描述: 162.设置列表的标题,该标题将显示在列表的上方. 163. 164. 属性: showTitle 165.描述: 166.是否显示列表的title. 167. 168. 属性: style. 169.描述: 170.设置列表的table的style,相当于html里的style. 171. 172. 属性: styleClass 173.描述: 174.设置列表的table的style class,相当于html里的class. 175. 176. 属性: items 177.描述: 178.设置要展现的数据对应的集合在内存中存放时使用的名字 179. 180. 属性: var 181.描述: 182.设置指向数据迭代中的当前记录所对应的bean的变量的名称. 183. 184. 属性: locale 185.描述: 186.设置列表的本地化信息. 例如 fr_FR 将使列表使用法文方式显示(前提是已经正确提供相关资源文件). 187. 188. 属性: interceptor 189.描述: 190.自定义列表拦截器.值为对应的拦截器的实现. 191.该拦截器可用来添加或修改列表的属性 192. 属性: retrieveRowsCallback 193.描述: 194.指定列表所使用的分页机制.值可以是自定义的完整的callback类名,也可以是在properties文件内指定的简称 195. 196. 属性: filterRowsCallback 197.描述: 198.指定列表所使用的过滤机制.值可以是自定义的完整的callback类名,也可以是在properties文件内指定的简称 199. 200. 属性: sortRowsCallback 201.描述: 202.指定列表所使用的排序机制.值可以是自定义的完整的callback类名,也可以是在properties文件内指定的简称 203. 204.关于以上三个属性的使用请见ECSide列表的RowsCallback机制文档. 205. 206. 属性: width 207.描述: 208.指定列表的宽度.相当于的width属性 209. 210. 属性: listWidth 211.描述: 212.Specify the location of pagination bar . Acceptable values are up or down. 213. 214. 属性: listHeight 215.描述: 216.Specify the location of pagination bar . Acceptable values are up or down. 217. 218. 属性: height 219.描述: 220.指定列表的高度.相当于的height属性.当值为auto时,列表高度将随着列表内容自动调整. 221.只有在非classic模式下才有效. 222. 223. 属性: excludeTool 224.描述: 225.Specify whether or not to show the rows displayed bar . Acceptable values are true or false. 226. 227. 属性: showHeader 228.描述: 229.是否显示列表表头. render_code();=标签代码1. 属性: rowId 2.描述: 3.列表的行的id,对应的id属性. 4. 5. 属性: recordKey 6.描述: 7.行所对应的记录的唯一主键值,主要用于gird列表的删改 8. 9. 属性: highlightRow 10.描述: 11.鼠标经过某行时,该行是否变色. 12. 13. 属性: selectlightRow 14.描述: 15.鼠标点击某行时,该行是否变色. 16. 17. 属性: interceptor 18.描述: 19.自定义行拦截器.值为对应的拦截器的实现. 20.该拦截器可用来添加或修改行的属性 21. 22. 属性: ondblclick 23.描述: 24.定义鼠标双击事件.相当于的ondblclick事件 25. 26. 属性: onclick 27.描述: 28.定义鼠标的单击事件.相当于的onclick事件 29. 30. 属性: onmouseout 31.描述: 32.定义鼠标的onmouseout事件.相当于的onmouseout事件 33. 34. 属性: onmouseover 35.描述: 36.定义鼠标的onmouseover事件.相当于的onmouseover事件 37. 38. 属性: style. 39.描述: 40.相当于的style. 41. 42. 属性: styleClass 43.描述: 44.相当于的class. 45. 46.标签 47.具体的内容可以是任何合法的HTML代码 48. 属性: location 49.描述: 50.在什么位置添加扩展内容. 51.top: 列表上方(在列表外部) 52.bottom: 列表下方(在列表外部) 53.留空: 工具条的 extend扩展区 54. 55.标签 56.扩展一行.具体的内容可以是任何合法的相关的HTML代码 57. 58. 属性: location 59.描述: 60.在什么位置添加扩展内容. 61.bottom: 列表内部的下方,和列表内容主体在一个内 62.留空: 同上 63. render_code();=标签代码1. 属性: columnId 2.描述: 3.单元格的id,相当于的id属性 4. 5. 属性: title 6.描述: 7.列在列表表头里显示的名称. 8. 9. 属性: property 10.描述: 11.指定该列所对应的列表bean(map)的属性(key). 12. 13. 属性: alias 14.描述: 15.列的别名. 16. 17. 属性: value 18.描述: 19.列的数值.默认为当前行当前列对应的列表bean(map)的属性的值. 20. 21. 属性: viewsAllowed 22.描述: 23.指定当前列将在那些视图中被显示,可选项为:html xls csv pdf print 24.分别对应于页面展现,导出,打印 25. 26. 属性: viewsDenied 27.描述: 28.指定当前列将在那些视图中被隐藏,可选项为:html xls csv pdf print 29.分别对应于页面展现,导出,打印 30. 31. 属性: tipTitle 32.描述: 33.单元格的提示信息,相当于的title属性 34. 35. 属性: group 36.描述: 37.是否对当前列进行编组. true/false. 38. 39. 属性: resizeColWidth 40.描述: 41.是否允许调整该列的列宽 42.table为classic时无效 43. 44. 属性: minWidth 45.描述: 46.允许调整列宽时,该列所允许的最小宽度,单位像素. 47. 48. 属性: sortable 49.描述: 50.是否允许对该列进行排序. 51. 52. 属性: filterable 53.描述: 54.是否允许对该列进行过滤操作. 55. 56. 属性: editable 57.描述: 58.单元格是否允许编辑. 59. 60. 属性: cellValue 61.描述: 62.单元格对应的值,详见ECSide可编辑列表的使用指南 63. 64. 属性: editTemplate 65.描述: 66.编辑时,所使用的模板名称,详见ECSide可编辑列表的使用指南 67. 68. 属性: editEvent 69.描述: 70.进入编辑转台所使用的页面事件,默认为双击,详见ECSide可编辑列表的使用指南 71. 72. 属性: mappingItem 73.描述: 74.实现单元格的值,与显示的内容的映射.mappingItem的值为进行映射所使用的map在内存中存放的名称 75. 76. 属性: calc 77.描述: 78.指定列所使用的统计方式.值可以是自定义的完整的calc类名,也可以是在properties文件内指定的简称,多个之间用,分割. 79.自带的统计有两种total(求和)与average(求平均值). 80. 81. 属性: calcTitle 82.描述: 83.指定列所使用的统计方式所对应的统计名称,例如合计,平均等等.多个之间用,分割. 84. 85. 属性: calcSpan 86.描述: 87.统计行的统计名称单元格所占用的列数.相当于的colspan属性 88. 89. 属性: cell 90.描述: 91.指定列表内该列所使用的cell的实现类.值可以是自定义的完整的cell类名,也可以是在properties文件内指定的简称 92. 93. 属性: interceptor 94.描述: 95.自定义列拦截器.值为对应的拦截器的实现. 96.该拦截器可用来添加或修改列的属性 97. 98. 属性: escapeAutoFormat 99.描述: 100.是否不进行自动格式的转换. 101. 102. 属性: format 103.描述: 104.The format to use for the cell. For instance if used with a date cell then the format can be MM/dd/yyyy. 105. 106. 属性: parse 107.描述: 108.Used if the format needs to be interpreted. For instance, a date needs to be