TAG
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。 |
1.1 Input tagLibs Tag UML图
Input tagLibs中Tag之间的关系，如下面UML图所示：
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 = “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继承于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” />
1.2.16 CaseCode Tag
此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” />
1.2.17 ChangeCode Tag
此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” />
1.2.18 CertiCode Tag
此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” />
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,
示例：
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,
示例：<%
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);
%>
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,
示例：
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,
示例：
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,
:link>
示例：
: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,
示例：
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元素中：
|
| 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"……/>
示例：
更多请参考：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 的名称
2.2.2 StrRes Tag
| 属性 |
数据类型 |
必填否 |
缺省值 |
定义 |
备注 |
| id |
String |
Y |
|
需要实现语言转换的String |
|
使用说明：首先引用该Tag库，<%@ taglib uri="StrRes.tld" prefix="StrRes" %>
引用该Tag,
示例：
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 |