JSF标签1

本文均为整理，源于：http://www.zhiweinet.com/jsf/

outputFormat
　　产生指定的文字讯息，可以搭配<f:param>来设定讯息的参数以格式化文字讯息，例如

<f:view>
<h:form>
<f:loadBundle basename="msg" var="msg"/>
 <h:outputFormat value="#{msg.welcome}">
     <f:param value="Hello"/>
     <f:param value="605"/>
 </h:outputFormat>
</h:form>
</f:view>

 如果您的messages.properties包括以下的内容：

welcome={0},welcome to {1}

则{0}与{1}会被取代为<f:param>设定的文字，最后显示的文字会是： Hello,welcome to 605

另一个使用的方法则是：

<h:outputFormat value="{0}, Your name is {1}.">
     <f:param value="Hello"/>
     <f:param value="Guest"/>
 </h:outputFormat>

 

 

JSF命令标签

JSF命令类标签包括commandButton与commandLink，其主要作用在于提供一个命令按钮或连结，以下举例说明：

commandButton
　　显示一个命令按钮，即输出<input> HTML标签，其type属性可以设定为button、submit或reset，预设是submit，按下按钮会触发 javax.faces.event.ActionEvent，使用例子如下：

<h:commandButton value="送出" action="#{user.verify}"/>　

您可以设定image属性，指定图片的URL，设定了image属性的话，<input>标签的type属性会被设定为image，例如：

<h:commandButton value="#{msgs.commandText}" 
                  image="images/logowiki.jpg"
                  action="#{user.verify}"/>

 

commandLink

　产生超连结，会输出<a> HTML标签，而href属性会有'#'，而onclick属性会含有一段JavaScript程式，这个JavaScript的目的是按下连结后自动提交表单，具体来说其作用就像按钮，但外观却是超连结，包括在本体部份的内容都会成为超连结的一部份，一个使用的例子如下：

 

<h:commandLink value="#{msgs.commandText}"
                action="#{user.verify}"/>

　如果搭配<f:param>来使用，则所设定的参数会被当作请求参数一併送出，例如：

<h:commandLink>
   <h:outputText value="welcome"/>
   <f:param name="locale" value="zh_TW"/>
 </h:commandLink>

 JSF选择标签

选择类的标签可略分为单选标签与多选标签，依外型的不同可以分为单选按钮（JSF Radio）、复选框（JSF CheckBox）、列表框（JSF ListBox）与菜单框（JSF Menu），以下分别先作简单的说明。

<h:selectBooleanCheckbox>
　　在视图上呈现一个核取方块，例如：

我同意 <h:selectBooleanCheckbox value="#\{user.aggree\}"/>　　value所绑定的属性必须接受与传回boolean型态。这个元件在网页上呈现的外观如下：

<h:selectOneRadio>、<h:selectOneListbox>、<h: selectOneMenu>
　　这三个标签的作用，是让使用者从其所提供的选项中选择一个项目，所不同的就是其外观上的差别，例如：

<h:selectOneRadio value="#{user.education}">
   <f:selectItem itemLabel="高中" itemValue="高中"/>
   <f:selectItem itemLabel="大学" itemValue="大学"/>
   <f:selectItem itemLabel="研究所以上" itemValue="研究所以上"/>
 </h:selectOneRadio><p>

　　value所绑定的属性可以接受字串以外的型态或是自订型态，但记得如果是必须转换的型态或自订型态，必须搭配 标准转换器 或 自订转换器 来转换为物件，<h:selectOneRadio>的外观如下：

您也可以设定layout属性，可设定的属性是lineDirection、pageDirection，预设是lineDirection，也就是由左到右来排列选项，如果设定为pageDirection，则是由上至下排列选项，例如设定为：

<h:selectOneRadio layout="pageDirection"
                   value="#{user.education}">
   <f:selectItem itemLabel="高中" itemValue="高中"/>
   <f:selectItem itemLabel="大学" itemValue="大学"/>
   <f:selectItem itemLabel="研究所以上" itemValue="研究所以上"/>
 </h:selectOneRadio><p>

　　则外观如下：

<h:selectOneListbox>、<h:selectOneMenu>的设定方法类似于<h: selectOneRadio>，以下分别列出<h:selectOneListbox>、<h: selectOneMenu>的外观：

<h:selectManyCheckbox>、<h:selectManyListbox>、<h: selectManyMenu>