ECSide标签属性说明之<ec:table>

<ec:table>标签说明


◆ 属性: 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
描述:
是否开启"自动保留"特性.翻页 过滤 排序时当前页的表单域将以hidden input的形式被保留(传递到新页面). 可选 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|refresh save add del|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"
此时列表里将只显示 10 20 50供选择
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的style class,相当于html里的class.

◆ 属性: items
描述:
设置要展现的数据对应的集合在内存中存放时使用的名字

◆ 属性: var
描述:
设置指向数据迭代中的当前记录所对应的bean的变量的名称.

◆ 属性: locale
描述:
设置列表的本地化信息. 例如 fr_FR 将使列表使用法文方式显示(前提是已经正确提供相关资源文件).

◆ 属性: interceptor
描述:
自定义列表拦截器.值为对应的拦截器的实现.
该拦截器可用来添加或修改列表的属性
◆ 属性: retrieveRowsCallback
描述:
指定列表所使用的分页机制.值可以是自定义的完整的callback类名,也可以是在properties文件内指定的简称

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

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

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

◆ 属性: width
描述:
指定列表的宽度.相当于<table>的width属性

◆ 属性: listWidth
描述:
Specify the location of pagination bar . Acceptable values are up or down.

◆ 属性: listHeight
描述:
Specify the location of pagination bar . Acceptable values are up or down.

◆ 属性: height
描述:
指定列表的高度.相当于<table>的height属性.当值为"auto"时,列表高度将随着列表内容自动调整.
只有在非classic模式下才有效.

◆ 属性: excludeTool
描述:
Specify whether or not to show the rows displayed bar . Acceptable values are "true" or "false".

◆ 属性: showHeader
描述:
是否显示列表表头.

评论

2 楼 no_bao 2013-08-01  

u010145702 写道

我初接触这个标签，这些属性不太懂，你能不能讲讲这些属性如何使用啊

<ec:table items="templatelist" var="template"
			retrieveRowsCallback="limit" action="Query.action" title=""
			showPrint="true" width="100%" xlsFileName="template.xls"
			classic="true" useAjax="false" sortable="true"
			autoIncludeParameters="false" toolbarLocation="top" pageSizeList="20,30,50,100">

			<ec:row onclick="view('${template.templateId}')">
				<ec:column property="templateName" title="模板名" />
				<ec:column property="createUser" title="创建人" />
				<ec:column property="createTime" title="创建时间" />
				<ec:column property="statusName" title="模板状态" />
			</ec:row>
</ec:table>

这个只能自己试试，就是ecside标签里面的属性。这个文档只是描述每个属性的作用。和html标签有类似之处，比如<input name="testName" /> 中name属性就是这个input元素的名字

1 楼 u010145702 2013-07-18  

我初接触这个标签，这些属性不太懂，你能不能讲讲这些属性如何使用啊