TAG

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。
email	显示一个类型为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。

1.2 Input taglibs Tag属性列表

如果要使用上面的Tag则须在JSP页面上用下面的形式引用该Tag库：

<%@ taglib uri="Field.tld" prefix="Field" %>

下面将分别列出以上所有Tag的属性及说明，其中在使用Tag时必须具有属性值的属性，其名称标为红色，其它为可选属性；

1.2.1 Text 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” />

1.2.2 Email Tag

此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” />

1.2.3 P hone Tag

此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” />

1.2.4 Mobile Tag

此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” />

1.2.5 BankAccount Tag

此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” />

1.2.6 Value Tag

此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” />

1.2.7 Number Tag

此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” />

1.2.8 Date Tag

此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%>”/>

1.2.9 Currency Tag

此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” />

1.2.10 UnitNumber Tag

此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 = “ ㎡ ” />

1.2.11 Height Tag

此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 ” />

1.2.12 Weight Tag

此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” />

1.2.13 DocumentCode Tag

此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” />

1.2.14 A pplyCode Tag

此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” />

1.2.15 P olicyCode Tag

使用说明：在已引用该Tag库后，需要用下面所示的形式引用该Tag,

< Field: policyCode name = “XXXX” value=”XXX” size=”XXX”…… />

示例：< Field: policyCode name = “policycodename” size=”20” maxLength = “15” />

1.2.16 CaseCode Tag

使用说明：在已引用该Tag库后，需要用下面所示的形式引用该Tag,

< Field: caseCode name = “XXXX” value=”XXX” size=”XXX”…… />

示例：< Field: caseCode name = “casecodename” size=”20” maxLength = “15” />

1.2.17 ChangeCode Tag

使用说明：在已引用该Tag库后，需要用下面所示的形式引用该Tag,

< Field: changeCode name = “XXXX” value=”XXX” size=”XXX”…… />

示例：< Field: changeCode name = “changecodename” size=”20” maxLength = “15” />

1.2.18 CertiCode Tag

此Tag继承于Text Tag ，在作为文本框显示输出时，将可以依据输入框的证件类型来验证输入的编码是否正确；此Tag属性包括Text Tag所有属性及下面表中所列的一个属性，Text Tag的属性具体说明请见Text Tag 属性列表。

属性

数据类型

必填否

缺省值

定义

备注

typeField

String

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” />

1.2.19 P ercent Tag

此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” ” />

1.2.20 Hidden Tag

此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” />

1.2.21 Button Tag

此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” />

1.2.22 Textarea Tag

此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>

1.2.23 CreditCard Tag

此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" />

1.2.24 Select Tag

此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"/>

1.2.25 Checkbox Tag

此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" />

1.2.26 Radio Tag

此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" />

1.2.27 Link Tag

此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>

1.2.28 CreditCardExpiryDate Tag

此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 " />

1.2.29 P ersonName Tag

此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” />

1.2.30 Fax Tag

此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” />

1.2.31 DisplayTime Tag

此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” />

2. I18n taglibs简介

该taglibs包括两个Tag，分别为多语言支持Tag和代码表使用Tag，实现语言国际化。

Tag Name

Description

CodeTable

在页面上显示一个文本框和下拉框，里面包含相应的代码表数据

如果是文本框，在第一个文本框输入代码后会在第二个文本框显示相应的描述

如果是下拉框，在下拉框中包含了所有的代码

StrRes

用于支持系统多语言的实现

2.1 I18n taglibsTag类图

2.2 I18n taglibs Tag属性列表

2.2.1 CodeTable tag

属性	数据类型	必填否	缺省值	定义	备注
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" />

注意：当该代码表中的代码值与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 的名称

2.2.2 StrRes Tag

属性	数据类型	必填否	缺省值	定义	备注
id	String	Y		需要实现语言转换的String

使用说明：首先引用该Tag库，<%@ taglib uri="StrRes.tld" prefix="StrRes" %>

引用该Tag, <StrRes:strRes id="XXX" />

示例：<StrRes:strRes id="msg_0008" />

3. page taglibs简介

该taglibs包括三个Tag，分别为页面设置Tag，分页Tag和防止页面重复提交的Tag，具体说明如下表。

Tag Name	Description
pageConfig	用来设置页面的标题，页眉和页脚信息。
navigator	设置分页导航条所需的属性来支持分页功能。
PageToken	用来防止页面重复提交。

3.1 page taglibs tag类图

3.2 page taglibs tag属性列表

下面将分别列出以上所有Tag的属性及说明，其中在使用Tag时必须具有属性值的属性，其名称标为红色，其它为可选属性；

3.2.1 pageConfig 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”/>

3.2.2 navigator Tag

属性	数据类型	必填否	缺省值	定义	备注
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>

< 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>

显示效果：

3.2.3 pageToken Tag

无属性

使用说明: 首先引用该Tag库，<%@ taglib uri="PageToken.tld" prefix="PageToken" %>

在已引用该Tag库后，需要用下面所示的形式引用该Tag ，注意该Tag必须放在一个form 里使用

<PageToken:PageToken />

示例：<form name="form1" method="post" action="">

<PageToken:PageToken />

</form>

4. table taglibs简介

该taglibs包括两个Tag，一个用来设置表整体属性，一个用来设置表中列属性，具体说明如下表。

Tag Name	Description
table	用来设置表格的整体属性，如样式及数据集等。
column	用来设置表格中每一列的显示属性。

4.1 table taglibs tag类图

4.2 table taglibs tag属性列表

如果要使用上面的Tag则须在JSP页面上用下面的形式引用该Tag库：

<%@ taglib uri="DataTable.tld" prefix=" DataTable " %>

通常这两个Tag同进使用，完成表格的输出，下面将分别列出上面两个Tag的属性及说明，其中在使用Tag时必须具有属性值的属性，其名称标为红色，其它为可选属性；

4.2.1 table 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的示例。

4.2.2 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>

显示效果：

5. logic taglibs简介

该taglibs包括五个Tag，具体说明如下表。

Tag Name	Description
isNull	用来判断给定值是否为null，如果为null将显示tag中包含的内容，否则将不显示。
isNotNull	用来判断给定值是否不为null，如果不为null将显示tag中包含的内容，否则将不显示。
isEmpty	用来判断给定值是否为空字符，如果为空字符将显示tag中包含的内容，否则将不显示。
isNotEmpty	用来判断给定值是否不为空字符，如果不为空字符将显示tag中包含的内容，否则将不显示。
equal	用来判断给定的两个值是否相等，如果相等将显示tag中包含的内容，否则将不显示。

5.1 logic taglibs tag类图

5.2 logic taglibs tag属性列表

5.2.1 isNull 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>

5.2.2 isNotNull Tag

此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>

5.2.3 isEmpty Tag

此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>

5.2.4 isNotEmpty Tag

此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>

5.2.5 equal Tag

此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>

FAQ(常见问题解答)

Note1:使用Ebao Tag自动从FormBean取值方法

使用上面介绍的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” />

Note2: date tag中format属性的格式

使用date tag时，format格式dd/MM/yyyy中的月应为大写，即MM而不是mm,小写的m代表分钟

Note3: 检查页面中输入值不能为空的方法

需要对输入值进行不能为空的检查时，可以将tag中的 notNull属性设为true,并与button tag 结合使用，将button tag中属性checkNotNull设为true，如不想使用button tag则可以在button中的onclick事件中直接使用javascript公共方法checkNotNull().

Note4: 页面自定义的html元素及javascript方法名称不能与tag中已存在javascript方法名称相同,否则会出错

javascript方法说明请见http://team2.geldev.ebaodev.com/ls/demo/JavascriptFunctionGuide.htm

Note5: JSP Tag中的属性值不能为服务端代码和客户端代码混合组成

如：<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%>’ />

这样使这段字符串成为一段完整的服务端代码就可以使用了。

Note6: 如果遇到tag class not found错误,请先重启服务，之后如还存在问题请联系foundation组

limitever

关注

0
点赞
踩
0

收藏

觉得还不错? 一键收藏
0
评论
TAG

1. Input Tag taglibs 简介... 21.1 Input tagLibs Tag UML图... 41.2 Input taglibs Tag属性列表... 61.2.1 Text Tag. 61.2.2 Email Tag. 71.2.3 Phone Tag. 71.2.4 Mobile Tag. 71.2.5 BankAccount Tag.
复制链接

扫一扫