JSF html标签

 

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 元素