displaytag是最常用的数据表格显示标签之一.官方网址: http://displaytag.sf.net
下载地址:
http://sourceforge.net/project/showfiles.php?group_id=73068
关键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为空时的提示信息.默认=Nothing found to display.该属性只有在basic.empty.showtable为false时有效.
basic.msg.empty_list_row=htmlStrings
设置当需显示的list为空时输出的信息.
默认=<tr class="empty"><td colspan="{0}">Nothing found to display.</td></tr>
通配符{0}指示当前table的栏为数,该整数用来设置正确的colspan,避免显示混乱.
该属性只有在basic.empty.showtable为true时有效.
sort.amount=page|list
设置对需输出的list数据在什么时机执行排序,默认=page
如果=page那么list数据先分页再排序;如果=list则先整体排序后分页.
export.banner=htmlStrings
设置在启用export功能后,在表格底部显示的导出数据种类的链接html字符.
默认=<div class="exportlinks">Export options: {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则上下都显示.
例如: sum items found,displaying pagesize to pagesize*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显示内容.
默认=<span class="pagebanner">No {0} found.</span>
通配符{0}指list包含的对象名称,也就是paging.banner.item_name/items_name值
paging.banner.one_item_found=strings
设置启用分页功能后,list只有一个数据时分页信息的显示内容.
默认=<span class="pagebanner">One {0} found.</span>
通配符{0}指list包含的对象名称,也就是paging.banner.item_name/items_name值
paging.banner.all_items_found=strings
设置启用分页功能后list可以一次显示完的显示信息内容.
默认=<span class="pagebanner">{0} {1} found, displaying all {2}.</span>
占位符{0}和{2}替换为list长度,{1}替换为list包含对象的名称.
paging.banner.some_items_found=strings 设置启用分页功能后,多页时显示的分页信息.
默认=<span class="pagebanner">{0} {1} found, displaying {2} to {3}.</span>
{0}是总数,{1}是对象名称,{2}是当前起始点,{3}是当前结束点.
paging.banner.group_size=8
设置启用分页功能后,如果有多页,需要显示页面跳转的个数.默认=8.
paging.banner.full=strings
设置分页的换页信息.默认=<span class="pagelinks">
[<a href="{1}">First</a>/<a href="{2}">Prev</a>] {0} [<a href="{3}">
Next</a>/<a href="{4}">Last</a>]</span>
{0}是group_size的数值连接,{1}是连接到第一页,{2}是连接到前一页
{3}是连接到下一页,{4}是连接到最后一页
paging.banner.first=strings
设置显示第一页时的分页栏信息,默认=<span class="pagelinks">[First/Prev] {0}
[<a href="{3}">Next</a>/<a href="{4}">Last</a>]</span>
占位符的值和full属性相同
paging.banner.last=strings
设置显示最后一页时的分页栏信息.默认=<span class="pagelinks">
[<a href="{1}">First</a>/<a href="{2}">Prev</a>] {0} [Next/Last]</span>
占位符的值和full属性相同
paging.banner.onepage=strings
只有一页时的分页栏显示信息,默认=<span class="pagelinks">{0}</span>
paging.banner.page.selected=strings
设置多页时选择了某页时的显示信息,默认=<strong>{0}</strong>
paging.banner.page.link=strings
设置分页的连接信息<a href="{1}" title="Go to page {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.DefaultRequestHelperFact
ory
export.types=csv excel xml pdf rtf
设置支持的导出文件类型
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.class=classpath
设置标签实现数据导出的装饰java类名,默认=org.displaytag.export.PdfView
export.csv.label=strings
设置转换格式显示的文本,默认=<span class="export csv">CVS </span>
export.excel.label=strings
设置转换格式显示的文本,默认=<span class="export excel">EXCEL </span>
export.xml.label=strings
设置转换格式显示的文本,默认=<span class="export xml">XML </span>
export.pdf.label=strings
设置转换格式显示的文本,默认=<span class="export pdf">PDF </span>
export.rtf.label=strings
设置转换格式显示的文本,默认=<span class="export rtf">RTF </span>
export.csv.include_header=true|false
设置导出数据时是否在目标文件里加入当前表格的表头,默认=false
export.excel.include_header=true|false 设置导出数据时是否在目标文件里加入当前表格的表头,默认=true
export.xml.include_header=true|false
设置导出数据时是否在目标文件里加入当前表格的表头,默认=true
export.pdf.include_header=true|false
设置导出数据时是否在目标文件里加入当前表格的表头,默认=true
export.rtf.include_header=true|false
设置导出数据时是否在目标文件里加入当前表格的表头,默认=true
export.csv.filename=strings
设置导出的文件名
export.excel.filename=strings
设置导出的文件名
export.xml.filename=strings
设置导出的文件名
export.pdf.filename=strings
设置导出的文件名
export.rtf.filename=strings
设置导出的文件名
export.amount=page, list
设置导出数据时是对全部list数据还是只对当前page的数据执行导出,默认=page
export.decorated=true, false
设置如果有装饰类,那么是否对导出的数据也经过装饰类过滤,默认=true
css.tr.even=even
设置数据表偶数行的显示样式,默认=even,可以是任何css的class名
css.tr.odd=odd
设置数据表奇数行的显示样式,默认=odd,可以是任何css的class名
css.th.sorted=sorted
设置可排序栏位已排序头的css样式,默认=sorted,可以是任何css的class名
css.th.ascending=order1
设置可排序栏位头升序的css样式,默认=order1,可以是任何css的class名
css.th.descending=order2
设置可排序栏位头降序的css样式,默认=order2,可以是任何css的class名
css.table=
设置可排序栏位的css样式,默认=sorted,可以是任何css的class名
css.th.sortable=sortable
设置可排序栏位可排序的css样式,默认=sortable,可以是任何css的class名
标签属性说明
<display:caption>
产生一个<caption></caption>标记,可以包含jsp文件.
class
简单的css的class名
dir
文字读写方向
id
caption标记的id
lang
caption标记的lang属性
media
导出数据的文件类型,默认=all,多个值用空格分开,例如 csv excel xml pdf rtf
style
设置样式
title
设置title属性,鼠标停留将会显示该文本.
<display:column>
产生数据表格中的一栏,每笔记录将按属性填充到该栏
autolink
boolean,如果为true将数据装饰成一个地址超连接,形如<a href="
values...mailto:values...">values...</a>默认=false
class
该栏css的class名称,将覆盖上层css
comparator
java全限定名,用于实现该栏数据排序的比较运算,必须实现Comparator接口,默认=DefaultComparator
decorator
java全限定名,用于装饰该栏数据显示,必须实现DisplaytagColumnDecorato
r接口
defaultorder
设置默认排序规则,ascending或descending,默认是升序
escapeXml
boolean,是否对特殊字符过滤转换.默认false
format
设置对国际化数据的格式化格式,例如money,date等
group
设置分组显示的深度数值,以1开始累加.可以对查询出来的重复数据屏蔽显示,当低数值不再匹配后会继续分组高数值的栏.
headerClass
对数据表头的样式class名称.
headerScope
对表头加scope属性
href
超连接的地址
maxLength
当前栏的最大显示字符数,超过将以...替换超出的,并在鼠标停留是显示全部.
maxWords
当前栏的最大显示文字数,超过将以...替换超出的,并在鼠标停留是显示全部.
media
导出数据的文件类型,默认=all,多个值用空格分开,例如 csv excel xml pdf rtf
nulls
boolean,对为null的数据不显示'null'而是以空白代替.默认=false
paramId
附加到url上的参数名称.如果没特别指定,参数值就是当前栏的值.
paramName
在paramScope指定的范围里查找paramName指定的属性并把属性值加到paramId为名称的url参数里面.
paramProperty 在当前list的数据里面查找paramProperty指定的属性的值加到paramId为名称的url参数里面.
property
当前list里面存储的属性名,会自动匹配并输出其值.
scope
当前数据的范围,page,request,session,appliaction
sortName
指定排序的属性名称.如果值未指定,默认为_rowNum值,也就是当前行号
sortProperty
指定需要排序的属性.
sortable
boolean,指定当前栏是否需要排序,如果为true那么所有排序的对象必须实现了Comparator接口.默认=false
style
当前栏的样式
title
设置当前栏的title属性值
titleKey
国际化属性,用来根据该key值到资源文件里面取回实际的title文本.
total
boolean,是否对当前栏的所有数据进行汇总计算.默认=false
url
和herf一样的url设置
value
填充到栏位的文本值
paramScope
配合paramName用来指定查找的范围
<display:footer>
显示表格底部的标签,可以包含jsp文件
media
指定导出数据时的文件格式类型,默认=all,多个值用空格分开,例如 csv excel xml pdf rtf
<display:setProperty>
重新设置当前表格的配置属性,参见前面的displaytag.properties文件
name
必须,需要配置属性的名称
value
对name更新的值
<display:table>
创建一个数据表格
cellpadding
表格属性
cellspacing
表格属性
class
表格属性
decorator
对整个list的装饰类,java全限定名
defaultorder
对整个list排序的排序规则,ascending或descending,默认是升序
defaultsort
默认排序的栏,整数,以1开始
excludedParams 排除出参数之外的参数列表,以空格分开
export
boolean,是否可以导出成指定的文件格式,默认false
frame
html属性
htmlId
对应html的id属性
id
唯一标示该displaytag实例的标示符,不可以包含运行期的表达式
length
最长的显示记录数
list
指示用于填充数据表的数据集合list名称,一般用name代替
name
存储在访问范围内的数据集合对象的名称,tag会在page,request等范围查找该对象并取回数据填充表格
offset
取回list数据中的偏移整数值,用于分页
pagesize
每页显示的最大记录数,用于分页
partialList
是否可以使用list的子集合来填充数据
requestURI
如果出现,该url值会自动添加到其他url前面
requestURIcontext boolean,是否自动使用request上下文里面的url.
rules
html属性
size
当partialList设为true时才有用,用来设置每次取回的子集合长度
sort
page或list,设置排序发生的时机
style
html样式
summary
html属性
uid
唯一表示当前displaytag实例的名称.可以用uid_rowNum表示当前行,并引用所有集合内数据.该值必须页面内唯一
varTotals
定义一个存储所有行数和值的map.
关键api说明:
displaytag-11.jar
displaytag-export-poi-11.jar
displaytag-portlet-11.jar
依赖api说明:
commons-beanutils-170.jar
commons-collections-31.jar
commons-lang-21.jar
commons-logging-104.jar
log4j-1212.jar
itext-13.jar
运行环境说明:
displaytag目前版本是1.1;需要jdk1.4,servlet2.3,jsp1.2或更高容器支持.如果无法达到要求只能使用1.0版本.
配置属性说明:
如果你要替换修改displaytag的属性和资源文件需要把displaytag.properties加入到当前应用的classpath.
如果你只要修改某单独displaytag的属性可以使用<display:setProperty>标签.
下面陈述所有可能的配置参数和值.
basic.empty.showtable=false|true
basic.show.header=true
basic.msg.empty_list=Strings
basic.msg.empty_list_row=htmlStrings
sort.amount=page|list
export.banner=htmlStrings
export.banner.sepchar= |(chars)
paging.banner.placement=top,bottom,both 设置起用分页功能后,分页信息栏出现在数据表的位置,默认=top
paging.banner.item_name=item
paging.banner.items_name=items
paging.banner.no_items_found=strings
paging.banner.one_item_found=strings
paging.banner.all_items_found=strings
paging.banner.some_items_found=strings
paging.banner.group_size=8
paging.banner.full=strings
paging.banner.first=strings
paging.banner.last=strings
paging.banner.onepage=strings
paging.banner.page.selected=strings
paging.banner.page.link=strings
paging.banner.page.separator=, \
factory.decorator=classpath
factory.requestHelper=classpath
export.types=csv excel xml pdf rtf
export.csv=true
export.excel=true
export.xml=true
export.pdf=false
export.rtf=false
export.csv.class=classpath
export.excel.class=classpath
export.xml.class=classpath
export.pdf.class=classpath
export.csv.label=strings
export.excel.label=strings
export.xml.label=strings
export.pdf.label=strings
export.rtf.label=strings
export.csv.include_header=true|false
export.excel.include_header=true|false
export.xml.include_header=true|false
export.pdf.include_header=true|false
export.rtf.include_header=true|false
export.csv.filename=strings
export.excel.filename=strings
export.xml.filename=strings
export.pdf.filename=strings
export.rtf.filename=strings
export.amount=page, list
export.decorated=true, false
css.tr.even=even
css.tr.odd=odd
css.th.sorted=sorted
css.th.ascending=order1
css.th.descending=order2
css.table=
css.th.sortable=sortable
标签属性说明
<display:caption>
class
dir
id
lang
media
style
title
<display:column>
autolink
class
comparator
decorator
defaultorder
escapeXml
format
group
headerClass
headerScope
href
maxLength
maxWords
media
nulls
paramId
paramName
paramProperty
property
scope
sortName
sortProperty
sortable
style
title
titleKey
total
url
value
paramScope
<display:footer>
media
<display:setProperty>
name
value
<display:table>
cellpadding
cellspacing
class
decorator
defaultorder
defaultsort
excludedParams 排除出参数之外的参数列表,以空格分开
export
frame
htmlId
id
length
list
name
offset
pagesize
partialList
requestURI
requestURIcontext boolean,是否自动使用request上下文里面的url.
rules
size
sort
style
summary
uid
varTotals
可能有些理解错误,并没有全部测试.