displaytag手冊

displaytag是最常用的數(shù)據(jù)表格顯示標簽之一.官方網(wǎng)址:http://displaytag.sf.net 下載地址:http://sourceforge.net/project/showfiles.php?group_id=73068
關(guān)鍵api說明:
displaytag-11.jar?????????????????????? 必須,displayTag的主要實現(xiàn)APIs
displaytag-export-poi-11.jar??????????? 可選,displayTag的導(dǎo)出excel文件的APIs
displaytag-portlet-11.jar?????????????? 可選,displayTag適配jsr168入口定義的實現(xiàn)APIs
依賴api說明:
commons-beanutils-170.jar?????????????? 必須,apache的beanutils實現(xiàn)APIs
commons-collections-31.jar????????????? 必須,apache的集合加強工具類庫APIs
commons-lang-21.jar???????????????????? 必須,apache的java.lang加強類庫
commons-logging-104.jar???????????????? 必須,apache的日志實現(xiàn)類庫
log4j-1212.jar????????????????????????? 必須,apache的日志實現(xiàn)類庫
itext-13.jar??????????????????????????? 可選,開源的對pdf文件操作類庫
運行環(huán)境說明:
displaytag目前版本是1.1;需要jdk1.4,servlet2.3,jsp1.2或更高容器支持.如果無法達到要求只能使用1.0版本.
配置屬性說明:
如果你要替換修改displaytag的屬性和資源文件需要把displaytag.properties加入到當前應(yīng)用的classpath.
如果你只要修改某單獨displaytag的屬性可以使用<display:setProperty>標簽.
下面陳述所有可能的配置參數(shù)和值.
basic.empty.showtable=false|true??????? 設(shè)置當需輸出的list為空時是否顯示表格.默認false.為true時會輸出基本表格結(jié)構(gòu)并提示沒數(shù)據(jù),為false只提示沒數(shù)據(jù)不產(chǎn)生表格html 完整形式如<table><thead><tr><th></th>< /tr></thead><tbody></tbody></table>
basic.show.header=true????????????????? 設(shè)置在數(shù)據(jù)表格頂端是否顯示表格頭.默認true. 表格頭可能包含每欄的標題,分頁,導(dǎo)出數(shù)據(jù)等信息. 也就是不輸出<thead><tr><th></th></tr>< /thead>的html
basic.msg.empty_list=Strings??????????? 設(shè)置當需輸出的list為空時的提示信息.默認=Nothing found to display.該屬性只有在basic.empty.showtable為false時有效.
basic.msg.empty_list_row=htmlStrings??? 設(shè)置當需顯示的list為空時輸出的信息.
??????????????????????????????????????? 默認=<tr class="empty"><td colspan="{0}">Nothing found to display.</td></tr>
??????????????????????????????????????? 通配符{0}指示當前table的欄為數(shù),該整數(shù)用來設(shè)置正確的colspan,避免顯示混亂.
??????????????????????????????????????? 該屬性只有在basic.empty.showtable為true時有效.
sort.amount=page|list?????????????????? 設(shè)置對需輸出的list數(shù)據(jù)在什么時機執(zhí)行排序,默認=page
??????????????????????????????????????? 如果=page那么list數(shù)據(jù)先分頁再排序;如果=list則先整體排序后分頁.
export.banner=htmlStrings?????????????? 設(shè)置在啟用export功能后,在表格底部顯示的導(dǎo)出數(shù)據(jù)種類的鏈接html字符.
??????????????????????????????????????? 默認=<div class="exportlinks">Export options: {0}</div>
??????????????????????????????????????? 通配符{0}指各種導(dǎo)出數(shù)據(jù)的格式,可能有csv,excel,xml,pdf,rtf等
??????????????????????????????????????? 實際上針對選擇的各種數(shù)據(jù)文件格式都會產(chǎn)生相應(yīng)的鏈接替換到位置{0}
export.banner.sepchar= |(chars)???????? 設(shè)置啟用export功能后,各導(dǎo)出數(shù)據(jù)類型之間的分隔符號.默認='|'
??????????????????????????????????????? 它可以是任何字符,效果例如 csv|excel|xml|pdf|rtf
paging.banner.placement=top,bottom,both 設(shè)置起用分頁功能后,分頁信息欄出現(xiàn)在數(shù)據(jù)表的位置,默認=top
??????????????????????????????????????? 如果為top只顯示在上方,為bottom只顯示在下方,為both則上下都顯示.
??????????????????????????????????????? 例如: sum items found,displaying pagesize to pagesize*2 [First/Prev]n..[Next/Last]
paging.banner.item_name=item??????????? 設(shè)置需輸出的list包含的對象為單個時顯示的名稱,默認=item.通常用于國際化
paging.banner.items_name=items????????? 設(shè)置需輸出的list包含的對象為多個時顯示的名稱,默認=items.通常用于國際化
paging.banner.no_items_found=strings??? 設(shè)置啟用分頁功能后,list有多個數(shù)據(jù)時分頁信息欄的html顯示內(nèi)容.
??????????????????????????????????????? 默認=<span class="pagebanner">No {0} found.</span>
??????????????????????????????????????? 通配符{0}指list包含的對象名稱,也就是paging.banner.item_name/items_name值
paging.banner.one_item_found=strings??? 設(shè)置啟用分頁功能后,list只有一個數(shù)據(jù)時分頁信息的顯示內(nèi)容.
??????????????????????????????????????? 默認=<span class="pagebanner">One {0} found.</span>
??????????????????????????????????????? 通配符{0}指list包含的對象名稱,也就是paging.banner.item_name/items_name值
paging.banner.all_items_found=strings?? 設(shè)置啟用分頁功能后list可以一次顯示完的顯示信息內(nèi)容.
??????????????????????????????????????? 默認=<span class="pagebanner">{0} {1} found, displaying all {2}.</span>
??????????????????????????????????????? 占位符{0}和{2}替換為list長度,{1}替換為list包含對象的名稱.
paging.banner.some_items_found=strings? 設(shè)置啟用分頁功能后,多頁時顯示的分頁信息.
??????????????????????????????????????? 默認=<span class="pagebanner">{0} {1} found, displaying {2} to {3}.</span>
??????????????????????????????????????? {0}是總數(shù),{1}是對象名稱,{2}是當前起始點,{3}是當前結(jié)束點.
paging.banner.group_size=8????????????? 設(shè)置啟用分頁功能后,如果有多頁,需要顯示頁面跳轉(zhuǎn)的個數(shù).默認=8.
paging.banner.full=strings????????????? 設(shè)置分頁的換頁信息.默認=<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的數(shù)值連接,{1}是連接到第一頁,{2}是連接到前一頁
??????????????????????????????????????? {3}是連接到下一頁,{4}是連接到最后一頁
paging.banner.first=strings???????????? 設(shè)置顯示第一頁時的分頁欄信息,默認=<span class="pagelinks">[First/Prev] {0}
??????????????????????????????????????? [<a href="{3}">Next</a>/<a href="{4}">Last</a>]</span>
??????????????????????????????????????? 占位符的值和full屬性相同
paging.banner.last=strings????????????? 設(shè)置顯示最后一頁時的分頁欄信息.默認=<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???? 設(shè)置多頁時選擇了某頁時的顯示信息,默認=<strong>{0}</strong>
paging.banner.page.link=strings???????? 設(shè)置分頁的連接信息<a href="{1}" title="Go to page {0}">{0}</a>
??????????????????????????????????????? 占位符{0}是頁碼,{1}是訪問頁面的連接
paging.banner.page.separator=, \??????? 設(shè)置各頁碼間的分隔符號,默認=','
factory.decorator=classpath???????????? 設(shè)置輸出list數(shù)據(jù)的裝飾類的java全限定名,
??????????????????????????????????????? 默認=org.displaytag.decorator.DefaultDecoratorFactory
factory.requestHelper=classpath???????? 設(shè)置實現(xiàn)RequestHelperFactory的類名.需要displaytag-portlet-11.jar包
??????????????????????????????????????? 默認=org.displaytag.util.DefaultRequestHelperFactory
export.types=csv excel xml pdf rtf????? 設(shè)置支持的導(dǎo)出文件類型
export.csv=true???????????????????????? 設(shè)置標簽是否應(yīng)該轉(zhuǎn)化成cvs格式導(dǎo)出
export.excel=true?????????????????????? 設(shè)置標簽是否應(yīng)該轉(zhuǎn)化成excel格式導(dǎo)出
export.xml=true???????????????????????? 設(shè)置標簽是否應(yīng)該轉(zhuǎn)化成xml格式導(dǎo)出
export.pdf=false??????????????????????? 設(shè)置標簽是否應(yīng)該轉(zhuǎn)化成pdf格式導(dǎo)出
export.rtf=false??????????????????????? 設(shè)置標簽是否應(yīng)該轉(zhuǎn)化成rtf格式導(dǎo)出
export.csv.class=classpath????????????? 設(shè)置標簽實現(xiàn)數(shù)據(jù)導(dǎo)出的裝飾java類名,默認=org.displaytag.export.CsvView
export.excel.class=classpath??????????? 設(shè)置標簽實現(xiàn)數(shù)據(jù)導(dǎo)出的裝飾java類名,默認=org.displaytag.export.ExcelView
export.xml.class=classpath????????????? 設(shè)置標簽實現(xiàn)數(shù)據(jù)導(dǎo)出的裝飾java類名,默認=org.displaytag.export.XmlView
export.pdf.class=classpath????????????? 設(shè)置標簽實現(xiàn)數(shù)據(jù)導(dǎo)出的裝飾java類名,默認=org.displaytag.export.PdfView
export.csv.label=strings??????????????? 設(shè)置轉(zhuǎn)換格式顯示的文本,默認=<span class="export csv">CVS </span>
export.excel.label=strings????????????? 設(shè)置轉(zhuǎn)換格式顯示的文本,默認=<span class="export excel">EXCEL </span>
export.xml.label=strings??????????????? 設(shè)置轉(zhuǎn)換格式顯示的文本,默認=<span class="export xml">XML </span>
export.pdf.label=strings??????????????? 設(shè)置轉(zhuǎn)換格式顯示的文本,默認=<span class="export pdf">PDF </span>
export.rtf.label=strings??????????????? 設(shè)置轉(zhuǎn)換格式顯示的文本,默認=<span class="export rtf">RTF </span>
export.csv.include_header=true|false??? 設(shè)置導(dǎo)出數(shù)據(jù)時是否在目標文件里加入當前表格的表頭,默認=false
export.excel.include_header=true|false? 設(shè)置導(dǎo)出數(shù)據(jù)時是否在目標文件里加入當前表格的表頭,默認=true
export.xml.include_header=true|false??? 設(shè)置導(dǎo)出數(shù)據(jù)時是否在目標文件里加入當前表格的表頭,默認=true
export.pdf.include_header=true|false??? 設(shè)置導(dǎo)出數(shù)據(jù)時是否在目標文件里加入當前表格的表頭,默認=true
export.rtf.include_header=true|false??? 設(shè)置導(dǎo)出數(shù)據(jù)時是否在目標文件里加入當前表格的表頭,默認=true
export.csv.filename=strings???????????? 設(shè)置導(dǎo)出的文件名
export.excel.filename=strings?????????? 設(shè)置導(dǎo)出的文件名
export.xml.filename=strings???????????? 設(shè)置導(dǎo)出的文件名
export.pdf.filename=strings???????????? 設(shè)置導(dǎo)出的文件名
export.rtf.filename=strings???????????? 設(shè)置導(dǎo)出的文件名
export.amount=page, list??????????????? 設(shè)置導(dǎo)出數(shù)據(jù)時是對全部list數(shù)據(jù)還是只對當前page的數(shù)據(jù)執(zhí)行導(dǎo)出,默認=page
export.decorated=true, false??????????? 設(shè)置如果有裝飾類,那么是否對導(dǎo)出的數(shù)據(jù)也經(jīng)過裝飾類過濾,默認=true
css.tr.even=even??????????????????????? 設(shè)置數(shù)據(jù)表偶數(shù)行的顯示樣式,默認=even,可以是任何css的class名
css.tr.odd=odd????????????????????????? 設(shè)置數(shù)據(jù)表奇數(shù)行的顯示樣式,默認=odd,可以是任何css的class名
css.th.sorted=sorted??????????????????? 設(shè)置可排序欄位已排序頭的css樣式,默認=sorted,可以是任何css的class名
css.th.ascending=order1???????????????? 設(shè)置可排序欄位頭升序的css樣式,默認=order1,可以是任何css的class名
css.th.descending=order2??????????????? 設(shè)置可排序欄位頭降序的css樣式,默認=order2,可以是任何css的class名
css.table=????????????????????????????? 設(shè)置可排序欄位的css樣式,默認=sorted,可以是任何css的class名
css.th.sortable=sortable??????????????? 設(shè)置可排序欄位可排序的css樣式,默認=sortable,可以是任何css的class名
標簽屬性說明
<display:caption>?????????????????????? 產(chǎn)生一個<caption></caption>標記,可以包含jsp文件.
class????????? 簡單的css的class名
dir??????????? 文字讀寫方向
id???????????? caption標記的id
lang?????????? caption標記的lang屬性
media????????? 導(dǎo)出數(shù)據(jù)的文件類型,默認=all,多個值用空格分開,例如 csv excel xml pdf rtf
style????????? 設(shè)置樣式
title????????? 設(shè)置title屬性,鼠標停留將會顯示該文本.
<display:column>??????????????????????? 產(chǎn)生數(shù)據(jù)表格中的一欄,每筆記錄將按屬性填充到該欄
autolink?????? boolean,如果為true將數(shù)據(jù)裝飾成一個地址超連接,形如<a href="values...mailto:values...">values...</a>默認=false
class????????? 該欄css的class名稱,將覆蓋上層css
comparator???? java全限定名,用于實現(xiàn)該欄數(shù)據(jù)排序的比較運算,必須實現(xiàn)Comparator接口,默認=DefaultComparator
decorator????? java全限定名,用于裝飾該欄數(shù)據(jù)顯示,必須實現(xiàn)DisplaytagColumnDecorator接口
defaultorder?? 設(shè)置默認排序規(guī)則,ascending或descending,默認是升序
escapeXml????? boolean,是否對特殊字符過濾轉(zhuǎn)換.默認false
format???????? 設(shè)置對國際化數(shù)據(jù)的格式化格式,例如money,date等
group????????? 設(shè)置分組顯示的深度數(shù)值,以1開始累加.可以對查詢出來的重復(fù)數(shù)據(jù)屏蔽顯示,當?shù)蛿?shù)值不再匹配后會繼續(xù)分組高數(shù)值的欄.
headerClass??? 對數(shù)據(jù)表頭的樣式class名稱.
headerScope??? 對表頭加scope屬性
href?????????? 超連接的地址
maxLength????? 當前欄的最大顯示字符數(shù),超過將以...替換超出的,并在鼠標停留是顯示全部.
maxWords?????? 當前欄的最大顯示文字數(shù),超過將以...替換超出的,并在鼠標停留是顯示全部.
media????????? 導(dǎo)出數(shù)據(jù)的文件類型,默認=all,多個值用空格分開,例如 csv excel xml pdf rtf
nulls????????? boolean,對為null的數(shù)據(jù)不顯示'null'而是以空白代替.默認=false
paramId??????? 附加到url上的參數(shù)名稱.如果沒特別指定,參數(shù)值就是當前欄的值.
paramName????? 在paramScope指定的范圍里查找paramName指定的屬性并把屬性值加到paramId為名稱的url參數(shù)里面.
paramProperty? 在當前l(fā)ist的數(shù)據(jù)里面查找paramProperty指定的屬性的值加到paramId為名稱的url參數(shù)里面.
property?????? 當前l(fā)ist里面存儲的屬性名,會自動匹配并輸出其值.
scope????????? 當前數(shù)據(jù)的范圍,page,request,session,appliaction
sortName?????? 指定排序的屬性名稱.如果值未指定,默認為_rowNum值,也就是當前行號
sortProperty?? 指定需要排序的屬性.
sortable?????? boolean,指定當前欄是否需要排序,如果為true那么所有排序的對象必須實現(xiàn)了Comparator接口.默認=false
style????????? 當前欄的樣式
title????????? 設(shè)置當前欄的title屬性值
titleKey?????? 國際化屬性,用來根據(jù)該key值到資源文件里面取回實際的title文本.
total????????? boolean,是否對當前欄的所有數(shù)據(jù)進行匯總計算.默認=false
url??????????? 和herf一樣的url設(shè)置
value????????? 填充到欄位的文本值
paramScope???? 配合paramName用來指定查找的范圍
<display:footer>??????????????????????? 顯示表格底部的標簽,可以包含jsp文件
media????????? 指定導(dǎo)出數(shù)據(jù)時的文件格式類型,默認=all,多個值用空格分開,例如 csv excel xml pdf rtf
<display:setProperty>?????????????????? 重新設(shè)置當前表格的配置屬性,參見前面的displaytag.properties文件
name?????????? 必須,需要配置屬性的名稱
value????????? 對name更新的值
<display:table>???????????????????????? 創(chuàng)建一個數(shù)據(jù)表格
cellpadding??? 表格屬性
cellspacing??? 表格屬性
class????????? 表格屬性
decorator????? 對整個list的裝飾類,java全限定名
defaultorder?? 對整個list排序的排序規(guī)則,ascending或descending,默認是升序
defaultsort??? 默認排序的欄,整數(shù),以1開始
excludedParams 排除出參數(shù)之外的參數(shù)列表,以空格分開
export???????? boolean,是否可以導(dǎo)出成指定的文件格式,默認false
frame????????? html屬性
htmlId???????? 對應(yīng)html的id屬性
id???????????? 唯一標示該displaytag實例的標示符,不可以包含運行期的表達式
length???????? 最長的顯示記錄數(shù)
list?????????? 指示用于填充數(shù)據(jù)表的數(shù)據(jù)集合list名稱,一般用name代替
name?????????? 存儲在訪問范圍內(nèi)的數(shù)據(jù)集合對象的名稱,tag會在page,request等范圍查找該對象并取回數(shù)據(jù)填充表格
offset???????? 取回list數(shù)據(jù)中的偏移整數(shù)值,用于分頁
pagesize?????? 每頁顯示的最大記錄數(shù),用于分頁
partialList??? 是否可以使用list的子集合來填充數(shù)據(jù)
requestURI???? 如果出現(xiàn),該url值會自動添加到其他url前面
requestURIcontext boolean,是否自動使用request上下文里面的url.
rules????????? html屬性
size?????????? 當partialList設(shè)為true時才有用,用來設(shè)置每次取回的子集合長度
sort?????????? page或list,設(shè)置排序發(fā)生的時機
style????????? html樣式
summary??????? html屬性
uid??????????? 唯一表示當前displaytag實例的名稱.可以用uid_rowNum表示當前行,并引用所有集合內(nèi)數(shù)據(jù).該值必須頁面內(nèi)唯一
varTotals????? 定義一個存儲所有行數(shù)和值的map. 可能有些理解錯誤,并沒有全部測試.

總結(jié)

以上是生活随笔為你收集整理的displayTag使用详解的全部內(nèi)容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網(wǎng)站內(nèi)容還不錯，歡迎將生活随笔推薦給好友。