txtechWMLXhtml标签文档包jarfreemaker.docx
《txtechWMLXhtml标签文档包jarfreemaker.docx》由会员分享，可在线阅读，更多相关《txtechWMLXhtml标签文档包jarfreemaker.docx（13页珍藏版）》请在冰点文库上搜索。
txtechWMLXhtml标签文档包jarfreemaker
天下网专用标签说明文档
V1.0
Createbygui
1.文档更新日志
时间
操作人
说明
2008-06-26
gui
创建文档
2009-10-09
gui
新增标签
2.文档说明
Freemarker中引入标签,1.0:
<#assigntx=JspTaglibs[“/WEB-INF/tx-taglibs-wml-1.0.tld”]>
2.0:
<#assignxhtml=JspTaglibs[“/WEB-INF/tx-taglibs-xhtml-1.0.tld”]>
jsp中引入标签,1.0:
<%@tagliburi=”/WEB-INF/tx-taglibs-wml-1.0.tld”prefix=”tx”%>
2.0:
<%@tagliburi=”/WEB-INF/tx-taglibs-xhtml-1.0.tld”prefix=”xhtml”%>
[attribute=”value”]:
这是一个可选的标签属性
attribute=”value”|attribute=”value”:
两个属性中必须选择一个,都选时按文档中的优先顺序决定使用哪一个属性
文档示例使用freeMarker语法
2.1href
URL重写（加z=）,加jessionid.
2.0中可以使用,根据cookie中access的属性决定是否在URL中增加参数z
语法:
<@tx.hrefurl=”value”[encodeURL=”value”]>bodycontent
属性：
名称
必须
类型
默认值
说明
url
Y
String
null
链接中增加用户信息
encodeURL
N
boolean
false
加上jessionid
id
N
String
null
2.0专有属性
cssClass
N
String
null
2.0专有属性,即class
name
N
String
null
2.0专有属性
onclick
N
String
null
2.0专有属性
target
N
String
null
2.0专有属性
type
N
String
null
2.0专有属性
title
N
String
null
2.0专有属性
rel
N
String
null
2.0专有属性
accesskey
N
String
null
2.0专有属性
2.2anchor
anchor方式,默认post方式提交,utf-8编码,链接加z=,链接名称中特殊字符自动转换
兼容2.0,不过原来的代码顺序要做相应的调整:
输入框应该移至本标签体内,原param标签同样兼容2.0,不过其参数以隐藏的形式传送.（charset在2.0中无效）,2.0中的submit的name为tagSubmit
语法：
<@tx.anchorurl=”value”title=”value”[method=”post|get”][charset=”value”][encodeURL=”false|true”]>
bodycontent
anchor>
属性：
名称
必须
类型
默认值
说明
url
Y
String
null
链接
title
Y
String
null
链接名称
method
N
String
post
提交方式
charset
N
String
utf-8
编码方式
encodeURL
N
Boolean
false
加上jessionid
2.3param
配合<@tx.anchor>,传递参数
兼容2.0.具体说明见
语法：
<@tx.paramvar=”value”value=”value”/>
属性：
名称
必须
类型
默认值
说明
var
Y
String
empty
参数名
value
Y
String
empty
值
2.4txdiv
天下网内容分割符
2.0中暂时同1.0的表现形式不变
语法：
<@tx.txdiv/>
2.5critic
评论模块，原评论系统，现评论系统已升级
兼容2.0
语法：
<@tx.criticapp=”value”sign=”value”[topshow=”value”][returl=”value”][anonymous=”value”]/>
属性：
名称
必须
类型
默认值
说明
app
Y
String
null
评论模块名称
sign
Y
String
null
唯一标识
topshow
N
Integer
String
3
显示评论的条数
returl
N
String
当前页
注意forward页面
anonymous
N
Boolean
false
2.6out
输出显示,可指定输出长度,过滤特殊字符
兼容2.0
语法：
<@tx.outvalue=”value”[words=”value”][start=”value”][end=”value”][def=”value”]/>
属性：
名称
必须
类型
默认值
说明
value
Y
String
null
输出字符串
words
N
Integer
String
优先,从头开始截取
显示字符数
start
N
Integer
String
words
截取的开始位置
end
N
Integer
String
与start配合使用,默认截到最后
截取的结束位置
def
N
String
…
超过指定长度时末尾添加的字符
2.7page
新的分页标签参见2.19,支持两种样式
标准分页,支持get|post两种方式,使用时url应按如下格式:
http:
//domain/xx.xx?
[param=value[…]]&pn=
兼容2.0
在freemarker模板中,请通过setAttribute（“pageTagParameter”,Map）赋值,标签按page|request|session的顺序查找该对象.
语法：
<@tx.pagetotal=”value”totalpage=”value”|row=”value”pagenow=”value”url=”value”[desc=”value”][style=”value”][method=”post|get”][charset=”value”][param=”value”][encodeURL=”false|true”]/>
或
<@tx.pagetotal=”value”totalpage=”value”|row=”value”pagenow=”value”url=”value”[desc=”value”][style=”value”][method=”post|get”][charset=”value”][param=”value”][encodeURL=”false|true”]>
bodycontent
属性：
名称
必须
类型
默认值
说明
total
Y
Integer
String
0
列表记录总数
totalpage
N
Integer
String
0
列表总分页,优于row
row
N
Integer
String
10
每页显示的记录数量
pagenow
Y
Integer
String
0
当前页数
url
Y
String
null
翻页地址
desc
N
String
条
记录条数的形容词
style
N
int/String
0
翻页样式,0.标准（2行）1.简单（1行）
method
N
String
get
链接提交方式
charset
N
String
utf-8
编码方式
param
N
Java.util.Map
null
以post方式提交
encodeURL
N
Boolean
false
加jessionid
2.8recommend
推荐模块，推荐系统已升级，未更新
兼容2.0
语法：
<@tx.recommenddesc=”value”[url=”value”][value=”value”][returl=”value”]>
bodycontent
属性：
名称
必须
类型
默认值
说明
desc
Y
String
null
推荐简介
url
N
String
当前页URL
推荐页面的地址
value
N
String
同desc
推荐内容
returl
N
String
同url
注意forward页面
2.9return
手机软返回,原XXX
不支持2.0,保留时不输出任何信息
语法：
<@tx.returnvalue=”value”/>
或<@tx.return>bodycontent
属性：
名称
必须
类型
默认值
说明
value
N
String
null
链接名称
2.10loc
记录用户当前位置
兼容2.0
语法：
<@tx.locappid=”value”[subid=”value”][url=”value”]/>
属性：
名称
必须
类型
默认值
说明
appid
Y
Integer
String
0
<1时不操作
subid
N
Integer
String
0
url
N
String
当前页URL
注意forward时不同
2.11ontimer
自动跳转
兼容2.0,注意放置到
内（2.0中z已经不用了）
语法：
<@tx.ontimerurl=”value”[time=”value”][z=”value”][encodeURL=”value”]/>
属性：
名称
必须
类型
默认值
说明
url
Y
String
null
跳转目的地
time
N
Integer
String
10
暂停时间
z
N
Boolean
true
是否带z值
encodeURL
N
Boolean
false
是否加jessionid
2.12link
标准页脚
1.0/2.0中都不推荐使用,改用包含文件
语法：
<@tx.link/>
2.13header
标准页头
兼容2.0
语法：
<@tx.header/>
2.14cardheader
cardHeader.jsp
1.0/2.0中都不推荐使用,改用包含文件
语法：
<@tx.cardheader/>
2.15firstIn
firstIn.jsp
1.0/2.0中都不推荐使用,改用包含文件
语法：
<@tx.firstIn/>
2.16userName
根据用户ID取用户昵称,特殊字符已经转换.
兼容2.0
语法：
<@tx.userNameuid=”value”/>
属性：
名称
必须
类型
默认值
说明
uid
Y
Integer
String
0
用户ID
2.17formatDate
格式化时间输出.应用于freeMarker时建议使用其自带的格式化输出方法。
目前此标签在freeMarker中只能传入字符串类型的时间值.（freeMarker格式化时间:
${time?
string（“yyyy-MM-ddHH:
mm:
ss”）}）
兼容2.0
常用语法：
<@tx.formatDatevalue=”value”[pattern=”yyyy-MM-ddHH:
mm:
ss”][valuePattern=”value”]/>
属性：
名称
必须
类型
默认值
说明
value
Y
java.util.Date
java.lang.long
java.lang.String
null
需要格式化的时间,String也可以是时间戳
pattern
N
java.lang.String
yyyy-MM-ddHH:
mm:
ss
输入的时间格式
valuePattern
N
java.lang.String
yyyy-MM-ddHH:
mm:
ss
当时value是字符串时的格式,字符类时间戳不用
2.18txDate
天下网专用的格式化时间输出.等同于直接调用com.tx.util.date.TxDateFormat.standardDateFormat（java.util.Datedate）方法.目前此标签在freeMarker中只能传入字符串类型的时间值
兼容2.0
常用语法：
<@tx.txDatevalue=”value”[valuePattern=”value”]/>
属性：
名称
必须
类型
默认值
说明
value
Y
java.util.Date
java.lang.long
java.lang.String
null
需要格式化的时间,String也可以是时间戳
valuePattern
N
java.lang.String
yyyy-MM-ddHH:
mm:
ss
当时value是字符串时的格式,字符类时间戳不用
2.19txPage
支持两种样式的分页
新的分页标签,请构造一个com.tx.util.web.PageSplitUtil对象并命名为pageSplitUtil,将按page/request/session顺序查找该变量.
当分页需要通过post方式传递参数时,请使用setAttribute（“pageTagParameter”,Map）赋值,标签按page|request|session的顺序查找该对象.
注意:
分页的参数名指定为pn,这一点与原标签不同,请注意
兼容2.0
查看原分页标签说明
常用语法：
<@tx.txPage[style=”value”]/>
属性：
名称
必须
类型
默认值
说明
style
N
int/String
0
分页样式,0.标签分页（2行）,1.简单分页
2.18hotCommend
热辣推荐
兼容2.0
常用语法：
<@tx.hotCommend[showNums=”value”][title=”value”]/>
属性：
名称
必须
类型
默认值
说明
showNums
N
int
String
3
热辣推荐显示条数
title
N
String
[HOT]热辣推荐
2.19getUrl
处理传入的URL：
根据cookie中access的属性决定是否在URL中增加参数z
仅支持2.0
常用语法：
<@xhtml.getUrl[showNums=”value”][title=”value”]/>
属性：
名称
必须
类型
默认值
说明
url
Y
String
null
encodeURL
N
String
false
升级会员 