jsf基础标签的使用

1      基础标签

1.1      <f:view>

1.1.1控件描述

JSP页面中所有标签和组件必须在<f: view></f: view>这中间使用才能够在输出网页中正常显示

1.1.2例子代码

<f:view></f:view>

 

1.2      <f:subview>

1.2.1控件描述

在jsf页面内，所有HTML代码必须放在<f: subview> </f: subview>中间才能够正常显示

1.2.2例子代码

<f:subview>HTML代码</f:subview>

1.3      <f:loadBundle>

1.3.1控件描述

这个控件邦定一个参数文件，它获取 ResourceBundle 并将其装载到 Map 中，然后将其存储到请求领域的命名空间中，这样使得用同一机制在模型层中访问数据所得到的信息是有效的。

1.3.2例子代码

<f:loadBundle basename="demo.resources" var="bundle" />

1.3.3属性列表

属性	数据类型	描述	是否必须
basename	String	表示资源包的路径，这里并不需要指明具体的Locale，而只需要给出默认属性文件的路径。 此例邦定的文件位于myfaces-examples/WEB-INF/ resources .properties	是
value	String	表示在页面中引用资源包时用的变量	是

1.4      <h:message>

1.4.1控件描述

显示错误提示，当监控的内容提交时前端检查是否符合要求

1.4.2截图

1.4.3例子代码

<h:message for="password" styleClass="err"/>

1.4.4属性列表

属性	数据类型	描述	是否必须
id	String	此属性是组件标识符。此属性的值在当前JSP页面中要求是唯一的。	是
styleClass	String	对应的样式文件的样式名称	否
for	String	监控那个值的变动	是

1.5      <h:messages>

1.5.1控件描述

显示错误提示，和messages类似，但是它是一个全局错误信息，整个网页任何地方不符合要求都将出错。它是没有for属性的。

1.5.2截图

1.5.3例子代码

<h:messages id="messageList" styleClass="err"/>

1.5.4属性列表

属性	数据类型	描述	是否必须
id	String	此属性是组件标识符。此属性的值在当前JSP页面中要求是唯一的。	是
styleClass	String	对应的样式文件的样式名称	否

1.6      <h:graphicImage>

1.6.1控件描述

显示一个图片

1.6.2例子代码

<h:graphicImage url="images/arrow-first.gif" border="1" />

1.6.3属性列表

属性	数据类型	描述	是否必须
id	String	此属性是组件标识符。此属性的值在当前JSP页面中要求是唯一的。	是
styleClass	String	对应的样式文件的样式名称	否
url	String	图片地址	是
Value	String	当图片无法显示时显示的文字	是

1.7      <h:outputText>

1.7.1控件描述

显示一个输出文本，可以从bean中获取变量。

1.7.2截图

1.7.3例子代码

<h:outputText value="#{Controller.number2ValidationLabel}"/>

1.7.4属性列表

属性	数据类型	描述	是否必须
id	String	此属性是组件标识符。此属性的值在当前JSP页面中要求是唯一的。	否
styleClass	String	对应的样式文件的样式名称	否
value	String	显示BEAN中的值	是

1.8      <h:dataTable>

1.8.1控件描述

显示一个数据表格。

1.8.2截图

1.8.3例子代码

<h:dataTable id="data" styleClass="standardTable" headerClass="standardTable_Header" footerClass="standardTable_Header" rowClasses="standardTable_Row1,standardTable_Row2" columnClasses="standardTable_Column,standardTable_ColumnCentered,standardTable_Column" var="country" value="#{countryList.countries}" 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> </h:dataTable>

1.8.4属性列表

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

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

1.8.5使用说明

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

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

1.9      <x:dataScroller>

1.9.1控件描述

这是myfaces的控件。主要是用来控制数据集的导航，需要配合其它数据显示使用。这里是为for=”data”的控制服务。

1.9.2截图

1.9.3例子代码

<x:dataScroller id="scroll_1"         for="data"         fastStep="10"         pageCountVar="pageCount"         pageIndexVar="pageIndex"         styleClass="scroller"         paginator="true"         paginatorMaxPages="9"         paginatorTableClass="paginator"         paginatorActiveColumnStyle="font-weight:bold;"         >     <f:facet name="first" >         <h:commandButton styleClass="button_dateset" value="9" />     </f:facet>     <f:facet name="fastforward">         <h:commandButton styleClass="button_dateset" value="8"/>     </f:facet>     <f:facet name="previous">         <h:commandButton styleClass="button_dateset" value="3"/>     </f:facet>     <f:facet name="next">         <h:commandButton styleClass="button_dateset" value="4"/>     </f:facet>     <f:facet name="fastrewind">         <h:commandButton styleClass="button_dateset" value="7"/>     </f:facet>     <f:facet name="last">         <h:commandButton styleClass="button_dateset" value=":"/>     </f:facet> </x:dataScroller>

1.9.4属性列表

属性	数据类型	描述	是否必须
id	String	此属性是组件标识符。此属性的值在当前JSP页面中要求是唯一的。	是
for	String	对应的数据显示集，也就是这个导航为那个集合服务	是
fastStep	String	每次向下滚动行数	是
pageCountVar	String	当前数据集的总页数	否
pageIndexVar	String	当前页面	否
paginator	String	是否显示快捷页码，ture或者false	否
paginatorMaxPages	String	每页最多显示快捷页码的数目	否
firstRowIndexVar	String	本页第一行在整个数据集中的序号	否
lastRowIndexVar	String	本页第一行在整个数据集中的序号	否

1.9.5使用说明

这是一个数据控制组件，所以它必须与一个数据表格对应（例如dataTable）

1.10  <h:inputText>

1.10.1            控件描述

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

1.10.2            截图

1.10.3            例子代码

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

 

1.10.4            属性列表

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

1.11  <h:inputTextarea >

1.11.1            控件描述

显示一个文本输入域，用于接收用户的输入，和inputText不同的是它可以输入多行，而inputText只能够输入一行。

1.11.2            截图

1.11.3            例子代码

<h:inputTextarea id="text" rows="5" value="#{q_form.text}" required="true" />

1.11.4            属性列表

属性	数据类型	描述	是否必须
id	String	此属性是组件标识符。此属性的值在当前JSP页面中要求是唯一的。	否
styleClass	String	对应的样式文件的样式名称	否
required	String	是否必须输入内容，只要ture和false两种属性，需要配合message使用	否
value	String	邦定的数据集	是
rows	String	文本输入域最大行数	否

1.12  <h:inputSecret >

1.12.1            控件描述

提供一个密码输入框，当输入数据的时候显示“*”，并可以把内容传递到bean中的变量。一些属性可以参考INPUTTEXT。

1.12.2            截图

1.12.3            例子代码

<h:inputSecret id="password" value="#{userBean['password']}" required="true" styleClass="editor"/>

1.12.4            属性列表

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

1.13  <x:inputCalendar >

1.13.1            控件描述

这是myfaces的日历控件。

1.13.2            截图

1.13.3            例子代码

<x:inputCalendar monthYearRowClass="yearMonthHeader" weekRowClass="weekHeader"                     currentDayCellClass="currentDayCell" renderAsPopup="true"                     popupTodayString="Today" popupWeekString="Week" popupDateFormat="yyyy-MM-dd"/>

1.13.4            属性列表

属性	数据类型	描述	必需
id	String	此属性是组件标识符。此属性的值在当前JSP页面中要求是唯一的。	是
monthYearRowClass	String	月份选项样式	否
weekRowClass	String	周份选项样式	否
currentDayCellClass	String	当前日期选项样式	否
renderAsPopup	String	是否显示上面截图的日历菜单选项	否
popupTodayString	String	如果显示日历菜单，今天日期的提示	否
popupWeekString	String	如果显示日历菜单，周的提示	否
popupDateFormat	String	显示的日期样式，这里有bug，所以不建议大家修改，定为“yyyy-MM-dd”	否

1.13.5            使用说明

因为需要自动把javascript导入到前台页面，所以必须在web.xml文件</web-app>前增加下面：

    <filter-mapping>

        <filter-name>extensionsFilter</filter-name>

        <url-pattern>/faces/*</url-pattern>

</filter-mapping>

1.14  <h:inputHidden >

1.14.1            控件描述

提供一个隐藏输入框，主要用于一些参数传递，但是又不需要给客户看到。

1.14.2            截图

它是一个隐藏输入框，在前台只有HTML代码，但是没有显示。

1.14.3            例子代码

<h:inputHidden value="#{treeBacker.setopen}"/>

1.14.4            属性列表

属性	数据类型	描述	是否必须
id	String	此属性是组件标识符。此属性的值在当前JSP页面中要求是唯一的。	否
value	String	绑定bean的变量	是

1.15  <h:selectOneMenu>

1.15.1            控件描述

这个控件是从下拉菜单中选择一个选项。数据来源可以是一项一项的，也可以是数据集。

1.15.2            截图

1.15.3            例子代码

<h:selectOneMenu id="oneoption" value="#{q_form.quoteChar}" > <f:selectItem itemValue="" itemLabel="#{example_messages['sample2_select_quote']}" />  <f:selectItem itemValue="/"" itemLabel="Double" />  <f:selectItem itemValue="'" itemLabel="Single" />  <f:selectItems value="#{q_form.selectOneItems}" /> </h:selectOneMenu>

1.15.4            属性列表

属性	数据类型	描述	是否必须
id	String	此属性是组件标识符。此属性的值在当前JSP页面中要求是唯一的。	否
value	String	这是selectOneMenu的value，下拉菜单的提示语言，比如“请选择年龄”等	是
itemValue	String	每一项下拉菜单的值	是
itemLabel	String	每一项下拉显示出来给用户看的内容	是
Value	String	这是selectItems的value，这是一个数据集	是

1.15.5            使用说明

selectItem表示是一项，selectItems表示数量来源是value，这个SelectItem是List 或者 array数据类型。

1.16  <h:selectOneRadio>

1.16.1            控件描述

您可以使用 SelectOneRadio 来显示一个单选按钮选择集合。您可以包含一组单选选项和嵌套的选项组。

1.16.2            截图

1.16.3            例子代码

<h:selectOneRadio    layout="pageDirection"    required="true"    value="#{modelBean.firstSelection}">     <f:selectItems      value="#{modelBean.allCharactersToSelect}" />   </h:selectOneRadio>

1.16.4            属性列表

属性	数据类型	描述	是否必须
id	String	此属性是组件标识符。此属性的值在当前JSP页面中要求是唯一的。	是
styleClass	String	对应的样式文件的样式名称	否
Layout	String	排列方式，此处是垂直排列	否
itemValue	String	每一项菜单的值	是
itemLabel	String	每一项显示出来给用户看的内容	是
Value	String	这是selectItems的value，这是一个数据集	是

1.16.5            使用说明

selectItem表示是一项，selectItems表示数量来源是value，这个SelectItem是List 或者 array数据类型。

1.17  <h:selectOneListbox>

1.17.1            控件描述

您可以使用 selectOneListbox来显示多项下拉菜单。但是只能够选择一项。

1.17.2            截图

1.17.3            例子代码

<h:selectOneListbox id="oneoption" value="#{q_form.quoteChar}" >     <f:selectItem itemValue="" itemLabel="#{example_messages['sample2_select_quote']}" />     <f:selectItem itemValue="/"" itemLabel="Double" />     <f:selectItem itemValue="'" itemLabel="Single" />     <f:selectItems value="#{q_form.selectOneItems}" /> </h:selectOneListbox>

1.17.4            属性列表

属性	数据类型	描述	是否必须
id	String	此属性是组件标识符。此属性的值在当前JSP页面中要求是唯一的。	是
styleClass	String	对应的样式文件的样式名称	否
itemValue	String	每一项菜单的值	是
itemLabel	String	每一项显示出来给用户看的内容	是
Value	String	这是selectItems的value，这是一个数据集	是

1.17.5            使用说明

selectItem表示是一项，selectItems表示数量来源是value，这个SelectItem是List 或者 array数据类型。

1.18  <h:selectManyListbox>

1.18.1            控件描述

您可以使用 selectManyListbox来同时显示多个选项表格框。并可以选择多项。

1.18.2            截图

1.18.3            例子代码

<h:selectManyListbox id="oneoption" value="#{q_form.quoteChar}" size="5">     <f:selectItems value="#{q_form.selectOneItems}" /> </h:selectManyListbox>

1.18.4            属性列表

属性	数据类型	描述	是否必须
id	String	此属性是组件标识符。此属性的值在当前JSP页面中要求是唯一的。	是
styleClass	String	对应的样式文件的样式名称	否
itemValue	String	每一项菜单的值	否
itemLabel	String	每一项显示出来给用户看的内容	否
selectItems	String	数据集来源，参考selectItems	否
Value	String	这是selectItems的value，这是一个数据集	否

1.18.5            使用说明

selectItem表示是一项，selectItems表示数量来源是value，这个SelectItem是List 或者 array数据类型。

1.19  <h:selectBooleanCheckbox>

1.19.1            控件描述

显示一个选择。它只有两个返回值false和true。

1.19.2            截图

1.19.3            例子代码

<h:selectBooleanCheckbox value="#{LibMag.remove}"/>

1.19.4            属性列表

属性	数据类型	描述	是否必须
id	String	此属性是组件标识符。此属性的值在当前JSP页面中要求是唯一的。	否
Value	String	邦定到bean中的变量	是

1.20  <f:selectItems>

1.20.1            控件描述

从一个list或者arraylist中导入选项数据。需要配合selectOneMenu或者selectOneListbox等使用。

1.20.2            例子代码

<h:selectOneListbox id="oneoption" value="#{q_form.quoteChar}" >     <f:selectItem itemValue="" itemLabel="#{example_messages['sample2_select_quote']}" />     <f:selectItem itemValue="/"" itemLabel="Double" />     <f:selectItem itemValue="'" itemLabel="Single" /> <f:selectItems value="#{q_form.selectOneItems}" /> </h:selectOneListbox>

1.20.3            属性列表

属性	数据类型	描述	是否必须
value	list	邦定backingbean的数据集	是

1.20.4            使用说明

需要配合selectOneMenu或者selectOneListbox等使用。

1.21  <h:outputLink>

1.21.1            控件描述

显示一个链接控件，显示文本需要适用outputText

1.21.2            截图

1.21.3            例子代码

<h:outputLink value="http://www.baidu.com" target="_new">        <h:outputText value="go to baidu page"/> </h:outputLink>

1.21.4            属性列表

属性	数据类型	描述	是否必须
id	String	此属性是组件标识符。此属性的值在当前JSP页面中要求是唯一的。	否
Target	String	打开链接的目标窗口	否
value	String	需要链接到的地址	是

1.22  <h:commandButton>

1.22.1            控件描述

显示一个提交按钮，可以直接提交到bean的方法中

1.22.2            截图

1.22.3            例子代码

<h:commandButton id="button1" value="#{msgs['login']}" action="#{userBean.checkPassword}" styleClass="button"/>

1.22.4            属性列表

属性	数据类型	描述	是否必须
id	String	此属性是组件标识符。此属性的值在当前JSP页面中要求是唯一的。	是
styleClass	String	对应的样式文件的样式名称	否
value	String	显示出来的按钮名称	是
action	String	是一个动作，提交到bean中的方法	是

1.23  <h:commandLink>

1.23.1            控件描述

显示一个提交标签，这个标签和commandButton不同，它可以是一个文本框，需要结合actionListener使用。actionListener用于监听提交，并不是一定需要的。

1.23.2            截图

1.23.3            例子代码

<h:commandLink id="href1" action="none">   <h:outputText value="#{example_messages['sample1_add_link']}"/>   <f:actionListener type="org.apache.myfaces.examples.example1.CalcActionListener" ></f:actionListener> </h:commandLink>

1.23.4            属性列表

属性	数据类型	描述	是否必须
id	String	此属性是组件标识符。此属性的值在当前JSP页面中要求是唯一的。	否
action	String	是一个动作，提交到bean中的方法	是

1.24  <x:updateActionListener>

1.24.1            控件描述

提供一个隐藏输入框，主要用于一些参数传递，但是又不需要给客户看到。

1.24.2            截图

一个事件监听标签，也是用于参数传递。这个标签的特点是传递到的地方和来源是不一样的属性。

1.24.3            例子代码

<x:updateActionListener property="#{branchTree.tree}" value="#{node}" />

1.24.4            属性列表

属性	数据类型	描述	是否必须
property	String	要传递到后台bean的变量	是
value	String	数据来源。	是

 

1.25  <x:jscookMenu>

1.25.1            控件描述

jscookMenu作用是显示一个menu导航菜单，它是myfaces的一个控件，数据可以在bean中配置

1.25.2            截图

1.25.3            例子代码

<x:jscookMenu layout="hbr" theme="ThemeOffice" >                      <x:navigationMenuItems id="nav_5" value="#{Menu.infoItems}" /> </x:jscookMenu>

1.25.4            属性列表

属性	数据类型	描述	是否必须
id	String	此属性是组件标识符。此属性的值在当前JSP页面中要求是唯一的。	是
theme	String	对应的样式名称，可选项为ThemeIE ThemeMiniBlack ThemeOffice ThemePanel	是
navigationMenuItems	String	数据集来源，参考selectItems	是
Value	String	这是selectItems的value，这是一个数据集	是
layout	String	相当于menu的别名	否

1.25.5            使用说明

navigationMenuItem表示是一项，navigationMenuItems表示数量来源是value，这个navigationMenuItems是List 或者 ArrayList数据类型。