ecside使用文档.docx

ecside使用文档.docx

《ecside使用文档.docx》由会员分享，可在线阅读，更多相关《ecside使用文档.docx（18页珍藏版）》请在冰点文库上搜索。

ecside使用文档

js函数说明

tag属性说明

properties文件说明

用例演示

此处暂时只列出部分属性说明,更多的可以参见原版ec的文档（圈子里有下载）

[code]

原版ec里不再被支持的属性:

imagePath  

showPagination  

form这个肯定有人有意见,但是提供另外的方法间接实现需要的功能.  

form属性原先的目的是,可以让你把ectable包含在一个已经存在的表单内.  

但是现在的思路是需要你把那个已经存在的表单里的信息加入到ectable的form内.  

（使用

extendlocation="top/bottom>....

extend>"）  

这么做可能显得霸道些,但是没有办法,目前很多地方要求必须这么做,因为ecside最终生成的form相对复杂.  

不过,我总的建议还是不要把ec:

table和别的过多的与ectable无关的表单混合使用.  

一个页面里完全可以使用多个表单.  

[/code]

table>标签部分属性说明

[code]

◆属性:

tableId

描述:

设置列表的唯一标识,默认为"ec",当一个页面内有多个ECSIDE列表时,必须为每个列表指定不同的tableId.

◆属性:

theme

描述:

设置列表的风格所使用的主题.默认为ecside.

◆属性:

generateScript

描述:

是否自动生成ECSide所需的js脚本.可选true/false（默认:

true）

◆属性:

useAjax

描述:

是否使用ajax技术进行翻页、过滤、排序等操作.可选true/false（默认:

true）

◆属性:

doPreload

描述:

是否使用预读取技术.可选true/false（默认:

true）

◆属性:

classic

描述:

是否使用传统的简单列表.可选true/false（默认:

false）

◆属性:

autoIncludeParameters

描述:

是否开启"自动保留"特性.翻页过滤排序时当前页的表单域将以hiddeninput的形式被保留（传递到新页面）.可选true/false（默认:

true）

关于此项的更多说明可参见原版ec手册

◆属性:

includeParameters

描述:

在关闭"自动保留"时,希望被自动保留的表单域的标示,支持多个,用","分割

◆属性:

excludeParameters

描述:

在开启"自动保留"时,希望不被自动保留的表单域的标示,支持多个,用","分割

补充:

如果理解了autoIncludeParameters的用处就不难理解以上两个属性的用处了

注意:

excludeParameters比includeParameters有更高的优先级

即excludeParameters="a"includeParameters="a"时a仍然将被排除

建议尽量使用excludeParameters不要使用includeParameters，除非你非常明确自己要包含的东西。

includeParameters使用不当会使你忘记包含一些必须包含的东西.

excludeParameters="表单属性名称1,表单属性名称2"   （表单属性名称不能含有半角的逗号）

includeParameters="表单属性名称3,表单属性名称4"

◆属性:

toolbarContent

描述:

设置工具条要显示的内容,以及各个元素的前后位置.

默认状态是toolbarContent="navigation|pagejump|pagesize|refreshsaveadddel|export|extend|status"

例子   toolbarContent="pagejump|navigation|export|extend|status"

此时工具条将不显示"页面行数调整"框和"刷新保存增删按钮"同时顺序也会和默认的发生变化

navigation导航条

pagejump页面跳转

pagesize页面行数设置

refresh刷新当前页

save保存列表记录

add添加记录

del删除记录

export导出按钮区

extend自定义扩展区

status数据信息区

◆属性:

toolbarLocation

描述:

设置工具条要显示的位置（列表的上面还是下面）.可选top/bottom/none,默认top.

◆属性:

paginationLocation

描述:

同toolbarLocation.

◆属性:

rowsDisplayed

描述:

设置每页显示的默认记录条数.

◆属性:

pageSizeList

描述:

设置调整"每页记录数"的下拉框内的候选值.

例如:

pageSizeList="10,20,50,100,1000,2000,all"

其中的all为增加全部显示功能。

例子  pageSizeList="10,20,50"

此时列表里将只显示102050供选择

max:

数字特性:

pageSizeList="max:

200,10,15,30,50,100,all"

如果10--100以及all中，某一项大过了max的200则不在列表中显示。

也可以只使用pageSizeList="max:

200"此时将使用默认设置，并用max限制。

◆属性:

nearPageNum

描述:

设置"邻近页导航"的前后区间范围

◆属性:

maxRowsExported

描述:

设置导出和打印操作所允许的最大记录条数

◆属性:

resizeColWidth

描述:

是否允许调整列宽.可选true/false（默认:

true）

◆属性:

minColWidth

描述:

设置调整列宽时,任意一列所允许的最小宽度

◆属性:

height

描述:

设置列表的高度.

◆属性:

minHeight

描述:

设置列表的最小高度

◆属性:

xlsFileName

描述:

设置导出xls的文件的文件名.不指定时为不允许导出xls文件

◆属性:

pdfFileName

描述:

设置导出pdf的文件的文件名.不指定时为不允许导出pdf文件

◆属性:

csvFileName

描述:

设置导出csv的文件的文件名.不指定时为不允许导出csv文件

◆属性:

showPrint

描述:

是否显示打印按钮.true/false.

◆属性:

action

描述:

列表执行翻页过滤排序等操作时所要提交的ACTION

◆属性:

insertAction

描述:

可编辑列表时,插入数据所要提交的ACTION

◆属性:

updateAction

描述:

可编辑列表时,更新数据所要提交的ACTION

◆属性:

deleteAction

描述:

可编辑列表时,删除数据所要提交的ACTION

◆属性:

shadowRowAction

描述:

显示shadowRow时所要提交的ACTION

◆属性:

editable

描述:

是否开启可编辑列表功能.

◆属性:

sortable

描述:

是否允许对列表进行按列排序

◆属性:

filterable

描述:

是否开启过滤功能.

◆属性:

title

描述:

设置列表的标题,该标题将显示在列表的上方.

◆属性:

showTitle

描述:

是否显示列表的title.

◆属性:

style

描述:

设置列表的table的style,相当于html里的style.

◆属性:

styleClass

描述:

设置列表的table的styleclass,相当于html里的class.

◆属性:

items

描述:

设置要展现的数据对应的集合在内存中存放时使用的名字

◆属性:

var

描述:

设置指向数据迭代中的当前记录所对应的bean的变量的名称.

◆属性:

locale

描述:

设置列表的本地化信息.例如fr_FR将使列表使用法文方式显示（前提是已经正确提供相关资源文件）.

◆属性:

interceptor

描述:

自定义列表拦截器.值为对应的拦截器的实现.

该拦截器可用来添加或修改列表的属性

◆属性:

retrieveRowsCallback

描述:

指定列表所使用的分页机制.值可以是自定义的完整的callback类名,也可以是在properties文件内指定的简称

◆属性:

filterRowsCallback

描述:

指定列表所使用的过滤机制.值可以是自定义的完整的callback类名,也可以是在properties文件内指定的简称

◆属性:

sortRowsCallback

描述:

指定列表所使用的排序机制.值可以是自定义的完整的callback类名,也可以是在properties文件内指定的简称

关于以上三个属性的使用请见"ECSide列表的RowsCallback机制"文档.

◆属性:

width

描述:

指定列表的宽度.相当于

◆属性:

listWidth

描述:

Specifythelocationofpaginationbar.Acceptablevaluesareupordown.

◆属性:

listHeight

描述:

Specifythelocationofpaginationbar.Acceptablevaluesareupordown.

◆属性:

height

描述:

指定列表的高度.相当于

只有在非classic模式下才有效.

◆属性:

excludeTool

描述:

Specifywhetherornottoshowtherowsdisplayedbar.Acceptablevaluesare"true"or"false".

◆属性:

showHeader

描述:

是否显示列表表头.

[/code]

===========================================================

row>标签

[code]

◆属性:

rowId

描述:

列表的行的id,对应

◆属性:

recordKey

描述:

行所对应的记录的唯一主键值,主要用于gird列表的删改

◆属性:

highlightRow

描述:

鼠标经过某行时,该行是否变色.

◆属性:

selectlightRow

描述:

鼠标点击某行时,该行是否变色.

◆属性:

interceptor

描述:

自定义行拦截器.值为对应的拦截器的实现.

该拦截器可用来添加或修改行的属性

◆属性:

ondblclick

描述:

定义鼠标双击事件.相当于

◆属性:

onclick

描述:

定义鼠标的单击事件.相当于

◆属性:

onmouseout

描述:

定义鼠标的onmouseout事件.相当于

◆属性:

onmouseover

描述:

定义鼠标的onmouseover事件.相当于

◆属性:

style

描述:

相当于

◆属性:

styleClass

描述:

相当于

extend>标签

具体的内容可以是任何合法的HTML代码

◆属性:

location

描述:

在什么位置添加扩展内容.

top:

列表上方（在列表外部）

bottom:

列表下方（在列表外部）

留空:

工具条的extend扩展区

extendrow>标签

扩展一行.具体的内容可以是任何合法的

◆属性:

location

描述:

在什么位置添加扩展内容.

bottom:

列表内部的下方,和列表内容主体在一个

留空:

同上

[/code]

===========================================================

column>标签

[code]

◆属性:

columnId

描述:

单元格的id,相当于