ecside帮助文档.docx

1、ecside帮助文档1. 原版ec里不再被支持的属性: 2. imagePath 3. showPagination 4. form 这个肯定有人有意见,但是提供另外的方法间接实现需要的功能. 5. 6. form属性原先的目的是,可以让你把ectable包含在一个已经存在的表单内. 7. 但是现在的思路是需要你把 那个已经存在的表单里的信息加入到ectable的form内. 8. (使用 . ) 9. 这么做可能显得霸道些,但是没有办法,目前很多地方要求必须这么做,因为ecside最终生成的form相对复杂. 10. 不过,我总的建议还是不要把ec:table 和别的过多的与ectable无

2、关的表单混合使用. 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.

3、 描述: 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的形式被保留(传递到

4、新页面). 可选 true/false ( 默认:true ) 28. 关于此项的更多说明可参见原版ec手册 29. 30. 属性: includeParameters 31. 描述: 32. 在关闭自动保留时,希望被自动保留的表单域的标示,支持多个,用,分割 33. 34. 属性: excludeParameters 35. 描述: 36. 在开启自动保留时,希望不被自动保留的表单域的标示,支持多个,用,分割 37. 38. 补充: 39. 如果理解了 autoIncludeParameters 的用处 就不难理解以上两个属性的用处了 40. 注意: excludeParameters 比

5、includeParameters 有更高的优先级 41. 即 excludeParameters=a includeParameters =a 时 a仍然将被排除 42. 建议尽量使用 excludeParameters 不要使用 includeParameters ，除非你非常明确自己要包含的东西。 43. includeParameters 使用不当会使你忘记包含一些必须包含的东西. 44. 45. excludeParameters=表单属性名称1,表单属性名称2 (表单属性名称不能含有半角的逗号) 46. includeParameters=表单属性名称3,表单属性名称4 47. 4

6、8. 属性: 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. pageju

7、mp 页面跳转 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. 属性: r

8、owsDisplayed 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

9、中，某一项大过了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. 描述: 10

10、3. 设置调整列宽时,任意一列所允许的最小宽度 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.

11、设置导出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. 属性: deleteAc

12、tion 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. 设置列表的标

13、题,该标题将显示在列表的上方. 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. 描述:

14、 182. 设置指向数据迭代中的当前记录所对应的bean的变量的名称. 183. 184. 属性: locale 185. 描述: 186. 设置列表的本地化信息. 例如 fr_FR 将使列表使用法文方式显示(前提是已经正确提供相关资源文件). 187. 188. 属性: interceptor 189. 描述: 190. 自定义列表拦截器.值为对应的拦截器的实现. 191. 该拦截器可用来添加或修改列表的属性 192. 属性: retrieveRowsCallback 193. 描述: 194. 指定列表所使用的分页机制.值可以是自定义的完整的callback类名,也可以是在properti

15、es文件内指定的简称 195. 196. 属性: filterRowsCallback 197. 描述: 198. 指定列表所使用的过滤机制.值可以是自定义的完整的callback类名,也可以是在properties文件内指定的简称 199. 200. 属性: sortRowsCallback 201. 描述: 202. 指定列表所使用的排序机制.值可以是自定义的完整的callback类名,也可以是在properties文件内指定的简称 203. 204. 关于以上三个属性的使用请见ECSide列表的RowsCallback机制文档. 205. 206. 属性: width 207. 描述:

16、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. 指定列表的高度.相当于的h

17、eight属性.当值为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

18、. 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事

19、件 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. 标签

20、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. 属性: colu

21、mnId 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 c

22、sv 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. tabl

23、e为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.

24、 描述: 66. 编辑时,所使用的模板名称,详见ECSide可编辑列表的使用指南 67. 68. 属性: editEvent 69. 描述: 70. 进入编辑转台所使用的页面事件,默认为双击,详见ECSide可编辑列表的使用指南 71. 72. 属性: mappingItem 73. 描述: 74. 实现单元格的值,与显示的内容的映射.mappingItem的值为进行映射所使用的map在内存中存放的名称 75. 76. 属性: calc 77. 描述: 78. 指定列所使用的统计方式.值可以是自定义的完整的calc类名,也可以是在properties文件内指定的简称,多个之间用,分割. 79.

25、 自带的统计有两种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.

26、自定义列拦截器.值为对应的拦截器的实现. 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

27、be interpreted. For instance, a date needs to be parsed in the specific format, such as MM-dd-yyyy. 109. 110. 属性: ondblclick 111. 描述: 112. 定义鼠标双击事件.相当于的ondblclick事件 113. 114. 属性: onclick 115. 描述: 116. 定义鼠标的单击事件.相当于的onclick事件 117. 118. 属性: onmouseout 119. 描述: 120. 定义鼠标的onmouseout事件.相当于的onmouseout事件 1

28、21. 122. 属性: onmouseover 123. 描述: 124. 定义鼠标的onmouseover事件.相当于的onmouseover事件 125. 126. 属性: style. 127. 描述: 128. 相当于的style. 129. 130. 属性: styleClass 131. 描述: 132. 相当于的class. 133. 134. 属性: width 135. 描述: 136. 设置列的宽度.相当于的width属性 137. 138. 属性: nowrap 139. 描述: 140. 设置列的宽度.相当于的nowrap属性 141. render_code();=为列表所在表单添加属性.属性将以input type=hidden name= va