1. Input Tag taglibs 简介... 2
1.1 Input tagLibs Tag UML图... 4
1.2 Input taglibs Tag属性列表... 6
1.2.1 Text Tag. 6
1.2.2 Email Tag. 7
1.2.3 Phone Tag. 7
1.2.4 Mobile Tag. 7
1.2.5 BankAccount Tag. 8
1.2.6 Value Tag. 8
1.2.7 Number Tag. 8
1.2.8 Date Tag. 9
1.2.9 Currency Tag. 10
1.2.10 UnitNumber Tag. 11
1.2.11 Height Tag. 11
1.2.12 Weight Tag. 12
1.2.13 DocumentCode Tag. 12
1.2.14 ApplyCode Tag. 12
1.2.15 PolicyCode Tag. 13
1.2.16 CaseCode Tag. 13
1.2.17 ChangeCode Tag. 13
1.2.18 CertiCode Tag. 13
1.2.19 Percent Tag. 14
1.2.20 Hidden Tag. 14
1.2.21 Button Tag. 14
1.2.22 Textarea Tag. 15
1.2.23 CreditCard Tag. 16
1.2.24 Select Tag. 16
1.2.25 Checkbox Tag. 18
1.2.26 Radio Tag. 18
1.2.27 Link Tag. 19
1.2.28 CreditCardExpiryDate Tag. 19
1.2.29 PersonName Tag. 20
1.2.30 Fax Tag. 21
1.2.31 DisplayTime Tag. 21
2. I18n taglibs简介... 21
2.1 I18n taglibsTag类图... 22
2.2 I18n taglibs Tag属性列表... 22
2.2.1 CodeTable tag. 22
2.2.2 StrRes Tag. 25
3. page taglibs简介... 25
3.1 page taglibs tag类图... 26
3.2 page taglibs tag属性列表... 26
3.2.1 pageConfig Tag. 26
3.2.2 navigator Tag. 27
3.2.3 pageToken Tag. 28
4. table taglibs简介... 29
4.1 table taglibs tag类图... 29
4.2 table taglibs tag属性列表... 29
4.2.1 table Tag. 30
4.2.2 column Tag. 31
5. logic taglibs简介... 33
5.1 logic taglibs tag类图... 34
5.2 logic taglibs tag属性列表... 34
5.2.1 isNull Tag. 34
5.2.2 isNotNull Tag. 35
5.2.3 isEmpty Tag. 35
5.2.4 isNotEmpty Tag. 36
5.2.5 equal Tag. 36
FAQ(常见问题解答) 37
Note1:使用Ebao Tag自动从FormBean取值方法... 37
Note2: date tag中format属性的格式... 37
Note3: 检查页面中输入值不能为空的方法... 37
Note4: 页面自定义的html元素及javascript方法名称不能与tag中已存在javascript方法名称相同,否则会出错 37
Note5: JSP Tag中的属性值不能为服务端代码和客户端代码混合组成... 37
Note6: 如果遇到tag class not found错误,请先重启服务,之后如还存在问题请联系foundation组... 38
1. Input Tag taglibs 简介
Input Tag taglibs中的Tag主要实现了输出Html Input Element的功能,主要包括对HtmlText文本输入的数据进行相应的验证和格式输出功能的Tag,以及Button tag,Textarea tag,CreditCard tag,Select tag,Checkbox tag,Radio tag,Link tag,Hidden tag,具体如下表所示:
Tag Name
Description
input
输出Html Input Element,不作为具体的Jsp Tag使用,只提供继承接口。
text
显示一个类型为Text的Html Input框或输出一个显示文本,继承input Tag。
personName
显示一个人物名称输入框,继承text Tag。
显示一个类型为Text的Html Input框或输出一个显示文本,在作为Input框时,能够验证输入的电子邮箱是否正确,继承text Tag。
phone
显示一个类型为Text的Html Input框或输出一个显示文本,在作为Input框时,能够验证输入的电话号码是否正确,继承text Tag。
fax
显示一个类型为Text的Html Input框或输出一个显示文本,在作为Input框时,能够验证输入的传真号码是否正确,继承text Tag。
mobile
显示一个类型为Text的Html Input框或输出一个显示文本,在作为Input框时,能够验证输入的移动电话号码是否正确,继承text Tag。
bankAccount
显示一个类型为Text的Html Input框或输出一个显示文本,在作为Input框时,能够验证输入的银行帐号是否正确,继承text Tag。
value
显示一个类型为Text的Html Input框或输出一个显示文本,在作为Input框时,能够在设定了最大值或最小值时,验证输入的数据是否在最大和最小值之间,继承text Tag。
formatValue
继承value Tag,加入格式化输出接口,不作为具体的Jsp Tag使用,只提供继承接口。
number
显示一个类型为Text的Html Input框或输出一个显示文本,在作为Input框时,能够验证输入的数据是否为数字,是否在给定的最大值和最小值之间,并能按照给定的格式进行输出显示,继承formatValue Tag。
date
显示一个类型为Text的Html Input框或输出一个显示文本,在作为Input框时,能够验证输入的数据是否为日期类型,是否为合理的日期,是否在给定的最大值和最小值之间,并能按照给定的格式进行输出显示,继承formatValue Tag。
displayTime
显示输出一个日期和时间的只读输入框或文本,继承date Tag。
creditCardExpiryDate
显示输出一个信用卡终止日期输入框,继承date Tag。
currency
显示一个类型为Text的Html Input框或输出一个显示文本,在作为Input框时,能够验证输入的数据是否为货币类型,是否在给定的最大值和最小值之间,并能按照给定的格式进行输出显示,继承formatValue Tag。
percent
显示一个类型为Text的Html Input框或输出一个显示文本,在作为Input框时,能够验证输入的数据是否为数字,是否在给定的最大值和最小值之间,并能按照给定的格式进行输出显示,作为百分数,在指定了value时,显示的值为value×100,页面提交时转换为value/100,继承number Tag。
unitNumber
显示一个类型为Text的Html Input框和一个计量单位名称或输出一个显示文本和一个计量单位名称,在作为Input框时,能够验证输入的数据是否为数字,是否在给定的最大值和最小值之间,并能按照给定的格式进行输出显示,继承number Tag。
weight
显示一个类型为Text的Html Input框和一个重量单位名称或输出一个显示文本和一个重量单位名称,在作为Input框时,能够验证输入的数据是否为数字,是否在给定的最大值和最小值之间,并能按照给定的格式进行输出显示,继承unitNumber Tag。
height
显示一个类型为Text的Html Input框和一个高度单位名称或输出一个显示文本和一个高度单位名称,在作为Input框时,能够验证输入的数据是否为数字,是否在给定的最大值和最小值之间,并能按照给定的格式进行输出显示,继承unitNumber Tag。
code
继承text Tag,加入codeLength属性,作为所有相关编码输入框或显示文本的父类,不作为具体的Jsp Tag使用,只提供继承接口。
documentCode
显示一个类型为Text的Html Input框或输出一个显示文本,在作为Input框时,能够验证输入的文档编码长度是否正确,编码类型是否正确,是否符合文档编码的校验规则,继承code Tag。
applyCode
显示一个类型为Text的Html Input框或输出一个显示文本,在作为Input框时,能够验证输入的applyCode的长度是否正确,类型是否正确,是否符合文档编码的校验规则,继承documentCode Tag。
policyCode
显示一个类型为Text的Html Input框或输出一个显示文本,在作为Input框时,能够验证输入的policyCode的长度是否正确,类型是否正确,是否符合文档编码的校验规则,继承documentCode Tag。
caseCode
显示一个类型为Text的Html Input框或输出一个显示文本,在作为Input框时,能够验证输入的caseCode的长度是否正确,类型是否正确,是否符合文档编码的校验规则,继承documentCode Tag。
changeCode
显示一个类型为Text的Html Input框或输出一个显示文本,在作为Input框时,能够验证输入的changeCode的长度是否正确,类型是否正确,是否符合文档编码的校验规则,继承documentCode Tag。
certiCode
显示一个类型为Text的Html Input框或输出一个显示文本,在作为Input框时,能够依据证件类型属性验证输入的证件编码是否正确,继承Text Tag。
hidden
输出一个类型为hidden的Html element,只有name和value两个属性,继承input Tag。
button
显示输出一个类型为button,submit或reset的Html Input框,即一个按钮, 继承input Tag。
textarea
显示输出一个多行文本框,继承input Tag。
creditCard
显示输出一个信用卡号输入框,继承input Tag。
select
显示输出一个下拉列表框,继承input Tag。
checkbox
显示输出一个复选框,继承input Tag。
radio
显示输出一个单选按钮,继承input Tag。
link
显示输出一个超链接文本,继承input Tag。
Input tagLibs中Tag之间的关系,如下面UML图所示:
如果要使用上面的Tag则须在JSP页面上用下面的形式引用该Tag库:
<%@ taglib uri="Field.tld" prefix="Field" %>
下面将分别列出以上所有Tag的属性及说明,其中在使用Tag时必须具有属性值的属性,其名称标为红色,其它为可选属性;
此Tag继承于Input Tag,在设置好它的属性后,在属性io设为“in”时,显示出一个类型为Text的Html Input框, 在属性io设为“out”时,显示出一个文本,它的具体属性说明见下表。
属性
数据类型
必填否
缺省值
定义
备注
name
String
N
文本输入框的名称
value
Object
N
文本框的当前值
notNull
boolean
N
false
该文本框是否为必填项
可选值true || false;
在页面提交时进行检查;
readOnly
Object
N
false
该文本框是否为只读状态
可选值true || false;
cssClass
String
N
textfiled
(main_en.css)
文本框的css类
用来设置文本框样式风格
size
int
N
20
文本框显示长度
maxLength
int
N
文本框允许输入的最大长度。
beforeBlur
String
N
离开文本框之前(在onblur之前)执行的Javascript代码
onblur
String
N
离开文本框时所要执行的事件
io
String
N
in
控制该Tag页面显示形式:
属性值为“in”时,作为输入框;
属性值为“out”时,作为输出文本。
可选值in || out;
在属性值设置为out时,上面所列针对文本框的属性,除value属性将作为显示内容外,其它属性设置均将无效。
nullMsg
String
N
文本不能为空时的提示信息
当Tag属性notNull=true且文本输入值为空时才会在提交检查时,提示该信息
redisplay
boolean
N
true
文本框的值是否要从form中自动取出
可选值true || false;
disabled
Object
N
false
文本框是否为可用状态
可选值true || false;
ondblclick
String
N
双击文本框时所要执行的事件
dValue
Object
N
文本框的默认值
errorMsg
String
N
当输入内容不正确时的提示信息。(只在text的子tag中有效,如email tag,date tag等)
需要输入Message Id
trimed
String
N
false
是否需要去除输入框中内容的左右空格
可选值true || false;
使用说明:在已引用该Tag库后,需要用下面所示的形式引用该Tag,
<Field:text name = “XXXX” value=”XXX” size=”XXX” …… />
示例:< Field:text name = “textname” value=”dvalue” size=”20” />
此Tag继承于Text Tag,在作为文本框显示输出时,将可以验证输入的电子邮箱是否正确;此Tag所有属性与Text Tag相同,具体说明请见Text Tag 属性列表。
使用说明:在已引用该Tag库后,需要用下面所示的形式引用该Tag,
< Field:email name = “XXXX” value=”XXX” size=”XXX” …… />
示例:< Field: email name = “emailname” value=”dvalue” size=” 20” />
此Tag继承于Text Tag,在作为文本框显示输出时,将可以验证输入的电话号码是否正确;此Tag所有属性与Text Tag相同,具体说明请见Text Tag 属性列表。
使用说明:在已引用该Tag库后,需要用下面所示的形式引用该Tag,
< Field:phone name = “XXXX” value=”XXX” size=”XXX” …… />
示例:< Field: phone name = “phonename” value=”dvalue” size=”20” />
此Tag继承于Text Tag,在作为文本框显示输出时,将可以验证输入的移动电话号码是否正确;此Tag所有属性与Text Tag相同,具体说明请见Text Tag 属性列表。
使用说明:在已引用该Tag库后,需要用下面所示的形式引用该Tag,
< Field: mobile name = “XXXX” value=”XXX” size=”XXX” …… />
示例:< Field: mobile name = “mobilename” value=”dvalue” size=”11” />
此Tag继承于Text Tag,在作为文本框显示输出时,将可以验证输入的银行帐号是否正确;此Tag所有属性与Text Tag相同,具体说明请见Text Tag 属性列表。
使用说明:在已引用该Tag库后,需要用下面所示的形式引用该Tag,
< Field: bankAccount name = “XXXX” value=”XXX” size=”XXX” …… />
示例:< Field: bankAccount name = “bankAccountname” value=”dvalue” size=”11” />
此Tag继承于Text Tag,在作为文本框显示输出时,将可以验证输入的数据是否在最大和最小值之间;此Tag属性包括Text Tag所有属性及下面表中所列的四个属性,Text Tag的属性具体说明请见Text Tag 属性列表。
属性
数据类型
必填否
缺省值
定义
备注
minValue
Object
N
文本框可以输入的最小值
如未设置即没有最小值的限制。
maxValue
Object
N
文本框可以输入的最大值
如未设置即没有最大值的限制。
minMsg
String
N
MSG_61629
当给定最小值后,value值小于最小值时指定的提示信息。
仅当设定了最小值时有效。
maxMsg
String
N
MSG_61630
当给定最大值后,value值大于最大值时指定的提示信息。
仅当设定了最大值时有效。
使用说明:在已引用该Tag库后,需要用下面所示的形式引用该Tag ,
< Field:value name = “XXXX” value=”XXX” size=”XXX” …… />
示例:< Field:value name = “valuename” value=”90” size=”20” minValue=”5” />
此Tag继承于FormatValue Tag(抽象类,继承于Value Tag),在作为文本框显示输出时,将可以验证输入的数据是否为数字,是否在给定的最大值和最小值之间,并能按照给定的格式进行输出显示;此Tag属性包括Text Tag所有属性和Value Tag中的属性,其中value和io属性与Text Tag中的含义或数据类型有所不同,将说明列于下面表中,该表还将列出两个与Value Tag中名称相同,但类型不同的属性,和一个新增属性,Text Tag的属性具体说明请见Text Tag 属性列表 ,Value Tag的属性说明请见Value Tag 属性列表。
属性
数据类型
必填否
缺省值
定义
备注
value
number
N
文本框的当前值
与TextTag中的value类型不同
io
String
N
in
控制该Tag页面显示形式:
属性值为“in”时,作为输入框;
属性值为“out”时,作为输出文本。
可选值in || out;
在属性值设置为out时,该Tag所列针对文本框的属性,除value属性将作为显示内容和format属性将作为显示格式外,其它属性设置均将无效;
与Text Tag中的io备注说明不同。
minValue
number
N
文本框可以输入的最小值
如未设置即没有最小值的限制。
maxValue
number
N
文本框可以输入的最大值
如未设置即没有最大值的限制。
format
String
N
设定输出数据的特定格式
showFormat
String
N
由通用参数配置决定
是否需要在页面中显示格式
可选值Y||N;
使用说明:在已引用该Tag库后,需要用下面所示的形式引用该Tag,
< Field:number name = “XXXX” value=”XXX” size=”XXX” …… />
示例:< Field:number name = “numbername” value=”123456” size=”20” format=”###,###” minValue =”100” />
此Tag继承于FormatValue Tag(抽象类,继承于Value Tag),在作为文本框显示输出时,将可以验证输入的数据是否为日期,是否在给定的最大值和最小值之间,并能按照给定的格式进行输出显示;此Tag属性包括Text Tag所有属性和Value Tag中的属性,其中value和io属性与Text Tag中的含义或数据类型有所不同,将说明列于下面表中,该表还将列出两个与Value Tag中名称相同,但类型不同的属性,和一个新增属性,Text Tag的属性具体说明请见Text Tag 属性列表 ,Value Tag的属性说明请见Value Tag 属性列表。
属性
数据类型
必填否
缺省值
定义
备注
value
Date or String
N
文本框的当前值
与TextTag中的value类型不同;
当设置默认值时,给定数据如为String类型时,其格式必须符合dd/MM/yyyy的样式.
io
String
N
in
控制该Tag页面显示形式:
属性值为“in”时,作为输入框;
属性值为“out”时,作为输出文本。
可选值in || out;
在属性值设置为out时,该Tag所列针对文本框的属性,除value属性将作为显示内容和format属性将作为显示格式外,其它属性设置均将无效;
与Text Tag中的io备注说明不同。
minValue
Date or String
N
文本框可以输入的最小值
如未设置即没有最小值的限制,且不能为空或空字符串;
当设置最小值时,给定数据如为String类型时,其格式必须符合dd/MM/yyyy的样式。
maxValue
Date or String
N
文本框可以输入的最大值
如未设置即没有最大值的限制,且不能为空或空字符串;
当设置最大值时,给定数据如为String类型时,其格式必须符合dd/MM/yyyy的样式。
format
String
N
dd/MM/yyyy
设定输出数据的特定格式
showFormat
String
N
由通用参数配置决定
是否需要在页面中显示格式
可选值Y||N;
使用说明:在已引用该Tag库后,需要用下面所示的形式引用该Tag,
< Field:date name = “XXXX” value=”XXX” size=”XXX” …… />
示例:<%
java.util.Date date = com.ebao.pub.util.DateUtils.toDate("20030306");
java.util.Date mindate = com.ebao.pub.util.DateUtils.toDate("20020501");
java.util.Date maxdate = com.ebao.pub.util.DateUtils.toDate("20300501");
%>
< Field:date name = “datename” value=”<%=date%>” size=”20” format=”yyyy-MM-dd”
minValue =” <%=mindate%>” maxValue = “<%=maxdate%>”/>
此Tag继承于FormatValue Tag(抽象类,继承于Value Tag),在作为文本框显示输出时,将可以验证输入的数据是否为货币类型,是否在给定的最大值和最小值之间,并能按照给定的格式进行输出显示;此Tag属性包括Text Tag所有属性和Value Tag中的属性,其中value和io属性与Text Tag中的含义或数据类型有所不同,将说明列于下面表中,该表还将列出两个与Value Tag中名称相同,但类型不同的属性,和两个新增属性,Text Tag的属性具体说明请见Text Tag 属性列表 ,Value Tag的属性说明请见Value Tag 属性列表 。
属性
数据类型
必填否
缺省值
定义
备注
value
Number
N
文本框的当前值
与TextTag中的value类型不同
io
String
N
in
控制该Tag页面显示形式:
属性值为“in”时,作为输入框;
属性值为“out”时,作为输出文本。
可选值in || out;
在属性值设置为out时,该Tag所列针对文本框的属性,除value属性将作为显示内容和format属性将作为显示格式外,其它属性设置均将无效;
与Text Tag中的io备注说明不同。
minValue
Number
N
文本框可以输入的最小值
如未设置即没有最小值的限制。
maxValue
Number
N
文本框可以输入的最大值
如未设置即没有最大值的限制。
format
String
N
设定输出数据的特定格式
moneyId
String
Y
指定当前货币的币种
showFormat
String
N
由通用参数配置决定
是否需要在页面中显示格式
可选值Y||N;
使用说明:在已引用该Tag库后,需要用下面所示的形式引用该Tag,
< Field:currency name = “XXXX” value=”XXX” size=”XXX” …… />
示例:< Field:currency name = “currencyname” value=” 562896” size=” 20” format=”###,###” minValue =” 10” />
此Tag继承于Nmuber Tag ,在作为文本框显示输出时,将可以验证输入的数据是否为数字,是否在给定的最大值和最小值之间,并能按照给定的格式进行输出显示,在显示的文本后可以跟随相应的单位;此Tag属性包括Nmuber Tag所有属性,在下面表中还将列出一个新增属性,Nmuber Tag的属性具体说明请见Number Tag 属性列表。
属性
数据类型
必填否
缺省值
定义
备注
unit
String
N
输入输出文本的单位名称
使用说明:在已引用该Tag库后,需要用下面所示的形式引用该Tag,
< Field:unitNumber name = “XXXX” value=”XXX” size=”XXX” …… />
示例:< Field: unitNumber name = “unitNumbername” value= “5689.698” size= “20” unit = “ ㎡ ” />
此Tag继承于UnitNumber Tag ,在作为文本框显示输出时,将可以验证输入的数据是否为数字,是否在给定的最大值和最小值之间,并能按照给定的格式进行输出显示,在显示的文本后可以跟随高度单位;此Tag属性包括UnitNumber Tag所有属性,但要求unit属性应设置为高度单位名称,UnitNumber Tag的属性具体说明请见UnitNumber Tag 属性列表。
使用说明:在已引用该Tag库后,需要用下面所示的形式引用该Tag,
< Field:height name = “XXXX” value=”XXX” size=”XXX” …… />
示例:< Field: height name = “heightname” value= “189” size= “20” unit = “cm ” />
此Tag继承于UnitNumber Tag ,在作为文本框显示输出时,将可以验证输入的数据是否为数字,是否在给定的最大值和最小值之间,并能按照给定的格式进行输出显示,在显示的文本后可以跟随重量单位;此Tag属性包括UnitNumber Tag所有属性,但要求unit属性应设置为重量单位名称,UnitNumber Tag的属性具体说明请见UnitNumber Tag 属性列表。
使用说明:在已引用该Tag库后,需要用下面所示的形式引用该Tag,
< Field:weight name = “XXXX” value=”XXX” size=”XXX” …… />
示例:< Field: weight name = “weightname” value= “50” size= “20” unit = “kg” />
此Tag继承于code Tag(抽象类,继承于Text Tag),在作为文本框显示输出时,将可以验证输入的文档编码长度是否正确,编码类型是否正确,是否符合文档编码的校验规则;此Tag属性包括所有Text Tag属性,在下面表中还将列出一个新增属性,Text Tag的属性具体说明请见Text Tag 属性列表。
属性
数据类型
必填否
缺省值
定义
备注
typeCode
String
Y
文档编码类型
该属性作为对输入的文档编码进行验证的类型判定依据。
errorMsg
String
N
文档编码输入错误时提示信息
需要输入Message Id
errorLenMsg
String
N
文档编码输入长度错误时的提示信息
需要输入Message Id
使用说明:在已引用该Tag库后,需要用下面所示的形式引用该Tag,
< Field: documentCode name = “XXXX” value=”XXX” size=”XXX” typeCode=”XXX”…/>
示例:< Field: documentCode name = “doccodename” size=” 20” typeCode=” 001” maxLength = “ 15” />
此Tag继承于DocumentCode Tag ,在作为文本框显示输出时,将可以验证输入的文档编码长度是否正确,编码类型是否正确,是否符合文档编码的校验规则;此Tag属性与Text Tag属性相同,具体说明请见Text Tag 属性列表。
使用说明:在已引用该Tag库后,需要用下面所示的形式引用该Tag,
< Field: applyCode name = “XXXX” value=”XXX” size=”XXX”…… />
示例:< Field: applyCode name = “applycodename” size=”20” maxLength = “15” />
此Tag继承于DocumentCode Tag ,在作为文本框显示输出时,将可以验证输入的文档编码长度是否正确,编码类型是否正确,是否符合文档编码的校验规则;此Tag属性与Text Tag属性相同,具体说明请见Text Tag 属性列表。
使用说明:在已引用该Tag库后,需要用下面所示的形式引用该Tag,
< Field: policyCode name = “XXXX” value=”XXX” size=”XXX”…… />
示例:< Field: policyCode name = “policycodename” size=”20” maxLength = “15” />
此Tag继承于DocumentCode Tag ,在作为文本框显示输出时,将可以验证输入的文档编码长度是否正确,编码类型是否正确,是否符合文档编码的校验规则;此Tag属性与Text Tag属性相同,具体说明请见Text Tag 属性列表。
使用说明:在已引用该Tag库后,需要用下面所示的形式引用该Tag,
< Field: caseCode name = “XXXX” value=”XXX” size=”XXX”…… />
示例:< Field: caseCode name = “casecodename” size=”20” maxLength = “15” />
此Tag继承于DocumentCode Tag ,在作为文本框显示输出时,将可以验证输入的文档编码长度是否正确,编码类型是否正确,是否符合文档编码的校验规则;此Tag属性与Text Tag属性相同,具体说明请见Text Tag 属性列表。
使用说明:在已引用该Tag库后,需要用下面所示的形式引用该Tag,
< Field: changeCode name = “XXXX” value=”XXX” size=”XXX”…… />
示例:< Field: changeCode name = “changecodename” size=”20” maxLength = “15” />
此Tag继承于Text Tag ,在作为文本框显示输出时,将可以依据输入框的证件类型来验证输入的编码是否正确;此Tag属性包括Text Tag所有属性及下面表中所列的一个属性,Text Tag的属性具体说明请见Text Tag 属性列表。
属性
数据类型
必填否
缺省值
定义
备注
typeField
String
N
other
设定文本框所输入的编码为哪一种证件类型,
可选值ID || other等;
除身份证(ID)外,其它类型证件号不作任何验证。
使用说明:在已引用该Tag库后,需要用下面所示的形式引用该Tag,
< Field: certiCode name = “XXXX” value=”XXX” size=”XXX” typeField=”XXX”…… />
示例:< Field: certiCode name = “certicodename” size=”20” maxLength = “15” typeField =”ID” />
此Tag继承于Nmuber Tag ,在作为文本框显示输出时,将可以验证输入的数据是否为数字,是否在给定的最大值和最小值之间,并能按照给定的格式进行输出显示, 作为百分数,在指定了value时,显示的值为value×100,页面提交时转换为value/100;此Tag属性包括Nmuber Tag所有属性其属性具体说明请见Number Tag 属性列表。
使用说明:在已引用该Tag库后,需要用下面所示的形式引用该Tag,
< Field:percent name = “XXXX” value=”XXX” size=”XXX” …… />
示例:< Field: percent name = “percent” value= “ 0.25” size= “10” ” />
此Tag继承于Input Tag,输出为一个html hidden元素,下面为该Tag的属性列表。
属性
数据类型
必填否
缺省值
定义
备注
name
String
N
文本输入框的名称
value
Object
N
文本框的当前值
使用说明:在已引用该Tag库后,需要用下面所示的形式引用该Tag,
< Field:hidden name = “XXXX” value=”XXX” />
示例:< Field: hidden name = “hiddenname” value=”dvalue” />
此Tag继承于Input Tag,显示输出一个类型为button,submit或reset的Html Input框,即一个按钮,下面为该Tag的属性列表。
属性
数据类型
必填否
缺省值
定义
备注
type
String
Y
Button 的类型
可选值submit || confirm || cancel || reset;
value
String
N
默认为button类型名称
Button的显示值
checkNotNull
boolean
N
按button类型确定,具体见备注
是否在点击按钮时进行输入值不能为空的检查
可选值true || false;
当type=submit和type=confirm时,该default值为true;
当type=cancel和type=reset时,该default值为true;
onclick
String
N
单击按钮事件
cssClass
String
N
button
(main_en.css)
按钮的Css样式单
disabled
Object
N
false
按钮是否为可用状态
可选值true || false;
name
String
N
Button的名称
使用说明:首先引用该Tag库,<%@ taglib uri=" Field.tld" prefix=" Field " %>
引用该Tag,< Field: button type=”XXX” cssClass=”XXX”…… />
示例:< Field: button type=”confirm” checkNotNull=”true” cssClass=”button 01” />
此Tag继承于Input Tag,输出一个多行文本框,下面为该Tag的属性列表。
属性
数据类型
必填否
缺省值
定义
备注
name
String
N
文本输入框的名称
notNull
boolean
N
false
该文本框是否为必填项
可选值true || false;
在页面提交时进行检查;
readOnly
Objects
N
false
该文本框是否为只读状态
可选值true || false;
cssClass
String
N
multi-textfiled
(main_en.css)
文本框的css类
用来设置文本框样式风格
cols
int
N
30
文本框显示列数
rows
int
N
5s
文本框显示行数
beforeBlur
String
N
离开文本框之前执行的事件。
onblur
String
N
离开文本框时所要执行的事件
nullMsg
String
N
文本不能为空时的提示信息
当Tag属性notNull=true且文本输入值为空时才会在提交检查时,提示该信息
redisplay
boolean
N
true
文本框的值是否要从form中自动取出
可选值true || false;
maxLength
int
N
文本框允许输入的最大长度。
dValue
Object
N
文本框的默认值
使用说明:首先引用该Tag库,<%@ taglib uri=" Field.tld" prefix=" Field " %>
引用该Tag,< Field: textarea name=”XXX” cssClass=”XXX”…… />value< /Field: textarea>
示例:< Field: textarea name=”areaname” />value< /Field: textarea>
此Tag继承于Input Tag,输出一个信用卡号输入框,下面为该Tag的属性列表。
属性
数据类型
必填否
缺省值
定义
备注
name
String
N
creditCard的名称
notNull
boolean
N
false
文本框是否为必填项
可选值true || false;
在页面提交时进行检查;
readOnly
Object
N
false
文本框是否为只读状态
可选值true || false;
cssClass
String
N
multi-textfiled
(main_en.css)
文本框的css类
用来设置文本框样式风格
value
Object
N
Credit card number
nullMsg
String
N
文本不能为空时的提示信息
当Tag属性notNull=true且文本输入值为空时才会在提交检查时,提示该信息
redisplay
boolean
N
true
信用卡号的值是否要从form中自动取出
可选值true || false;
dValue
Object
N
文本框的默认值
errorMsg
String
N
信用卡号输入错误时提示信息
需要输入Message Id
errorLenMsg
String
N
信用卡号输入长度错误时的提示信息
需要输入Message Id
使用说明:首先引用该Tag库,<%@ taglib uri=" Field.tld" prefix=" Field " %>
引用该Tag, <Field:creditCard name="credit" value="XXX"…… />
示例:<Field:creditCard name="credit" value="1234567890678909" />
此Tag继承于Input Tag,输出一个下拉列表框,下面为该Tag的属性列表。
属性
数据类型
必填否
缺省值
定义
备注
name
String
N
下拉列表框的名称
notNull
boolean
N
false
下拉列表框是否为必填项
可选值true || false;
在页面提交时进行检查;
onblur
String
N
离开下拉框时所要执行的事件
beforeBlur
String
N
离开下拉框之前(在onblur之前)执行的Javascript代码
onchange
String
N
所选项改变时执行的事件
size
int
N
下拉框的行数
muliple
boolean
N
false
是否可以进行多选
allOption
String
N
N
是否显示“所有”选项
可选值true||false,y||n
nullOption
String
N
N
是否显示“请选择”选项
可选值true||false,y||n
dataSrc
Collection
N
数据集合的元素可以是自定义的JavaBean对象或者HashMap对象
optionValue
String
N
下拉框选项的value,数据集合里值
表示方式 optionValue=”$value$”
optionText
String
N
下拉框选项的显示text,数据集合里值
表示方式 optionText=”$text$”
value
Object
N
下拉框当前选中值
nullMsg
String
N
下拉框不能为空时的提示信息
当Tag属性notNull=true且下拉框选项值为空时才会在提交检查时,提示该信息
redisplay
boolean
N
true
下拉框的值是否要从form中自动取出
可选值true || false;
disabled
Object
N
false
下拉框是否为可用状态
可选值true || false;
dValue
Object
N
下拉框的默认值
使用说明:首先引用该Tag库,<%@ taglib uri=" Field.tld" prefix=" Field " %>
引用该Tag, <Field:select name="select" dataSrc=”<%=XXX%>” optionValue=”XXX” optionText=”XXX”…… />
示例:<%
java.util.Collection c= new java.util.Vector();
java.util.HashMap hashtable = new java.util.HashMap();
hashtable.put("name","michael");
hashtable.put("age","27");
hashtable.put("sex","male1");
java.util.HashMap hashtable1 = new java.util.HashMap();
hashtable1.put("name","sun");
hashtable1.put("age","28");
hashtable1.put("sex","male2");
java.util.HashMap hashtable2 = new java.util.HashMap();
hashtable2.put("name","michael.sun");
hashtable2.put("age","29");
hashtable2.put("sex","male3");
c.add(hashtable);
c.add(hashtable1);
c.add(hashtable2);
%>
<Field:select name="selectone" dataSrc="<%=c%>" optionText="$name$-$age$" optionValue="$sex$" nullOption="true" allOption="true"/>
此Tag继承于Input Tag,输出一个复选框,下面为该Tag的属性列表。
属性
数据类型
必填否
缺省值
定义
备注
name
String
N
复选框的名称
onclick
boolean
N
在单击复选框时执行的事件
disabled
Object
N
false
复选框是否为不可用状态
可选值true || false;
cssClass
String
N
复选框的css类
用来设置复选框样式风格
value
Object
N
复选框的值
checked
boolean
N
false
复选框是否为选中状态
可选值true || false;
redisplay
boolean
N
true
复选框的值是否要从form中自动取出
可选值true || false;
dValue
Object
N
复选框的默认值
使用说明:首先引用该Tag库,<%@ taglib uri=" Field.tld" prefix=" Field " %>
引用该Tag, <Field:checkbox name="XXX" value="XXX" οnclick="XXX"…… />
示例:<Field:checkbox name="checkbox" οnclick="alert(‘Isok’); " checked="true" />
此Tag继承于Input Tag,输出一个单选按钮,下面为该Tag的属性列表。
属性
数据类型
必填否
缺省值
定义
备注
name
String
N
单选按钮的名称
onclick
boolean
N
在单击单选按钮时执行的事件
disabled
Object
N
false
单选按钮是否为不可用状态
可选值true || false;
cssClass
String
N
单选按钮的css类
用来设置复选框样式风格
value
Object
N
单选按钮的值
checked
boolean
N
false
单选按钮是否为选中状态
可选值true || false;
redisplay
boolean
N
true
单选按钮的值是否要从form中自动取出
可选值true || false;
checkedValue
String
N
一组单选按钮中被选中的值
dValue
Object
N
一组单选按钮中默认被选中的值
使用说明:首先引用该Tag库,<%@ taglib uri=" Field.tld" prefix=" Field " %>
引用该Tag, <Field:radio name="XXX" value="XXX" οnclick="XXX"…… />
示例:<Field:radio name="radio" οnclick="alert(‘Isok’); " checked="true" />
此Tag继承于Input Tag,输出一个超链接文本,下面为该Tag的属性列表。
属性
数据类型
必填否
缺省值
定义
备注
name
String
N
超链接tag的名称
onclick
String
N
在单击超链接文本时执行的事件
href
String
N
链接地址
cssClass
String
N
超链接文本的css类
用来设置复选框样式风格
target
String
N
决定链接源在什么地方显示
用户自定义的名字或_blank,_parent,_self,_top
使用说明:首先引用该Tag库,<%@ taglib uri=" Field.tld" prefix=" Field " %>
引用该Tag, <Field:link href="XXX" οnclick="XXX" target="XXX"…… >linktext
</Field:link>
示例:<Field:link href="test.htm" οnclick="alert();" target="_self" >goto
</Field:link>
此Tag继承于Date Tag,输出两个文本框,第一个表示月份,第二个表示年份,下面为该Tag的属性列表。
属性
数据类型
必填否
缺省值
定义
备注
name
String
N
Tag名称
value
Object
N
Tag的当前值
notNull
boolean
N
false
该Tag框是否为必填项
可选值true || false;
在页面提交时进行检查;
readOnly
Object
N
false
文本框是否为只读状态
可选值true || false;
cssClass
String
N
textfiled
(main_en.css)
文本框的css类
用来设置文本框样式风格
size
int
N
20
文本框显示长度
minValue
Date or String
N
系统当前时间
期限的最小值
当设置最小值时,给定数据如为String类型时,其格式必须符合dd/MM/yyyy的样式。
minMsg
String
N
MSG_61629
当给定最小值后,value值小于最小值时指定的提示信息。
仅当设定了最小值时有效。
nullMsg
String
N
文本不能为空时的提示信息
当Tag属性notNull=true且文本输入值为空时才会在提交检查时,提示该信息
redisplay
boolean
N
true
Tag值是否要从form中自动取出
可选值true || false;
disabled
Object
N
false
文本框是否为不可用状态
可选值true || false;
dValue
Object
N
文本框的默认值
errorMonthMsg
String
N
信息用卡终止月份输入错误时提示信息
需要输入Message Id
errorYearMsg
String
N
信息用卡终止年份输入错误时的提示信息
需要输入Message Id
使用说明:首先引用该Tag库,<%@ taglib uri=" Field.tld" prefix=" Field " %>
引用该Tag, <Field:creditCardExpiryDate name=XXX" value="XXX" ……/>
示例:<Field:creditCardExpiryDate name="expiryDate" value=" 01/06/2005 " />
此Tag继承于Text Tag,在作为文本框显示输出时,将可以验证输入的人物名称是否正确;此Tag所有属性与Text Tag相同,具体说明请见Text Tag 属性列表。
使用说明:在已引用该Tag库后,需要用下面所示的形式引用该Tag,
< Field:personName name = “XXXX” value=”XXX” size=”XXX” …… />
示例:< Field: personName name = “personname” value=”dvalue” size=” 20” />
此Tag继承于Text Tag,在作为文本框显示输出时,将可以验证输入的传真号码是否正确;此Tag所有属性与Text Tag相同,具体说明请见Text Tag 属性列表。
使用说明:在已引用该Tag库后,需要用下面所示的形式引用该Tag,
< Field:fax name = “XXXX” value=”XXX” size=”XXX” …… />
示例:< Field: fax name = “faxname” value=”dvalue” size=” 20” />
此Tag继承于date Tag,显示输出一个日期和时间的只读输入框或文本;此Tag所有属性与date Tag相同,具体说明请见date Tag 属性列表。
使用说明:在已引用该Tag库后,需要用下面所示的形式引用该Tag,
< Field:displayTime name = “XXXX” value=”XXX” size=”XXX” …… />
示例:< Field: displayTime name = “disDate” value=”dvalue” size=” 20” />
该taglibs包括两个Tag,分别为多语言支持Tag和代码表使用Tag,实现语言国际化。
Tag Name
Description
CodeTable
在页面上显示一个文本框和下拉框,里面包含相应的代码表数据
如果是文本框,在第一个文本框输入代码后会在第二个文本框显示相应的描述
如果是下拉框,在下拉框中包含了所有的代码
StrRes
用于支持系统多语言的实现
属性
数据类型
必填否
缺省值
定义
备注
name
String
Y
Html输入域(文本框或下拉框)名称
不能为空
tableName
String
Y
代码表名称
不能为空
value
String
N
当前选择代码值
style
String
N
TEXTBOX_AND_DROPDOWN
显示样式
LABEL = 文本输出
ONE_DROPDOWN = 一个下拉框
TWO_TEXTBOX = 两个文本框
MULTI_LINE_DROPDOWN = 一个多行下拉框
ONE_TEXTBOX = 一个文本框
TEXTBOX_AND_DROPDOWN = 一个文本框+一个下拉框
ONE_DESC_TEXTBOX = 一个只读文本框,显示代码描述
注意:当style为ONE_DROPDOWN或TEXTBOX_AND_DROPDOWN时,所选code table要显示的记录条数必须小于100条,否则将不被允许使用这种style ,并抛出异常。
当style为ONE_DROPDOWN, MULTI_LINE_DROPDOWN时该select元素将默认包含在下面这个span元素中:
<span style="overflow:hidden; position:absolute; border:1px solid # 7F 9DB9"></span>
descStyle
String
N
数据显示款式
仅适用style= ONE_DROPDOWN时
CODE = 仅显示Code
DESC = 仅显示 Desc (default)
CODE_AND_ DESC = 显示code-desc
size
int
N
文本框页面显示长度或者多行下拉框的显示行数
descSize
int
N
代码描述框显示长度
只有在style = TWO_TEXTBOX时才有效
props
String
N
文本框默认属性定义
Tag中未定义的属性在此说明
allOption
boolean
N
N
是否显示“所有”选项
适用于下拉框
nullOption
boolean
N
N
是否显示“请选择”选项
适用于下拉框
notNull
boolean
N
false
是否可以为空
nullMsg
String
N
文本不能为空时的提示信息
当Tag属性notNull=true且文本输入值为空时才会在提交检查时,提示该信息
readOnly
boolean
N
false
是否为只读状态
onblur
String
N
用户定义的onblur属性
whereClause
String
N
对代码表进行筛选的where条件
beforeBlur
String
N
离开代码框之前(在onblur之前)执行的Javascript代码
onChange
String
N
当选中文本发生改变时执行的事件
redisplay
boolean
N
true
codetable tag的值是否要从form中自动取出
可选值true || false;
cssClass
String
N
textfiled
(main_en.css)
文本框的css样式风格
只在style为ONE_DESC_TEXTBOX时有效
toUpperCase
String
N
N||false
是否将输入代码转换成大写字母
可选值true||fasle,Y||N
notExistMsg
String
N
t_code表中NOT_EXIST_MSG_ID字段值
当代码不存在时的提示信息
disabled
String
N
false
下拉框是否为不可用状态
可选值true || false;
maxLength
int
N
文本框允许输入的最大长度。
dValue
Object
N
Codetable tag的默认值
isCtrlDeadLock
String
N
false
是否需要在页面上控制死锁问题
可选值true || false;
使用说明:首先引用该Tag库,<%@ taglib uri="Field.tld" prefix=" Field " %>
引用该Tag, < Field: codeTable name="XXX" tableName="XXX"……/>
示例:<Field:codeTable name="CN_code" tableName="TN_code" style="TWO_TEXTBOX" size="2" value="1" />
更多请参考:http://team2.geldev.ebaodev.com/ls/ls/demo/tag/field/CodeTable.jsp
注意:当该代码表中的代码值与ID值不同或代码需要根据不同国家进行转换时,对codetable tag赋值,取值和需要获得焦点时需要通过公共的javascript方法进行:
a. 赋值方法,setCodeValue(codeTagName,value) 无返回值,
codeTagName-->需要赋值的codetable tag 的名称;
value-->给coddtable tag所赋的value值
b. 取值方法,getCodeValue(codeTagName) 返回codetable tag的code值,
codeTagName-->需要取值的codetable tag 的名称
当需要取得codetable tag的code Id值时可真接使用codetable元素的value值
c. 获得焦点方法,setCodeFocus(codeTagName) 无返回值,
codeTagName-->需要取值的codetable tag 的名称
属性
数据类型
必填否
缺省值
定义
备注
id
String
Y
需要实现语言转换的String
使用说明:首先引用该Tag库,<%@ taglib uri="StrRes.tld" prefix="StrRes" %>
引用该Tag, <StrRes:strRes id="XXX" />
示例:<StrRes:strRes id="msg_0008" />
该taglibs包括三个Tag,分别为页面设置Tag,分页Tag和防止页面重复提交的Tag,具体说明如下表。
Tag Name
Description
pageConfig
用来设置页面的标题,页眉和页脚信息。
navigator
设置分页导航条所需的属性来支持分页功能。
PageToken
用来防止页面重复提交。
下面将分别列出以上所有Tag的属性及说明,其中在使用Tag时必须具有属性值的属性,其名称标为红色,其它为可选属性;
属性
数据类型
必填否
缺省值
定义
备注
title
String
N
页面标题
输入值应为str_id
topStyle
int
N
NORMAL
页眉风格
可选值NONE || NORMAL;
如不显示页眉取值NONE;
如正常显示页眉取值NORMAL;
bottomStyle
int
N
NORMAL
页脚风格
可选值NONE || NORMAL;
如不显示页脚取值NONE;
如正常显示页脚取值NORMAL;
onload
String
N
加载页面时执行的事件
bodyId
String
N
页面中body的ID值
使用说明:首先引用该Tag库,<%@ taglib uri="PageConfig.tld" prefix="PageConfig" %>
在已引用该Tag库后,需要用下面所示的形式引用该Tag,
< PageConfig: pageConfig title=”XXX” topStyle=”XXX” bottomStyle =”XXX”/>
示例:< PageConfig: pageConfig title=”titlename” topStyle=” NONE” bottomStyle =” NONE”/>
属性
数据类型
必填否
缺省值
定义
备注
formName
String
Y
该标签所在的FORM
type
String
N
为分页导航条的样式
目前支持两种:
按扭型:type='button';//未用
文本型 type='text'
默认情况下type='text'
totalSize
int
Y
记录总数
pageSize
int
Y
每页的记录数
pageNo
int
Y
当前页码
forward
String
N
查询提交的action
使用说明:首先引用该Tag库,<%@ taglib uri=" MultiPage.tld" prefix=" MultiPage " %>
在已引用该Tag库后,需要用下面所示的形式引用该Tag,
<MultiPage:navigator totalSize ="XXX" pageSize="XXX" pageNo="XXX" formName="XXX" type="XXX" forward=”XXX.do”> </ MultiPage:navigator>
示例:
<%@ taglib uri="/WEB-INF/ MultiPage .tld" prefix=" MultiPage " %>
<%@ page contentType="text/html;charset=GBK" language="java" %>
<html>
<head>
<title>page table is run </title>
</head>
<body>
<form name="form1" method=get>
< MultiPage:navigator totalSize ="239"
pageSize="<%=(request.getParameter("pagesize")==null)?"20":request.getParameter("pagesize")%>"
pageno="<%=(request.getParameter("pageno")==null)?"1":request.getParameter("pageno")%>"
formName="form1" type="button">
</ MultiPage:navigator>
</form>
</body>
</html>
显示效果:
无属性
使用说明: 首先引用该Tag库,<%@ taglib uri="PageToken.tld" prefix="PageToken" %>
在已引用该Tag库后,需要用下面所示的形式引用该Tag ,注意该Tag必须放在一个form 里使用
<PageToken:PageToken />
示例:<form name="form1" method="post" action="">
<PageToken:PageToken />
</form>
该taglibs包括两个Tag,一个用来设置表整体属性,一个用来设置表中列属性,具体说明如下表。
Tag Name
Description
table
用来设置表格的整体属性,如样式及数据集等。
column
用来设置表格中每一列的显示属性。
如果要使用上面的Tag则须在JSP页面上用下面的形式引用该Tag库:
<%@ taglib uri="DataTable.tld" prefix=" DataTable " %>
通常这两个Tag同进使用,完成表格的输出,下面将分别列出上面两个Tag的属性及说明,其中在使用Tag时必须具有属性值的属性,其名称标为红色,其它为可选属性;
属性
数据类型
必填否
缺省值
定义
备注
cssClass
String
N
表格在css样式里的名称
dataSrc
Collection
N
数据集合的元素可以是自定义的JavaBean对象或者HashMap对象
width
String
N
表格的宽度
align
String
N
表格的对齐方式
border
String
N
0
表格边框线粗细
cellspacing
String
N
1
单元格间距,也就是内外边框线的间距
cellpadding
String
N
3
单元格边距,即单元格内内容与内边框的距离
bgcolor
String
N
#FFFFFF
表格背景色
trClass
String
N
td5
(main_en.css)
表格列表中每一行的样式类
headClass
String
N
td4
(main_en.css)
表格中表头一行的样式类
disableHead
String
N
不显示表头
disableHead=”true”
isDisHead
String
N
false
当查不到记录时是否显示表头
可选值true||false
nullMsg
String
N
MSG_3906
当查不到记录时需要显示的提示信息
只有当isDisHead=”false”时才会显示信息
使用说明:由于需要与column Tag结合使用,请见下面column Tag的使用说明。
示例:由于需要与column Tag结合使用,请见下面column Tag的示例。
属性
数据类型
必填否
缺省值
定义
备注
head
String
N
表头的显示值
输入值要查询数据库,它的返回是表头的显示
href
String
N
表示一个超级联结
表示方式
show_user_detail.do?id=$tel$&name=$name$&page=1
align
String
N
列的对齐方式
type
String
N
radio 显示一个radio框
checkbox显示一个checkbox框
code 显示一个特定的code值需要和tableName一起使用
field 可以嵌套我们自己的field 的tag
checkedValue
String
N
是否选中
当type=”radio”配合使用
可以是一个固定值也可以是数据集合里的值
表示方式checkedValue =”xxx”
当checkedValue和value一样时radio和radio被选中
详细可以看范例
checked
String
N
是否选中
当type=”checkbox” 配合使用
是数据集合里的值
表示方式checked =”$xxx$”
当checked为boolean型的true或为”Y”时checkbox被选中
false或”N”时 不选中
详细可以看范例
value
String
N
数据集合里值
表示方式 value=”$xxxx$”
width
String
N
列宽
height
String
N
列高
format
String
N
单元格值的格式
如日期和数字类型
format=” ##0.##”
tableName
String
N
要查询的code表的名称
当type=”code”和它配合使用
name
String
N
特定类型的名称
当type=”radio”
当type=”checkbox” 配合使用
c
详细可以看范例
enable
String
N
当type=radio
或checkbox时
传入enable=”fasle” 时 整列的chenckbox或radio 都无法使用,默认为”true”
或传入数据集合里的值
enable=”$key$”
当enable为boolean型的false或为”N”时 radio ,checkbox可以使用
当enable为boolean型的true或为”y”时 radio ,checkbox不可以使用
详细可以看范例
cssClass
String
N
该列在css样式里的名称
仅当对该列的样式有特殊需求时,才需要设置此属性
使用说明:在已引用该Tag库后,需要用下面所示的形式引用该Tag,
< DataTable:table dataSrc="XXX" cssClass="XXX" width="XXX" align="XXX" >
< DataTable:column head="XXX" value="$XXX$" width="XXX" align="XXX" …… />
…….
……
…….
</ DataTable:table>
示例:
<DataTable:table dataSrc="<%=c%>" cssClass="table1" width="100%" align="center" >
<DataTable:column head="name" value="$name$" width="100" align="center" />
<DataTable:column head="href" value="$tel$" width ="100" href="show_user_detail.do?id=$tel$&name=$name$&page=1"/>
<DataTable:column head="radio" value="$name$" type="radio" name="radio" width ="100" checkedValue="michael"/>
<DataTable:column head="checkbox" name="checkbox_$name$" type="checkbox" value="$name$" checked="$check$" width ="100" />
<DataTable:column head="tel" value="$tel$" width ="100" />
<DataTable:column head="date" value="$date$" width ="100" />
<DataTable:column head="num" value="$num$" width ="100" />
<DataTable:column head="Status" type="code" value="1" tableName="T_POLICY_CHG_STATUS" width ="28%" align="center"/>
<DataTable:column head="other" type="field" width="100">
<Field:hidden name="$num$_$num$" value="$num$" />
<Field:text name="$num$_$num$" value="$num$" />
</DataTable:column>
<DataTable:column head="hidden input" type="field" width="100">
<Field:hidden name="$num$_$num$" value="$num$" />
</DataTable:column>
<DataTable:column head="sex" value="$sex$--$name$" width ="100" align="center" />
</DataTable:table>
显示效果:
该taglibs包括五个Tag,具体说明如下表。
Tag Name
Description
isNull
用来判断给定值是否为null,如果为null将显示tag中包含的内容,否则将不显示。
isNotNull
用来判断给定值是否不为null,如果不为null将显示tag中包含的内容,否则将不显示。
isEmpty
用来判断给定值是否为空字符,如果为空字符将显示tag中包含的内容,否则将不显示。
isNotEmpty
用来判断给定值是否不为空字符,如果不为空字符将显示tag中包含的内容,否则将不显示。
equal
用来判断给定的两个值是否相等,如果相等将显示tag中包含的内容,否则将不显示。
此Tag用来判断给定值是否为null,如果为null将显示tag中包含的内容,否则将不显示,具体属性如下:
属性
数据类型
必填否
缺省值
定义
备注
name
String
N
该tag名称
value
String
Y
需要进行逻辑判断的给定值
使用说明:首先引用该Tag库,<%@ taglib uri="Logic.tld" prefix="logic" %>
在已引用该Tag库后,需要用下面所示的形式引用该Tag,
< Logic: isNull name=”XXX” value=”XXX” >display content</Logic:isNull>
示例:<DataTable:table dataSrc="<%=c%>" cssClass="table1" width="100%" align="center" >
<DataTable:column head="test" type="field">
<Logic:isNull value="$somevalue$">
<Field:radio name="radio" checked="true" />
</Logic:isNull>
</DataTable:column>
</DataTable:table>
此Tag继承于isNull Tag,用来判断给定值是否不为null,如果不为null将显示tag中包含的内容,否则将不显示;此Tag所有属性与isNull Tag相同,具体说明请见isNull Tag 属性列表。
使用说明:首先引用该Tag库,<%@ taglib uri="Logic.tld" prefix="logic" %>
在已引用该Tag库后,需要用下面所示的形式引用该Tag,
< Logic: isNotNull name=”XXX” value=”XXX” >display content</Logic:isNotNull>
示例:<DataTable:table dataSrc="<%=c%>" cssClass="table1" width="100%" align="center" >
<DataTable:column head="test" type="field">
<Logic:isNotNull value="$somevalue$">
<Field:radio name="radio" checked="true" />
</Logic:isNotNull>
</DataTable:column>
</DataTable:table>
此Tag用来判断给定值是否为空字符,如果为空字符将显示tag中包含的内容,否则将不显示,具体属性如下:
属性
数据类型
必填否
缺省值
定义
备注
name
String
N
该tag名称
value
String
Y
需要进行逻辑判断的给定值
使用说明:首先引用该Tag库,<%@ taglib uri="Logic.tld" prefix="logic" %>
在已引用该Tag库后,需要用下面所示的形式引用该Tag,
< Logic: isEmpty name=”XXX” value=”XXX” >display content</Logic:isEmpty>
示例:<DataTable:table dataSrc="<%=c%>" cssClass="table1" width="100%" align="center" >
<DataTable:column head="test" type="field">
<Logic:isEmptyl value="$somevalue$">
<Field:radio name="radio" checked="true" />
</Logic:isEmpty>
</DataTable:column>
</DataTable:table>
此Tag继承于isEmptyTag,用来判断给定值是否不为空字符,如果不为空字符将显示tag中包含的内容,否则将不显示;此Tag所有属性与isEmptyTag相同,具体说明请见isEmpty Tag 属性列表。
使用说明:首先引用该Tag库,<%@ taglib uri="Logic.tld" prefix="logic" %>
在已引用该Tag库后,需要用下面所示的形式引用该Tag,
< Logic: isNotEmpty name=”XXX” value=”XXX” >display content</Logic: isNotEmpty >
示例:<DataTable:table dataSrc="<%=c%>" cssClass="table1" width="100%" align="center" >
<DataTable:column head="test" type="field">
<Logic: isNotEmpty value="$somevalue$">
<Field:radio name="radio" checked="true" />
</Logic: isNotEmpty >
</DataTable:column>
</DataTable:table>
此Tag用来判断给定的两个值是否相等,如果相等将显示tag中包含的内容,否则将不显示,具体属性如下:
属性
数据类型
必填否
缺省值
定义
备注
name
String
N
该tag名称
value
String
Y
需要进行逻辑判断的一个给定值
variable
String
Y
需要进行逻辑判断的一个给定值
使用说明:首先引用该Tag库,<%@ taglib uri="Logic.tld" prefix="logic" %>
在已引用该Tag库后,需要用下面所示的形式引用该Tag,
< Logic:equal name=”XXX” value=”XXX” variable=”XXX” >display content</Logic:equal >
示例:<DataTable:table dataSrc="<%=c%>" cssClass="table1" width="100%" align="center" >
<DataTable:column head="test" type="field">
<Logic:equal value="$somevalue$" variable=”othervalue”>
<Field:radio name="radio" checked="true" />
</Logic:equal >
</DataTable:column>
</DataTable:table>
使用上面介绍的textarea tag,codeTable tag及text taglib中的所有tag均可以实现自动从formBean中取值的功能,如果确定所用tag必须从formbean中取值,需要注意以下几点:
a. 引用此tag时必须指定name这一属性,并且其name要和formbean中对应的属性名称相一致;
b. 当在formbean中未取到值时,又要加入一个指定的默认值,可以设定dValue这个属性的值;
c. 不要指定value这个属性,由于tag取值的优选级是先取设定的value值,所以如果设定了value值,tag将不会去自动取值而是会将设定的默认值显示出来;
示例:可以自动取值的tag引用:< Field:text name = “propertyName” size=”20” />
设了默认值后自动取值的tag引用:< Field:text name = “propertyName” dValue=”defaultValue” size=”20” />
可以显示默认值的tag引用:< Field:text name = “textname” value=”dvalue” size=”20” />
使用date tag时,format格式dd/MM/yyyy中的月应为大写,即MM而不是mm,小写的m代表分钟
需要对输入值进行不能为空的检查时,可以将tag中的 notNull属性设为true,并与button tag 结合使用,将button tag中属性checkNotNull设为true,如不想使用button tag则可以在button中的onclick事件中直接使用javascript公共方法checkNotNull().
javascript方法说明请见http://team2.geldev.ebaodev.com/ls/demo/JavascriptFunctionGuide.htm
如:<Field:text name=”test” value=”test” οnblur=”getValue(‘<%=name%>’);”/>
这样会出现错误,当遇到这种情况请按照下面的方法修改,
<%
String str1=”getValue(‘”;
String str2=”’);”;
String str = str1+name+str2;
%>
<Field:text name=”test” value=”test” οnblur=’<%=str%>’ />
这样使这段字符串成为一段完整的服务端代码就可以使用了。