displaytag手册.docx

displaytag手册.docx

《displaytag手册.docx》由会员分享，可在线阅读，更多相关《displaytag手册.docx（8页珍藏版）》请在冰豆网上搜索。

displaytag手册

displaytag手册

displaytag手册

displaytag是最常用的数据表格显示标签之一.官方网址:

下载地址:

关键api说明:

displaytag-11.jar必须,displayTag的主要实现APIs

displaytag-export-poi-11.jar可选,displayTag的导出excel文件的APIs

displaytag-portlet-11.jar可选,displayTag适配jsr168入口定义的实现APIs

依赖api说明:

commons-beanutils-170.jar必须,apache的beanutils实现APIs

commons-collections-31.jar必须,apache的集合加强工具类库APIs

commons-lang-21.jar必须,apache的java.lang加强类库

commons-logging-104.jar必须,apache的日志实现类库

log4j-1212.jar必须,apache的日志实现类库

itext-13.jar可选,开源的对pdf文件操作类库

运行环境说明:

displaytag目前版本是1.1;需要jdk1.4,servlet2.3,jsp1.2或更高容器支持.如果无法达到要求只能使用1.0版本.

配置属性说明:

如果你要替换修改displaytag的属性和资源文件需要把displaytag.properties加入到当前应用的classpath.

如果你只要修改某单独displaytag的属性可以使用<display:

setProperty>标签.

下面陈述所有可能的配置参数和值.

basic.empty.showtable=false|true设置当需输出的list为空时是否显示表格.默认false.为true时会输出基本表格结构并提示没数据,为false只提示没数据不产生表格html完整形式如<table><thead><tr><th></th></tr></thead><tbody></tbody></table>

basic.show.header=true设置在数据表格顶端是否显示表格头.默认true.表格头可能包含每栏的标题,分页,导出数据等信息.也就是不输出<thead><tr><th></th></tr></thead>的html

basic.msg.empty_list=Strings设置当需输出的list为空时的提示信息.默认=Nothingfoundtodisplay.该属性只有在basic.empty.showtable为false时有效.

basic.msg.empty_list_row=htmlStrings设置当需显示的list为空时输出的信息.

默认=<trclass="empty"><tdcolspan="{0}">Nothingfoundtodisplay.</td></tr>

通配符{0}指示当前table的栏为数,该整数用来设置正确的colspan,避免显示混乱.

该属性只有在basic.empty.showtable为true时有效.

sort.amount=page|list设置对需输出的list数据在什么时机执行排序,默认=page

如果=page那么list数据先分页再排序;如果=list则先整体排序后分页.

export.banner=htmlStrings设置在启用export功能后,在表格底部显示的导出数据种类的链接html字符.

默认=<divclass="exportlinks">Exportoptions:

{0}</div>

通配符{0}指各种导出数据的格式,可能有csv,excel,xml,pdf,rtf等

实际上针对选择的各种数据文件格式都会产生相应的链接替换到位置{0}

export.banner.sepchar=|（chars）设置启用export功能后,各导出数据类型之间的分隔符号.默认='|'

它可以是任何字符,效果例如csv|excel|xml|pdf|rtf

paging.banner.placement=top,bottom,both设置起用分页功能后,分页信息栏出现在数据表的位置,默认=top

如果为top只显示在上方,为bottom只显示在下方,为both则上下都显示.

例如:

sumitemsfound,displayingpagesizetopagesize*2[First/Prev]n..[Next/Last]

paging.banner.item_name=item设置需输出的list包含的对象为单个时显示的名称,默认=item.通常用于国际化

paging.banner.items_name=items设置需输出的list包含的对象为多个时显示的名称,默认=items.通常用于国际化

paging.banner.no_items_found=strings设置启用分页功能后,list有多个数据时分页信息栏的html显示内容.

默认=<spanclass="pagebanner">No{0}found.</span>

通配符{0}指list包含的对象名称,也就是paging.banner.item_name/items_name值

paging.banner.one_item_found=strings设置启用分页功能后,list只有一个数据时分页信息的显示内容.

默认=<spanclass="pagebanner">One{0}found.</span>

通配符{0}指list包含的对象名称,也就是paging.banner.item_name/items_name值

paging.banner.all_items_found=strings设置启用分页功能后list可以一次显示完的显示信息内容.

默认=<spanclass="pagebanner">{0}{1}found,displayingall{2}.</span>

占位符{0}和{2}替换为list长度,{1}替换为list包含对象的名称.

paging.banner.some_items_found=strings设置启用分页功能后,多页时显示的分页信息.

默认=<spanclass="pagebanner">{0}{1}found,displaying{2}to{3}.</span>

{0}是总数,{1}是对象名称,{2}是当前起始点,{3}是当前结束点.

paging.banner.group_size=8设置启用分页功能后,如果有多页,需要显示页面跳转的个数.默认=8.

paging.banner.full=strings设置分页的换页信息.默认=<spanclass="pagelinks">

[<ahref="{1}">First</a>/<ahref="{2}">Prev</a>]{0}[<ahref="{3}">

Next</a>/<ahref="{4}">Last</a>]</span>

{0}是group_size的数值连接,{1}是连接到第一页,{2}是连接到前一页

{3}是连接到下一页,{4}是连接到最后一页

paging.banner.first=strings设置显示第一页时的分页栏信息,默认=<spanclass="pagelinks">[First/Prev]{0}

[<ahref="{3}">Next</a>/<ahref="{4}">Last</a>]</span>

占位符的值和full属性相同

paging.banner.last=strings设置显示最后一页时的分页栏信息.默认=<spanclass="pagelinks">

[<ahref="{1}">First</a>/<ahref="{2}">Prev</a>]{0}[Next/Last]</span>

占位符的值和full属性相同

paging.banner.onepage=strings只有一页时的分页栏显示信息,默认=<spanclass="pagelinks">{0}</span>

paging.banner.page.selected=strings设置多页时选择了某页时的显示信息,默认=<strong>{0}</strong>

paging.banner.page.link=strings设置分页的连接信息<ahref="{1}"title="Gotopage{0}">{0}</a>

占位符{0}是页码,{1}是访问页面的连接

paging.banner.page.separator=,\设置各页码间的分隔符号,默认=','

factory.decorator=classpath设置输出list数据的装饰类的java全限定名,

默认=org.displaytag.decorator.DefaultDecoratorFactory

factory.requestHelper=classpath设置实现RequestHelperFactory的类名.需要displaytag-portlet-11.jar包

默认=org.displaytag.util.DefaultRequestHelperFactory

export.types=csvexcelxmlpdfrtf设置支持的导出文件类型

export.csv=true设置标签是否应该转化成cvs格式导出

export.excel=true设置标签是否应该转化成excel格式导出

export.xml=true设置标签是否应该转化成xml格式导出

export.pdf=false设置标签是否应该转化成pdf格式导出

export.rtf=false设置标签是否应该转化成rtf格式导出

export.csv.class=classpath设置标签实现数据导出的装饰java类名,默认=org.displaytag.export.CsvView

export.excel.class=classpath设置标签实现数据导出的装饰java类名,默认=org.displaytag.export.ExcelView

export.xml.class=classpath设置标签实现数据导出的装饰java类名,默认=org.displaytag.export.XmlView

export.pdf.