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

评论

18 楼 newlife 2007-06-23  

[e-mail]  谢谢

17 楼 huanghero0663 2007-06-20  

javachs 写道

jsf貌似是鸡肋.

此话怎讲？

16 楼 javachs 2007-06-20  

jsf貌似是鸡肋.

15 楼 bruce198 2007-06-19  

[e-mail]
偶也想要...

14 楼 coolstone 2007-06-03  

[e-mail]
谢谢!

13 楼 dhxyu 2007-06-02  

[e-mail]

thank you very much!!!

12 楼 sara2007 2007-06-01  

[e-mail]
请发给我一份,谢谢

11 楼 huanghero0663 2007-05-07  

唉，楼主好像不是很厚道，根本就没发～～！！

10 楼 ljx0305 2007-05-07  

我也要，我的邮箱地址是[e-mail]
谢谢了

9 楼 mgjava 2007-05-07  

[e-mail]
刚开始研究JSF，急需啊!谢了！

8 楼 抛出异常的爱 2007-04-27  

BUG。。。。

7 楼 cary 2007-04-27  

LZ给我发一份好吗？谢谢 [e-mail]

6 楼 huanghero0663 2007-04-25  

楼主发一份给我啦，我等了很久还是没有音信啊
谢谢了！[e-mail]

5 楼 yxw820816 2007-04-25  

我也要，多谢了，[e-mail]

4 楼 lulu0324 2007-04-08  

救星啊 [e-mail] 谢谢

3 楼 huanghero0663 2007-03-24  

[e-mail] 麻烦发一份给我，谢谢：P

2 楼 cwscwj 2007-02-08  

[e-mail] 发份给我，谢谢，互相交流并提高

1 楼 dev_liu 2007-01-10  

这个网站需要完善的地方很多哟.如果谁要这些资料.把email留下吧.