displaytag手冊

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.DefaultRequestHelperFactory
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全限定名,用于裝飾該欄數據顯示,必須實現DisplaytagColumnDecorator接口
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. 可能有些理解錯誤,并沒有全部測試.

總結

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

如果覺得生活随笔網站內容還不錯，歡迎將生活随笔推薦給好友。