JSF标签使用参考手册(内部资料)

1        前言

1.1           文档目的<o:p></o:p>

该文档旨在为中心界面开发工作组提供一套完整的JSF控件使用说明书。

1.2           文档范围<o:p></o:p>

本文档列出界面开发小组在开发过程中需要使用的基本JSF控件，包括：

l     控件描述

l     控件使用的语法

l     各控件标签及常用属性在JSP文件中的使用范例

l     标签风格

l     使用说明

1.3           目标读者<o:p></o:p>

本文的主要读者为界面开发小组成员或其他对JSF感兴趣的开发人员。

2        控件说明

2.1           <h:dataTable>控件<o:p></o:p>

2.1.1    控件描述

显示一个数据表格。

2.1.2    截图

<v:shapetype id="_x0000_t75" stroked="f" filled="f" path="m@4@5l@4@11@9@11@9@5xe" o:preferrelative="t" o:spt="75" coordsize="21600,21600"><v:stroke joinstyle="miter"></v:stroke><v:formulas><v:f eqn="if lineDrawn pixelLineWidth 0"></v:f><v:f eqn="sum @0 1 0"></v:f><v:f eqn="sum 0 0 @1"></v:f><v:f eqn="prod @2 1 2"></v:f><v:f eqn="prod @3 21600 pixelWidth"></v:f><v:f eqn="prod @3 21600 pixelHeight"></v:f><v:f eqn="sum @0 0 1"></v:f><v:f eqn="prod @6 1 2"></v:f><v:f eqn="prod @7 21600 pixelWidth"></v:f><v:f eqn="sum @8 21600 0"></v:f><v:f eqn="prod @7 21600 pixelHeight"></v:f><v:f eqn="sum @10 21600 0"></v:f></v:formulas><v:path o:connecttype="rect" gradientshapeok="t" o:extrusionok="f"></v:path><o:lock aspectratio="t" v:ext="edit"></o:lock></v:shapetype><v:shape id="_x0000_i1025" style="WIDTH: 314.25pt; HEIGHT: 272.25pt" type="#_x0000_t75"><v:imagedata o:title="" src="file:///C:\DOCUME~1\Owner\LOCALS~1\Temp\msohtml1\01\clip_image001.png"></v:imagedata></v:shape>

2.1.3    例子代码

<h:dataTable id="data"<o:p></o:p> styleClass="standardTable"<o:p></o:p> headerClass="standardTable_Header"<o:p></o:p> footerClass="standardTable_Header"<o:p></o:p> rowClasses="standardTable_Row1,standardTable_Row2"<o:p></o:p> columnClasses="standardTable_Column,standardTable_ColumnCentered,standardTable_Column"<o:p></o:p> var="country"<o:p></o:p> value="#{countryList.countries}"<o:p></o:p> preserveDataModel="true" > <f:facet name="header"> <h:outputText value="List of Available Characters"/> </f:facet> <h:column> <f:facet name="header"> <h:outputText value="Name"/> </f:facet> <h:outputText value="#{country.name}"/> </h:column><o:p></o:p> </h:dataTable>

2.1.4    属性列表

属性<o:p></o:p>	数据类型<o:p></o:p>	描述<o:p></o:p>	是否必须修改<o:p></o:p>
id	String	此属性是组件标识符。此属性的值在当前JSP页面中要求是唯一的。	否
styleClass	String	对应的样式文件的样式名称	否
Var	String	数据集名称，用于显示行内容的时候使用	否
value	String	数据集来源	是

注：是否必须修改是说明此值在JSP页面中是否必须修改，视具体情况具体分析，下同。

2.1.5    使用说明

每一个列的数据邦定，需要修改<h:column></h:column>中邦定的值，以及栏名称<o:p></o:p>

<h:column>
<f:facet name="header">                                 
<h:outputText value="Name"/>            //这一栏的名称是“Name”
</f:facet>
<h:outputText value="#{country.name}"/>   //这一栏邦定的内容
</h:column><o:p></o:p>

2.2           <h: inputText>控件<o:p></o:p>

2.2.1    控件描述

显示一个输入框，用于接收用户输入的数据，并可以邦定到bean的变量中

2.2.2    截图

<v:shape id="_x0000_i1026" style="WIDTH: 150pt; HEIGHT: 25.5pt" type="#_x0000_t75"><v:imagedata o:title="无标题" src="file:///C:\DOCUME~1\Owner\LOCALS~1\Temp\msohtml1\01\clip_image003.gif"></v:imagedata></v:shape>

2.2.3    例子代码

<h:inputText id="number1" value="#{calcForm.number1}" maxlength="10" size="25" required="true" styleClass="editor"><o:p></o:p>

<o:p> </o:p>

2.2.4    属性列表

属性<o:p></o:p>	数据类型<o:p></o:p>	描述<o:p></o:p>	是否必须修改<o:p></o:p>
id	String	此属性是组件标识符。此属性的值在当前JSP页面中要求是唯一的。	否
styleClass	String	对应的样式文件的样式名称	否
maxlength	String	最大长度，超过限定长度就无法输入	否
value	String	邦定到BEAN中的值	否
required	String	是否必须输入内容，只要ture和false两种属性，需要配合message使用	否
size	String