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 例子代码
|
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 例子代码
|
<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 | 对应的样式文件的样式名称 | 否 |
| String | 最大长度,超过限定长度就无法输入 | 否 |
value | String | 邦定到BEAN中的值 | 否 |
| String | 是否必须输入内容,只要ture和false两种属性,需要配合message使用 | 否 |
| String |