1、Ecside 使用文档1.EC Side 介绍：EC Side 是一个开源的列表组件。他源自著名开源列表组件 eXtremeComponents（http:/www.extremecomponents.org ） ，但现在已经脱离eXtremeComponents,独立发展（仍有部分代码来自 eXtremeComponents） 。 “做最实用易用的列表组件”是 ECSide 的目标。2. 工作原理简介：ECSide 是有一个基于 jsp tag 的开源列表组件.简单的说,它就是一组可以帮助你快速实现强大的列表的 jsp 标签.它的工作原理很简单 .您将要展现的列表的数据集合(Collecti
2、on), 放入request/pagecontext/session 内(使用 setAttribute 方法.这个工作可以在 action/servlet 里完成,也可以在 jsp 页面内完成),然后页面跳转到使用 ECSide 标签的 jsp 页面,此时 ECSide 就可以帮助您展现出所需要的列表.一个简单的流程通常是这样的.1 客户端请求 action/servlet(如 http:/10.195.129.101/test/userlist.do)2 action 接受到请求后,调用相应的 BO/dao,执行取列表数据的方法.3 取得数据后(通常是一个 vo/map 的 list),将
3、数据放入 request 内( 使用requset.setAttribute(key,value)方法.)4 将请求 forward 到使用 ECSide 标签的 jsp 页面.5 ECSide 将展现出列表.3.功能特点：1.基于 jsp taglib2.支持文件导出3.支持数据预读取4.工具条可配置5.扩展按钮定制6.多种分页模式3.1 主要特性1 可设置工具条位置（上 下 或 不显示）：ec:table 属性增加 toolbarLocation 用来控制工具条在上还是在下显示， 可选值 “bottom“ “top“ “none“（不显示）2 可设置工具条内容（显示哪些 不显示哪些）：可自
4、定义工具条显示那些内容，以及排列顺序默认： toolbarContent=“navigation|pagejump |pagesize|refresh save add del|export|extend|status“例子 toolbarContent=“pagejump|navigation|export|extend|status“此时 工具条将不显示“页面行数调整 “框 同时顺序也会和默认的发生变化navigation 导航条 pagejump 页面跳转pagesize 页面行数设置export 导出按钮区extend 自定义扩展区status 数据信息区同时 为 ec:table 增
5、加属性 nearPageNum=“数字“, 用来设置导航条前后显示的邻近页数,不设置将使用默认值，设置为 0 则不显示邻近页。3 可设置工具条上各个功能按钮的相对位置4 增加了调整页大小的选择框，并可自定义选择框内的内容5 增加了带有邻近页面的导航条6 增加了可跳转到指定页面的跳转框7 增加了当前选中行高亮8 为 ec:table 增加了 excludeParameters 和 includeParameters 属性，可以实现更快捷简便的“参数保留/不保留”功能9 可添加自定义的 html 代码到工具条内 或其他位置10 可手动调整列宽，可通过 js 调整列表高度11 增加了“列表内部滚动条
6、”(实现列表头固定，列表体滚动的功能)12 为 ec:row 和 ec:column 添加更多的 html 事件支持，现支持：onmouserover onmouserout onclick ondbclick13 为 ec:table ec:row ec:column 增加了自定义扩展属性功能14 增加 ec:extendrow 标签，实现列表扩展行的功能15 增加 shadowRow(影子行) 功能：每行下面可以再加一个子行 这个行里显示什么可以由大家自己定义16 增加页面变量 $TOTALROWCOUNT 用来标示当前纪录在全部记录中的行数17 增加了打印功能（尚不完善）18 ec:co
7、lumn 属性增加 ellipsis ,实现单元格内数据过长的时候 自动截短并加“.“的功能(ie only)19 实现了跨列的列表头20 统计栏的标题格可跨列21 增加了若干种 cell 和 headerCell,例如 checkbox radiobox22 取消了 imagePath 属性,样式相关的图片信息全部提入 css 内23 重（第 4 声）用了 js 和 css ，很多功能用 js 来实现24 支持了 ajax 翻页 (可设置 客户端 还是 服务端进行 html 代码剪裁 )25 支持预查询功能，在察看第 n 页的时候，把 n+1 页的数据也查询出来（隐藏着）备用，加快查看下一页
8、的速度26 将导出 excel 所使用的组件由 poi 切换成了 jxl27 xls 导出方式修改 原始的导出是导出的 vo/map 里的原始数值 现在是导出页面实际显示的内容28 增加简捷导出方式 (通过 ec:table 的 xlsFileName pdfFileName csvFileName 属性)29 支持 pdf 简体中文导出。30 代码进行了大规模的重构31 增加了很多 ajax 相关特性32 实现了可编辑列表功能33 实现了 cell 的映射功能34 easyList、easyDataAccess、easyDataExport 特性：可通过简单的配制，快速实现列表数据的展现、查
9、询、修改、删除、导出。35 支持复杂表头的自定义与导出。36 支持横向统计。37 可以对列表内容进行灵活多样的 escape。4.使用说明：4.1 标签属性说明 4.1.1 属性: tableId描述: 设置列表的唯一标识,默认为“ec“,当一个页面内有多个 ECSIDE 列表时,必须为每个列表指定不同的 tableId.4.1.2 属性: theme描述: 设置列表的风格所使用的主题. 默认为 ecside.4.1.3 属性: generateScript描述: 是否自动生成 ECSide 所需的 js 脚本. 可选 true/false ( 默认:true ) 4.1.4 属性: useA
10、jax描述: 是否使用 ajax 技术进行翻页、过滤、排序等操作. 可选 true/false ( 默认:true ) 4.1.5 属性: doPreload描述: 是否使用预读取技术. 可选 true/false ( 默认:true ) 4.1.6 属性: classic描述: 是否使用传统的简单列表. 可选 true/false ( 默认:false ) 4.1.7 属性: autoIncludeParameters描述: 是否开启“自动保留 “特性.翻页 过滤 排序时当前页的表单域将以 hidden input 的形式被保留(传递到新页面). 可选 true/false ( 默认:tru
11、e ) 关于此项的更多说明可参见原版 ec 手册4.1.8 属性: includeParameters描述: 在关闭“自动保留 “时,希望被自动保留的表单域的标示 ,支持多个 ,用“,“ 分割 4.1.9 属性: excludeParameters描述: 在开启“自动保留 “时,希望不被自动保留的表单域的标示 ,支持多个 ,用“,“ 分割 补充:如果理解了 autoIncludeParameters 的用处 就不难理解以上两个属性的用处了注意: excludeParameters 比 includeParameters 有更高的优先级 即 excludeParameters=“a“ inclu
12、deParameters =“a“ 时 a 仍然将被排除建议尽量使用 excludeParameters 不要使用 includeParameters ，除非你非常明确自己要包含的东西。includeParameters 使用不当会使你忘记包含一些必须包含的东西.excludeParameters=“表单属性名称 1,表单属性名称 2“ (表单属性名称不能含有半角的逗号)includeParameters=“表单属性名称 3,表单属性名称 4“ 4.1.10 属性 : toolbarContent描述: 设置工具条要显示的内容,以及各个元素的前后位置. 默认状态是 toolbarContent
13、=“navigation|pagejump |pagesize|refresh save add del|export|extend|status“例子 toolbarContent=“pagejump|navigation|export|extend|status“此时 工具条将不显示“ 页面行数调整“框和“ 刷新 保存 增删按钮“ 同时顺序也会和默认的发生变化navigation 导航条 pagejump 页面跳转pagesize 页面行数设置refresh 刷新当前页save 保存列表记录add 添加记录del 删除记录export 导出按钮区extend 自定义扩展区status 数据
14、信息区4.1.11 属性 : toolbarLocation描述: 设置工具条要显示的位置(列表的上面还是下面 ). 可选 top/bottom/none, 默认 top. 4.1.12 属性 : paginationLocation描述: 同 toolbarLocation. 4.1.13 属性 : rowsDisplayed描述: 设置每页显示的默认记录条数.4.1.14 属性 : pageSizeList描述: 设置调整“每页记录数 “的下拉框内的候选值 .例如: pageSizeList=“10,20,50,100,1000,2000,all“其中的 all 为增加全部显示功能。例子
15、pageSizeList=“10,20,50“ 此时列表里将只显示 10 20 50 供选择max:数字 特性 :pageSizeList=“max:200,10,15,30,50,100,all“ 如果 10-100 以及 all 中，某一项大过了 max 的 200 则 不在列表中显示。也可以只使用 pageSizeList=“max:200“ 此时将 使用默认设置，并用 max 限制。4.1.15 属性 : nearPageNum描述: 设置“邻近页导航 “的前后区间范围4.1.16 属性 : maxRowsExported描述: 设置导出和打印操作所允许的最大记录条数 4.1.17 属
16、性 : resizeColWidth描述: 是否允许调整列宽. 可选 true/false ( 默认:true ) 4.1.18 属性 : minColWidth描述: 设置调整列宽时,任意一列所允许的最小宽度 4.1.19 属性 : height描述: 设置列表的高度.4.1.20 属性 : minHeight描述: 设置列表的最小高度 4.1.21 属性 : xlsFileName描述: 设置导出 xls 的文件的文件名 . 不指定时为不允许导出 xls 文件 4.1.22 属性 : pdfFileName描述: 设置导出 pdf 的文件的文件名 . 不指定时为不允许导出 pdf 文件 4
17、.1.23 属性 : csvFileName描述: 设置导出 csv 的文件的文件名 . 不指定时为不允许导出 csv 文件 4.1.24 属性 : showPrint描述:是否显示打印按钮. true/false.4.1.25 属性 : action描述: 列表执行翻页 过滤 排序等操作时所要提交的 ACTION 4.1.26 属性 : insertAction描述: 可编辑列表时,插入数据所要提交的 ACTION 4.1.27 属性 : updateAction描述: 可编辑列表时,更新数据所要提交的 ACTION 4.1.28 属性 : deleteAction描述: 可编辑列表时,删除
18、数据所要提交的 ACTION 4.1.29 属性 : shadowRowAction描述: 显示 shadowRow 时所要提交的 ACTION 4.1.30 属性 : editable描述: 是否开启可编辑列表功能.4.1.31 属性 : sortable描述: 是否允许对列表进行按列排序4.1.32 属性 : filterable描述: 是否开启过滤功能.4.1.33 属性 : title描述: 设置列表的标题,该标题将显示在列表的上方.4.1.34 属性 : showTitle描述: 是否显示列表的 title.4.1.35 属性 : style描述: 设置列表的 table 的 sty
19、le,相当于 html 里的 style.4.1.36 属性 : styleClass描述: 设置列表的 table 的 style class,相当于 html 里的 class.4.1.37 属性 : items描述: 设置要展现的数据对应的集合在内存中存放时使用的名字4.1.38 属性 : var描述: 设置指向数据迭代中的当前记录所对应的 bean 的变量的名称 .4.1.39 属性 : locale描述: 设置列表的本地化信息. 例如 fr_FR 将使列表使用法文方式显示(前提是已经正确提供相关资源文件).4.1.40 属性 : interceptor描述: 自定义列表拦截器.值为对应的拦截器的实现.该拦截器可用来添加或修改列表的属性4.1.41 属性 : retrieveRowsCallback描述: 指定列表所使用的分页机制.值可以是自定义的完整的 callback 类名,也可以是在 properties文件内指定的简称4.1.42 属性 : filterRowsCallback描述: 指定列表所使用的过滤机制.值可以是自定义的完整的 callback 类名,也可以是在 properties文件内指定的简称
