JSF html标签说明

Jsf提供了一套标准的html标签。可以让您搭配JSF组件输出HTML文件，标准的HTML Renderer Kit主要包括了几个类别：

输出（Outputs）其名称以output作为开头，作用为输出指定的信息或绑定值。

输入（Inputs）其名称以input作为开头，其作用为提供使用者输入字段。

命令（Commands）其名称以command作为开头，其作用为提供命令或链接按钮。

选择（Selections）其名称以select作为开头，其作用为提供用户选项的选取。

表格（Table）与dataTable相关，用于生成表格

其它包括了form、message、messages、graphicImage等等未分类的标签。

属性名称	适用	说明
id	所有组件	可指定id名称，以让其它标签或组件参考
binding	所有组件	绑定至UIComponent
rendered	所有组件	是否显示组件
styleClass	所有组件	设定Cascading stylesheet (CSS)
value	输入、输出、命令组件	设定值或绑定至指定的值
valueChangeListener	输入组件	设定值变事件处理者
converter	输入、输出组件	设定转换器
validator	输入组件	设定验证器
required	输入组件	是否验证必填字段
immediate	输入、命令组件	是否为立即事件

输出类的标签包括了outputLabel、outputLink、outputFormat与 outputText

分别举例说明如下：

outputLabel

产生<label> HTML标签，使用for属性指定组件的client ID，例如：

<h:inputText id="user" value="#{user.name}"/>
<h:outputLabel for="user" value="#{user.name}"/>

这会产生像是以下的html：
<input id="user" type="text" name="user" value="guest" />
<label for="user">

outputLink

产生<a> HTML标签，例如：
<h:outputLink value="../index.jsp"/>

value所指定的内容也可以是JSF EL绑定。

outputFormat

产生指定的文字信息，可以搭配<f:param>来设定信息的参数以格式化文本信息，例如：
<f:loadBundle basename="messages" var="msgs"/>
<h:outputFormat value="#{msgs.welcomeText}">
     <f:param value="Hello"/>
     <f:param value="Guest"/>
</h:outputFormat>

如果您的messages.properties包括以下的内容：
welcomeText={0}, Your name is {1}.

则{0}与{1}会被取代为<f:param>设定的文字，最后显示的文字会是：
Hello, Your name is Guest.

另一个使用的方法则是：
<h:outputFormat value="{0}, Your name is {1}.">
     <f:param value="Hello"/>
     <f:param value="Guest"/>
</h:outputFormat>

outputText

简单的显示指定的值或绑定的信息，例如：
<h:outputText value="#{user.name}"/>

输入类标签包括了inputText、inputTextarea、inputSecret、 inputHidden

分别举例说明如下：

inputText

显示单行输入字段，即输出<input> HTML标签，其type属性设定为text，例如：

<h:inputText value="#{user.name}"/>

inputTextarea

显示多行输入文字区域，即输出<textarea> HTML标签，例如：

<h:inputTextarea value="#{user.command}"/>

inputSecret

显示密码输入字段，即输出<input> HTML标签，其type属性设定为password，例如：
<h:inputSecret value="#{user.password}"/>

您可以设定redisplay属性以决定是否要显示密码字段的值，默认是false。

inputHidden

隐藏域，即输出<input> HTML标签，其type属性设定为hidden，隐藏域的值用于保留一些信息于客户端，以在下一次发送窗体时一并送出，例如：
<h:inputHidden value="#{user.hiddenInfo}"/>

标签说明 view 创建顶层视图 subview 创建视图的子视图 facet 向组件添加 facet param 向组件添加参数 attribute 向组件添加属性 actionListener 在父组件上注册操作监听器 valueChangeListener 向父组件注册值变更监听器 converter 注册任意转换器 convertDateTime 注册日期时间转换器 convertNumber 注册数量转换器 validateLength 验证组件值的长度 validateDoubleRange 验证组件值的双精度范围 validateLongRange 验证组件值的长整型范围 validator 向组件添加验证器 loadBundle 加载资源包 verbatim 向页面中添加标签 selectItem 指定 UISelectOne 或 UISelectMany 组件的一个项目 selectItems 指定 UISelectOne 或 UISelectMany 组件的多个项目

组件标签说明 UIForm form 表示 HTML表单元素 UIInput InputText 单行文本输入控件 inputTextarea 多行文本输入控件 InputSecret 密码输入控件 inputHidden 隐藏字段 UIOutput outputLabel 显示文本 outputLink 链接到另一页面或某页面上的特定位置 outputFormat 显示格式化的信息 outputText 当行文本输入 UICommand commandButton 表示一个按钮 commandLink 表示一个链接 UISelectOne SelectOneListbox 单选列表框 selectOneMenu 单选菜单 selectOneRadio 单选按钮集 UISelectBoolean selectBooleanCheckbox 单个复选框 UISelectMany selectManyListbox 复选框集 selectManyCheckbox 多行选择列表框 selectManyMenu 多选菜单 UIPanel panelGrid 表示一个 HTML 表格 panelGroup 组合一系列组件 UIMessage message 显示一个组件的最近使用的消息 messages 显示所有消息
UIGraphic graphicImage 显示一个图像 UIData dataTable 功能丰富的表格控件 UIColumn column 表示表格中的列表单 h:form 产生 HTML form 元素

猜你喜欢