TAG

    技术2022-05-11  66

    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

    显示一个类型为TextHtml Input框或输出一个显示文本,继承input Tag

    personName

    显示一个人物名称输入框,继承text Tag

    email

    显示一个类型为TextHtml Input框或输出一个显示文本,在作为Input框时,能够验证输入的电子邮箱是否正确,继承text Tag

    phone

    显示一个类型为TextHtml Input框或输出一个显示文本,在作为Input框时,能够验证输入的电话号码是否正确,继承text Tag

    fax

    显示一个类型为TextHtml Input框或输出一个显示文本,在作为Input框时,能够验证输入的传真号码是否正确,继承text Tag

    mobile

    显示一个类型为TextHtml Input框或输出一个显示文本,在作为Input框时,能够验证输入的移动电话号码是否正确,继承text Tag

    bankAccount

    显示一个类型为TextHtml Input框或输出一个显示文本,在作为Input框时,能够验证输入的银行帐号是否正确,继承text Tag

    value

    显示一个类型为TextHtml Input框或输出一个显示文本,在作为Input框时,能够在设定了最大值或最小值时,验证输入的数据是否在最大和最小值之间,继承text Tag

    formatValue

    继承value Tag,加入格式化输出接口,不作为具体的Jsp Tag使用,只提供继承接口。

    number

    显示一个类型为TextHtml Input框或输出一个显示文本,在作为Input框时,能够验证输入的数据是否为数字,是否在给定的最大值和最小值之间,并能按照给定的格式进行输出显示,继承formatValue Tag

    date

    显示一个类型为TextHtml Input框或输出一个显示文本,在作为Input框时,能够验证输入的数据是否为日期类型,是否为合理的日期,是否在给定的最大值和最小值之间,并能按照给定的格式进行输出显示,继承formatValue Tag

    displayTime

    显示输出一个日期和时间的只读输入框或文本,继承date Tag

    creditCardExpiryDate

    显示输出一个信用卡终止日期输入框,继承date Tag

    currency

    显示一个类型为TextHtml Input框或输出一个显示文本,在作为Input框时,能够验证输入的数据是否为货币类型,是否在给定的最大值和最小值之间,并能按照给定的格式进行输出显示,继承formatValue Tag

    percent

    显示一个类型为TextHtml Input框或输出一个显示文本,在作为Input框时,能够验证输入的数据是否为数字,是否在给定的最大值和最小值之间,并能按照给定的格式进行输出显示,作为百分数,在指定了value时,显示的值为value×100,页面提交时转换为value/100,继承number Tag

    unitNumber

    显示一个类型为TextHtml Input框和一个计量单位名称或输出一个显示文本和一个计量单位名称,在作为Input框时,能够验证输入的数据是否为数字,是否在给定的最大值和最小值之间,并能按照给定的格式进行输出显示,继承number Tag

    weight

    显示一个类型为TextHtml Input框和一个重量单位名称或输出一个显示文本和一个重量单位名称,在作为Input框时,能够验证输入的数据是否为数字,是否在给定的最大值和最小值之间,并能按照给定的格式进行输出显示,继承unitNumber Tag

    height

    显示一个类型为TextHtml Input框和一个高度单位名称或输出一个显示文本和一个高度单位名称,在作为Input框时,能够验证输入的数据是否为数字,是否在给定的最大值和最小值之间,并能按照给定的格式进行输出显示,继承unitNumber Tag

     

    code

    继承text Tag,加入codeLength属性,作为所有相关编码输入框或显示文本的父类,不作为具体的Jsp Tag使用,只提供继承接口。

    documentCode

    显示一个类型为TextHtml Input框或输出一个显示文本,在作为Input框时,能够验证输入的文档编码长度是否正确,编码类型是否正确,是否符合文档编码的校验规则,继承code Tag

    applyCode

    显示一个类型为TextHtml Input框或输出一个显示文本,在作为Input框时,能够验证输入的applyCode的长度是否正确,类型是否正确,是否符合文档编码的校验规则,继承documentCode Tag

    policyCode

    显示一个类型为TextHtml Input框或输出一个显示文本,在作为Input框时,能够验证输入的policyCode的长度是否正确,类型是否正确,是否符合文档编码的校验规则,继承documentCode Tag

    caseCode

    显示一个类型为TextHtml Input框或输出一个显示文本,在作为Input框时,能够验证输入的caseCode的长度是否正确,类型是否正确,是否符合文档编码的校验规则,继承documentCode Tag

    changeCode

    显示一个类型为TextHtml Input框或输出一个显示文本,在作为Input框时,能够验证输入的changeCode的长度是否正确,类型是否正确,是否符合文档编码的校验规则,继承documentCode Tag

    certiCode

    显示一个类型为TextHtml Input框或输出一个显示文本,在作为Input框时,能够依据证件类型属性验证输入的证件编码是否正确,继承Text Tag

    hidden

    输出一个类型为hiddenHtml element,只有namevalue两个属性,继承input Tag

    button

    显示输出一个类型为button,submitresetHtml 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 tagLibsTag之间的关系,如下面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”时,显示出一个类型为TextHtml 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中的属性,其中valueio属性与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中的属性,其中valueio属性与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中的属性,其中valueio属性与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,submitresetHtml Input,即一个按钮,下面为该Tag的属性列表。

      

    属性

    数据类型

    必填否

    缺省值

    定义

    备注

    type

    String

    Y

     

    Button 的类型

    可选值submit || confirm || cancel || reset

    value

    String

    N

    默认为button类型名称

    Button的显示值

     

    checkNotNull

    boolean

    N

    button类型确定,具体见备注

    是否在点击按钮时进行输入值不能为空的检查

    可选值true || false

    type=submittype=confirm时,default值为true

    type=canceltype=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 = 一个只读文本框,显示代码描述

    注意:当styleONE_DROPDOWNTEXTBOX_AND_DROPDOWN时,所选code table要显示的记录条数必须小于100条,否则将不被允许使用这种style ,并抛出异常。

     

    styleONE_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样式风格

    只在styleONE_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 tagcode值,

                           codeTagName-->需要取值的codetable tag 的名称

                           当需要取得codetable tagcode 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

     

    页面中bodyID

     

     

    使用说明:首先引用该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>

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

     

     

           显示效果:  

     

    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”

    checkedValuevalue一样时radioradio被选中

    详细可以看范例

    checked

    String

    N

     

    是否选中

    type=checkbox 配合使用

    是数据集合里的值

    表示方式checked =$xxx$”

    checkedboolean型的true或为Ycheckbox被选中

    falseN 选中

    详细可以看范例

    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 整列的chenckboxradio 都无法使用,默认为true”

    或传入数据集合里的值

    enable=”$key$”

    enableboolean型的false或为N radio ,checkbox可以使用

    enableboolean型的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 tagtext 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 tagformat属性的格式

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

     

     

    最新回复(0)