MyFaces Impl - Tag reference report.

Tag reference sheet

Tag library reference for the following tag libraries:

JSF core tag library. (myfaces_core.tld) - uri: http://java.sun.com/jsf/core
JSF HTML tag library. (myfaces_html.tld) - uri: http://java.sun.com/jsf/html

JSF core tag library.

This tag library implements the standard JSF core tags. This is version 1.0.

actionListener This tag creates an instance of the specified ActionListener, and associates it with the nearest parent UIComponent
attribute This tag associates an attribute with the nearest parent UIComponent
convertDateTime This tag associates a date time converter with the nearest parent UIComponent
convertNumber This tag creates a number formatting converter and associates it with the nearest parent UIComponent
converter This tag creates an instance of the specified Converter, and associates it with the nearest parent UIComponent
facet This tag adds its child as a facet of the nearest parent UIComponent
loadBundle Loads a resource bundle and saves it as a variable in the request scope
param This tag associates a parameter name-value pair with the nearest parent UIComponent
selectItem This tag associates a single SelectItem with the nearest parent UIComponent
selectItems This tag associates a set of selection list items with the nearest parent UIComponent
subview This tag associates a set of UIComponents with the nearest parent UIComponent
validateDoubleRange Creates a validator and associateds it with the nearest parent UIComponent
validateLength Creates a validator and associateds it with the nearest parent UIComponent
validateLongRange Creates a validator and associateds it with the nearest parent UIComponent
validator Creates a validator and associates it with the nearest parent UIComponent
valueChangeListener Adds the specified ValueChangeListener to the nearest parent UIComponent (which is expected to be a UIInput component)
verbatim Outputs its body as verbatim text
view Creates a JSF View, which is a container that holds all of the components that are part of the view

Required attributes are marked with a *

<f:actionListener>

This tag creates an instance of the specified ActionListener, and associates it with the nearest parent UIComponent. Unless otherwise specified, all attributes accept static values or EL expressions. Can contain: empty

Attributes

Name	Description	Type
type*	The fully qualified class name of the ActionListener class.	String

<f:attribute>

This tag associates an attribute with the nearest parent UIComponent. When the value is not an EL expression, this tag has the same effect as calling component.getAttributes.put(name, value). When the attribute name specified matches a standard property of the component, that property is set. However it is also valid to assign attributes to components using any arbitrary name; the component itself won't make any use of these but other objects such as custom renderers, validators or action listeners can later retrieve the attribute from the component by name. When the value is an EL expression, this tag has the same effect as calling component.setValueBinding. A call to method component.getAttributes().get(name) will then cause that expression to be evaluated and the result of the expression is returned, not the original EL expression string. See the javadoc for UIComponent.getAttributes for more details. Unless otherwise specified, all attributes accept static values or EL expressions. Can contain: empty

Attributes

Name	Description	Type
name*	The name of the attribute.	String
value*	The attribute's value.	String

<f:convertDateTime>

This tag associates a date time converter with the nearest parent UIComponent. Unless otherwise specified, all attributes accept static values or EL expressions. Can contain: empty

Attributes

Name	Description	Type
dateStyle	The style of the date. Values include: default, short, medium, long, and full.	String
locale	The name of the locale to be used, instead of the default.	String
pattern	A custom Date formatting pattern, in the format used by java.text.SimpleDateFormat.	String
timeStyle	The style of the time. Values include: default, short, medium, long, and full.	String
timeZone	The time zone to use instead of GMT (the default timezone). When this value is a value-binding to a TimeZone instance, that timezone is used. Otherwise this value is treated as a String containing a timezone id, ie as the ID parameter of method java.util.TimeZone.getTimeZone(String).	String
type	Specifies whether the date, time, or both should be parsed/formatted. Values include: date, time, and both. Default based on setting of timeStyle and dateStyle.	String

<f:convertNumber>

This tag creates a number formatting converter and associates it with the nearest parent UIComponent. Unless otherwise specified, all attributes accept static values or EL expressions. Can contain: empty

Attributes

Name	Description	Type
currencyCode	ISO 4217 currency code	String
currencySymbol	The currency symbol used to format a currency value. Defaults to the currency symbol for locale.	String
groupingUsed	Specifies whether output will contain grouping separators. Default: true.	String
integerOnly	Specifies whether only the integer part of the input will be parsed. Default: false.	String
locale	The name of the locale to be used, instead of the default as specified in the faces configuration file.	String
maxFractionDigits	The maximum number of digits in the fractional portion of the number.	String
maxIntegerDigits	The maximum number of digits in the integer portion of the number.	String
minFractionDigits	The minimum number of digits in the fractional portion of the number.	String
minIntegerDigits	The minimum number of digits in the integer portion of the number.	String
pattern	A custom Date formatting pattern, in the format used by java.text.SimpleDateFormat.	String
type	The type of formatting/parsing to be performed. Values include: number, currency, and percent. Default: number.	String

<f:converter>

This tag creates an instance of the specified Converter, and associates it with the nearest parent UIComponent. Can contain: empty

Attributes

Name	Description	Type
converterId*	The converter's registered ID.	String

<f:facet>

This tag adds its child as a facet of the nearest parent UIComponent. A child consisting of multiple elements should be nested within a container component (i.e., within an h:panelGroup for HTML library components). Unless otherwise specified, all attributes accept static values or EL expressions. Can contain: JSP

Attributes

Name	Description	Type
name*	The name of the facet to be created. This must be a static value.	String

<f:loadBundle>

Loads a resource bundle and saves it as a variable in the request scope. Unless otherwise specified, all attributes accept static values or EL expressions. Can contain: empty

Attributes

Name	Description	Type
basename*	The base name of the resource bundle.	String
var*	The name of the variable in request scope that the resources are saved to. This must be a static value.	String

<f:param>

This tag associates a parameter name-value pair with the nearest parent UIComponent. A UIComponent is created to represent this name-value pair, and stored as a child of the parent component; what effect this has depends upon the renderer of that parent component. Unless otherwise specified, all attributes accept static values or EL expressions. Can contain: empty

Attributes

Name	Description	Type
binding	Identifies a backing bean property (of type UIComponent or appropriate subclass) to bind to this component instance. This value must be an EL expression.	String
id	The developer-assigned ID of this component. The ID must be unique within the scope of the tag's enclosing naming container (e.g. h:form or f:subview). This value must be a static value.	String
name	A String containing the name of the parameter.	String
value*	The value of this parameter.	String

<f:selectItem>

This tag associates a single SelectItem with the nearest parent UIComponent. The item represents a single option for a component such as an h:selectBooleanCheckbox or h:selectOneMenu. See also component selectItems. Unless otherwise specified, all attributes accept static values or EL expressions.

Can contain: empty

Attributes

Name	Description	Type
binding	Identifies a backing bean property (of type UIComponent or appropriate subclass) to bind to this component instance. This value must be an EL expression.	String
id	The developer-assigned ID of this component. The ID must be unique within the scope of the tag's enclosing naming container (e.g. h:form or f:subview). This value must be a static value.	String
itemDescription	An optional description for this item.	String
itemDisabled	If true, this component will not be saved during state saving.	String
itemLabel	The locale-specific label that will be displayed to the user for this item.	String
itemValue	The value of this item, of the same type as the parent component's value.	String
value	An EL expression that refers to a javax.faces.model.SelectItem instance.	String

<f:selectItems>

This tag associates a set of selection list items with the nearest parent UIComponent. The set of SelectItem objects is retrieved via a value-binding. Unless otherwise specified, all attributes accept static values or EL expressions.

Can contain: empty

Attributes

Name	Description	Type
binding	Identifies a backing bean property (of type UIComponent or appropriate subclass) to bind to this component instance. This value must be an EL expression.	String
id	The developer-assigned ID of this component. The ID must be unique within the scope of the tag's enclosing naming container (e.g. h:form or f:subview). This value must be a static value.	String
value	An EL expression that specifies the contents of the selection list. The expression can refer to one of the following: <ol> <li>A single SelectItem</li> <li>An array or Collection of SelectItem instances</li> <li>A Map. The contents of the Map are used to create SelectItem instances, where the SelectItem's label is the map's key value, and the SelectItem's value is the map's value. When using a map, it is recommended that an ordered implementation such as java.util.TreeMap is used.</li> </ol> The value properties of each of the SelectItems must be of the same basic type as the parent component's value.	String

<f:subview>

This tag associates a set of UIComponents with the nearest parent UIComponent. It acts as a naming container to make the IDs of its component elements unique. Unless otherwise specified, all attributes accept static values or EL expressions.

Can contain: JSP

Attributes

Name	Description	Type
binding	Identifies a backing bean property (of type UIComponent or appropriate subclass) to bind to this component instance. This value must be an EL expression.	String
id*	The developer-assigned ID of this component. The ID must be unique within the scope of the tag's enclosing naming container (e.g. h:form or f:subview). This value must be a static value.	String
rendered	A boolean value that indicates whether this component should be rendered. Default value: true.	String

<f:validateDoubleRange>

Creates a validator and associateds it with the nearest parent UIComponent. When invoked, the validator ensures that values are valid doubles that lie within the minimum and maximum values specified. Commonly associated with a h:inputText entity. Unless otherwise specified, all attributes accept static values or EL expressions.

Can contain: empty

Attributes

Name	Description	Type
maximum	The largest value that should be considered valid.	String
minimum	The smallest value that should be considered valid.	String

<f:validateLength>

Creates a validator and associateds it with the nearest parent UIComponent. When invoked, the validator ensures that values are valid strings with a length that lies within the minimum and maximum values specified. Commonly associated with a h:inputText entity. Unless otherwise specified, all attributes accept static values or EL expressions.

Can contain: empty

Attributes

Name	Description	Type
maximum	The largest value that should be considered valid.	String
minimum	The smallest value that should be considered valid.	String

<f:validateLongRange>

Creates a validator and associateds it with the nearest parent UIComponent. When invoked, the validator ensures that values are valid longs that lie within the minimum and maximum values specified. Commonly associated with a h:inputText entity. Unless otherwise specified, all attributes accept static values or EL expressions.

Can contain: empty

Attributes

Name	Description	Type
maximum	The largest value that should be considered valid.	String
minimum	The smallest value that should be considered valid.	String

<f:validator>

Creates a validator and associates it with the nearest parent UIComponent. During the validation phase (or the apply-request-values phase for immediate components), if the associated component has any submitted value and the conversion of that value to the required type has succeeded then the specified validator type is invoked to test the validity of the converted value. Commonly associated with an h:inputText entity, but may be applied to any input component. Some validators may allow the component to use attributes to define component-specific validation constraints; see the f:attribute tag. See also the "validator" attribute of all input components, which allows a component to specify an arbitrary validation method (rather than a registered validation type, as this tag does). Unless otherwise specified, all attributes accept static values or EL expressions.

Can contain: empty

Attributes

Name	Description	Type
validatorId	The registered ID of the desired Validator.	String

<f:valueChangeListener>

Adds the specified ValueChangeListener to the nearest parent UIComponent (which is expected to be a UIInput component). Whenever the form containing the parent UIComponent is submitted, an instance of the specified type is created. If the submitted value from the component is different from the component's current value then a ValueChangeEvent is queued. When the ValueChangeEvent is processed (at end of the validate phase for non-immediate components, or at end of the apply-request-values phase for immediate components) the object's processValueChange method is invoked. Unless otherwise specified, all attributes accept static values or EL expressions.

Can contain: empty

Attributes

Name	Description	Type
type*	The name of a Java class that implements ValueChangeListener.	String

<f:verbatim>

Outputs its body as verbatim text. No JSP tags within the verbatim tag (including JSF tags) are evaluated; the content is treated simply as literal text to be copied to the response. Unless otherwise specified, all attributes accept static values or EL expressions.

Can contain: JSP

Attributes

Name	Description	Type
escape	If true, generated markup is escaped. Default: false.	String

<f:view>

Creates a JSF View, which is a container that holds all of the components that are part of the view. Unless otherwise specified, all attributes accept static values or EL expressions.

Can contain: JSP

Attributes

Name	Description	Type
locale	The locale of this view. Default: the default locale from the configuration file.	String

JSF HTML tag library.

This tag library implements the standard JSF HTML tags.

This is version 1.0.

column This tag is commonly used as a child of the dataTable tag, to represent a column of data
commandButton This tag renders as an HTML input element
commandLink This tag renders as an HTML a element
dataTable This component renders as an HTML table element
form Renders an HTML form element
graphicImage Renders an HTML img element
inputHidden Renders as an HTML input tag with its type set to "hidden"
inputSecret Renders as an HTML input tag with its type set to "password"
inputText Renders a HTML input element
inputTextarea Renders a HTML textarea element
message Renders the first FacesMessage that is assigned to the component referenced by the "for" attribute
messages Renders all or some FacesMessages depending on the "for" and "globalOnly" attributes: If globalOnly = true, only global messages, that have no associated clientId, will be displayed
outputFormat Renders as text, applying the child f:param values to the value attribute as a MessageFormat string
outputLabel Renders a HTML label element
outputLink Renders a HTML a element
outputText Renders the value of the associated UIOutput component
panelGrid This element renders as an HTML table with specified number of columns
panelGroup This element is used to group other components where the specification requires one child element
selectBooleanCheckbox Allow the user to choose a "true" or "false" value, presented as a checkbox
selectManyCheckbox Allow the user to select zero or more items from a set of available options
selectManyListbox Allow the user to select zero or more items from a set of available options
selectManyMenu Allow the user to select zero or more items from a set of available options
selectOneListbox Allow the user to choose one option from a set of options
selectOneMenu Allow the user to choose one option from a set of options
selectOneRadio Allow the user to choose one option from a set of options

Required attributes are marked with a *

<h:column>

This tag is commonly used as a child of the dataTable tag, to represent a column of data. It can be decorated with "header" and "footer" facets to drive the output of header and footer rows. Row values are specified via its children. Unless otherwise specified, all attributes accept static values or EL expressions. Can contain: JSP

Attributes

Name	Description	Type
binding	Identifies a backing bean property (of type UIComponent or appropriate subclass) to bind to this component instance. This value must be an EL expression.	String
id	The developer-assigned ID of this component. The ID must be unique within the scope of the tag's enclosing naming container (e.g. h:form or f:subview). This value must be a static value.	String
rendered	A boolean value that indicates whether this component should be rendered. Default value: true.	String

<h:commandButton>

This tag renders as an HTML input element. Unless otherwise specified, all attributes accept static values or EL expressions. Can contain: JSP

Attributes

Name	Description	Type
accesskey	HTML: Sets the access key for this element.	String
action	Specifies the action to take when this command is invoked. If the value is an expression, it is expected to be a method binding EL expression that identifies an action method. An action method accepts no parameters and has a String return value, called the action outcome, that identifies the next view displayed. The phase that this event is fired in can be controlled via the immediate attribute. If the value is a string literal, it is treated as a navigation outcome for the current view. This is functionally equivalent to a reference to an action method that returns the string literal.	String
actionListener	A method binding EL expression that identifies an action listener method to be invoked if this component is activated by the user. An action listener method accepts a parameter of type javax.faces.event.ActionEvent and returns void. The phase that this event is fired in can be controlled via the immediate attribute.	String
alt	HTML: Specifies alternative text that can be used by a browser that can't show this element.	String
binding	Identifies a backing bean property (of type UIComponent or appropriate subclass) to bind to this component instance. This value must be an EL expression.	String
dir	HTML: The direction of text display, either 'ltr' (left-to-right) or 'rtl' (right-to-left).	String
disabled	HTML: When true, this element cannot receive focus.	String
id	The developer-assigned ID of this component. The ID must be unique within the scope of the tag's enclosing naming container (e.g. h:form or f:subview). This value must be a static value.	String
image	HTML: The URL of an image that renders in place of the button.	String
immediate	A boolean value that identifies the phase during which action events should fire. During normal event processing, action methods and action listener methods are fired during the "invoke application" phase of request processing. If this attribute is set to "true", these methods are fired instead at the end of the "apply request values" phase.	String
lang	HTML: The base language of this document.	String
onblur	HTML: Specifies a script to be invoked when the element loses focus.	String
onchange	HTML: Specifies a script to be invoked when the element is modified.	String
onclick	HTML: Script to be invoked when the element is clicked.	String
ondblclick	HTML: Script to be invoked when the element is double-clicked.	String
onfocus	HTML: Specifies a script to be invoked when the element receives focus.	String
onkeydown	HTML: Script to be invoked when a key is pressed down over this element.	String
onkeypress	HTML: Script to be invoked when a key is pressed over this element.	String
onkeyup	HTML: Script to be invoked when a key is released over this element.	String
onmousedown	HTML: Script to be invoked when the pointing device is pressed over this element.	String
onmousemove	HTML: Script to be invoked when the pointing device is moved while it is in this element.	String
onmouseout	HTML: Script to be invoked when the pointing device is moves out of this element.	String
onmouseover	HTML: Script to be invoked when the pointing device is moved into this element.	String
onmouseup	HTML: Script to be invoked when the pointing device is released over this element.	String
onselect	HTML: Specifies a script to be invoked when the element is selected.	String
readonly	HTML: When true, indicates that this component cannot be modified by the user. The element may receive focus unless it has also been disabled.	String
rendered	A boolean value that indicates whether this component should be rendered. Default value: true.	String
size	The initial width of this control.	String
style	HTML: CSS styling instructions.	String
styleClass	The CSS class for this element. Corresponds to the HTML 'class' attribute.	String
tabindex	HTML: Specifies the position of this element within the tab order of the document.	String
title	HTML: An advisory title for this element. Often used by the user agent as a tooltip.	String
type	HTML: A hint to the user agent about the content type of the linked resource.	String
value	The initial value of this component.	String

<h:commandLink>

This tag renders as an HTML a element. Unless otherwise specified, all attributes accept static values or EL expressions. Can contain: JSP

Attributes

Name	Description	Type
accesskey	HTML: Sets the access key for this element.	String
action	Specifies the action to take when this command is invoked. If the value is an expression, it is expected to be a method binding EL expression that identifies an action method. An action method accepts no parameters and has a String return value, called the action outcome, that identifies the next view displayed. The phase that this event is fired in can be controlled via the immediate attribute. If the value is a string literal, it is treated as a navigation outcome for the current view. This is functionally equivalent to a reference to an action method that returns the string literal.	String
actionListener	A method binding EL expression that identifies an action listener method to be invoked if this component is activated by the user. An action listener method accepts a parameter of type javax.faces.event.ActionEvent and returns void. The phase that this event is fired in can be controlled via the immediate attribute.	String
binding	Identifies a backing bean property (of type UIComponent or appropriate subclass) to bind to this component instance. This value must be an EL expression.	String
charset	HTML: Specifies the character encoding of the linked resource.	String
coords	HTML: The coordinates of regions within a client side image map.	String
dir	HTML: The direction of text display, either 'ltr' (left-to-right) or 'rtl' (right-to-left).	String
hreflang	HTML: The language of the linked resource.	String
id	The developer-assigned ID of this component. The ID must be unique within the scope of the tag's enclosing naming container (e.g. h:form or f:subview). This value must be a static value.	String
immediate	A boolean value that identifies the phase during which action events should fire. During normal event processing, action methods and action listener methods are fired during the "invoke application" phase of request processing. If this attribute is set to "true", these methods are fired instead at the end of the "apply request values" phase.	String
lang	HTML: The base language of this document.	String
onblur	HTML: Specifies a script to be invoked when the element loses focus.	String
onclick	HTML: Script to be invoked when the element is clicked.	String
ondblclick	HTML: Script to be invoked when the element is double-clicked.	String
onfocus	HTML: Specifies a script to be invoked when the element receives focus.	String
onkeydown	HTML: Script to be invoked when a key is pressed down over this element.	String
onkeypress	HTML: Script to be invoked when a key is pressed over this element.	String
onkeyup	HTML: Script to be invoked when a key is released over this element.	String
onmousedown	HTML: Script to be invoked when the pointing device is pressed over this element.	String
onmousemove	HTML: Script to be invoked when the pointing device is moved while it is in this element.	String
onmouseout	HTML: Script to be invoked when the pointing device is moves out of this element.	String
onmouseover	HTML: Script to be invoked when the pointing device is moved into this element.	String
onmouseup	HTML: Script to be invoked when the pointing device is released over this element.	String
rel	HTML: The relationship between the current document and the linked resource.	String
rendered	A boolean value that indicates whether this component should be rendered. Default value: true.	String
rev	HTML: The type(s) describing the reverse link for the linked resource.	String
shape	HTML: The shape of a region in a client side image map.	String
style	HTML: CSS styling instructions.	String
styleClass	The CSS class for this element. Corresponds to the HTML 'class' attribute.	String
tabindex	HTML: Specifies the position of this element within the tab order of the document.	String
target	HTML: Names the frame that should display content generated by invoking this action.	String
title	HTML: An advisory title for this element. Often used by the user agent as a tooltip.	String
type	HTML: A hint to the user agent about the content type of the linked resource.	String
value	The initial value of this component.	String

<h:dataTable>

This component renders as an HTML table element. It has as its children h:column entities, which describe the columns of the table. It can be decorated with facets named "header" and "footer" to specify header and footer rows. Unless otherwise specified, all attributes accept static values or EL expressions. Can contain: JSP

Attributes

Name	Description	Type
align	HTML: Specifies the horizontal alignment of this element. Deprecated in HTML 4.01.	String
bgcolor	HTML: The background color of this element.	String
binding	Identifies a backing bean property (of type UIComponent or appropriate subclass) to bind to this component instance. This value must be an EL expression.	String
border	HTML: Specifies the width of the border of this element, in pixels. Deprecated in HTML 4.01.	String
cellpadding	HTML: Specifies the amount of empty space between the cell border and its contents. It can be either a pixel length or a percentage.	String
cellspacing	HTML: Specifies the amount of space between the cells of the table. It can be either a pixel length or a percentage of available space.	String
columnClasses	A comma separated list of CSS class names to apply to td elements in each column.	String
datafld	Reserved for future use.	String
dataformatas	Reserved for future use.	String
datasrc	Reserved for future use.	String
dir	HTML: The direction of text display, either 'ltr' (left-to-right) or 'rtl' (right-to-left).	String
first	The index of the first row to be displayed, where 0 is the first row.	String
footerClass	The CSS class to be applied to footer cells.	String
frame	HTML: Controls what part of the frame that surrounds a table is visible. Values include: void, above, below, hsides, lhs, rhs, vsides, box, and border.	String
headerClass	The CSS class to be applied to header cells.	String
id	The developer-assigned ID of this component. The ID must be unique within the scope of the tag's enclosing naming container (e.g. h:form or f:subview). This value must be a static value.	String
lang	HTML: The base language of this document.	String
onclick	HTML: Script to be invoked when the element is clicked.	String
ondblclick	HTML: Script to be invoked when the element is double-clicked.	String
onkeydown	HTML: Script to be invoked when a key is pressed down over this element.	String
onkeypress	HTML: Script to be invoked when a key is pressed over this element.	String
onkeyup	HTML: Script to be invoked when a key is released over this element.	String
onmousedown	HTML: Script to be invoked when the pointing device is pressed over this element.	String
onmousemove	HTML: Script to be invoked when the pointing device is moved while it is in this element.	String
onmouseout	HTML: Script to be invoked when the pointing device is moves out of this element.	String
onmouseover	HTML: Script to be invoked when the pointing device is moved into this element.	String
onmouseup	HTML: Script to be invoked when the pointing device is released over this element.	String
rendered	A boolean value that indicates whether this component should be rendered. Default value: true.	String
rowClasses	A comma separated list of CSS class names to apply to td elements in each row.	String
rows	The number of rows to be displayed. Specify zero for all remaining rows in the table.	String
rules	HTML: Controls how rules are rendered between cells. Values include: none, groups, rows, cols, and all.	String
style	HTML: CSS styling instructions.	String
styleClass	The CSS class for this element. Corresponds to the HTML 'class' attribute.	String
summary	HTML: Provides a summary of the contents of the table, for accessibility purposes.	String
title	HTML: An advisory title for this element. Often used by the user agent as a tooltip.	String
value	An EL expression that specifies the data model that backs this table. The value can be of any type. A value of type DataModel is used directly. Array-like parameters of type java.util.List, array of Object, java.sql.ResultSet, or javax.servlet.jsp.jstl.sql.Result are wrapped in a DataModel. Other values are wrapped in a DataModel as a single row.	String
var*	Defines the name of the request-scope variable that will hold the current row during iteration. This value must be a static value.	String
width	HTML: Specifies the desired width of the table, as a pixel length or a percentage of available space.	String

<h:form>

Renders an HTML form element. Unless otherwise specified, all attributes accept static values or EL expressions. Can contain: JSP

Attributes

Name	Description	Type
accept	HTML: Provides a comma-separated list of content types that the server processing this form can handle.	String
acceptcharset	HTML: The list of character encodings accepted by the server for this form.	String
binding	Identifies a backing bean property (of type UIComponent or appropriate subclass) to bind to this component instance. This value must be an EL expression.	String
dir	HTML: The direction of text display, either 'ltr' (left-to-right) or 'rtl' (right-to-left).	String
enctype	HTML: The content type used to submit this form to the server.	String
id	The developer-assigned ID of this component. The ID must be unique within the scope of the tag's enclosing naming container (e.g. h:form or f:subview). This value must be a static value.	String
lang	HTML: The base language of this document.	String
onclick	HTML: Script to be invoked when the element is clicked.	String
ondblclick	HTML: Script to be invoked when the element is double-clicked.	String
onkeydown	HTML: Script to be invoked when a key is pressed down over this element.	String
onkeypress	HTML: Script to be invoked when a key is pressed over this element.	String
onkeyup	HTML: Script to be invoked when a key is released over this element.	String
onmousedown	HTML: Script to be invoked when the pointing device is pressed over this element.	String
onmousemove	HTML: Script to be invoked when the pointing device is moved while it is in this element.	String
onmouseout	HTML: Script to be invoked when the pointing device is moves out of this element.	String
onmouseover	HTML: Script to be invoked when the pointing device is moved into this element.	String
onmouseup	HTML: Script to be invoked when the pointing device is released over this element.	String
onreset	HTML: Script to be invoked when this form is reset.	String
onsubmit	HTML: Script to be invoked when this form is submitted.	String
rendered	A boolean value that indicates whether this component should be rendered. Default value: true.	String
style	HTML: CSS styling instructions.	String
styleClass	The CSS class for this element. Corresponds to the HTML 'class' attribute.	String
target	HTML: Names the frame that should display content generated by invoking this action.	String
title	HTML: An advisory title for this element. Often used by the user agent as a tooltip.	String

<h:graphicImage>

Renders an HTML img element. Unless otherwise specified, all attributes accept static values or EL expressions. Can contain: JSP

Attributes

Name	Description	Type
alt	HTML: Specifies alternative text that can be used by a browser that can't show this element.	String
binding	Identifies a backing bean property (of type UIComponent or appropriate subclass) to bind to this component instance. This value must be an EL expression.	String
dir	HTML: The direction of text display, either 'ltr' (left-to-right) or 'rtl' (right-to-left).	String
height	HTML: Overrides the natural height of this image, by specifying height in pixels.	String
id	The developer-assigned ID of this component. The ID must be unique within the scope of the tag's enclosing naming container (e.g. h:form or f:subview). This value must be a static value.	String
ismap	HTML: Specifies server-side image map handling for this image.	String
lang	HTML: The base language of this document.	String
longdesc	HTML: A link to a long description of the image.	String
onclick	HTML: Script to be invoked when the element is clicked.	String
ondblclick	HTML: Script to be invoked when the element is double-clicked.	String
onkeydown	HTML: Script to be invoked when a key is pressed down over this element.	String
onkeypress	HTML: Script to be invoked when a key is pressed over this element.	String
onkeyup	HTML: Script to be invoked when a key is released over this element.	String
onmousedown	HTML: Script to be invoked when the pointing device is pressed over this element.	String
onmousemove	HTML: Script to be invoked when the pointing device is moved while it is in this element.	String
onmouseout	HTML: Script to be invoked when the pointing device is moves out of this element.	String
onmouseover	HTML: Script to be invoked when the pointing device is moved into this element.	String
onmouseup	HTML: Script to be invoked when the pointing device is released over this element.	String
rendered	A boolean value that indicates whether this component should be rendered. Default value: true.	String
style	HTML: CSS styling instructions.	String
styleClass	The CSS class for this element. Corresponds to the HTML 'class' attribute.	String
title	HTML: An advisory title for this element. Often used by the user agent as a tooltip.	String
url	An alias for the "value" attribute.	String
usemap	HTML: Specifies an image map to use with this image.	String
value	The URL of the image. If the URL starts with a '/', it is relative to the context path of the web application.	String
width	HTML: Overrides the natural width of this image, by specifying width in pixels.	String

<h:inputHidden>

Renders as an HTML input tag with its type set to "hidden". Unless otherwise specified, all attributes accept static values or EL expressions. Can contain: JSP

Attributes

Name	Description	Type
binding	Identifies a backing bean property (of type UIComponent or appropriate subclass) to bind to this component instance. This value must be an EL expression.	String
converter	An expression that specifies the Converter for this component. If the value binding expression is a String, the String is used as an ID to look up a Converter. If the value binding expression is a Converter, uses that instance as the converter. The value can either be a static value (ID case only) or an EL expression.	String
id	The developer-assigned ID of this component. The ID must be unique within the scope of the tag's enclosing naming container (e.g. h:form or f:subview). This value must be a static value.	String
immediate	A boolean value that identifies the phase during which value change events should fire. During normal event processing, value change events are fired during the "process validations" phase of request processing. If this attribute is set to "true", these methods are fired instead at the end of the "apply request values" phase.	String
rendered	A boolean value that indicates whether this component should be rendered. Default value: true.	String
required	A boolean value that indicates whether an input value is required. If this value is true, and no input value is provided, the error message javax.faces.component.UIInput.REQUIRED is posted.	String
validator	A method binding EL expression, accepting FacesContext, UIComponent, and Object parameters, and returning void, that validates the component's local value.	String
value	The initial value of this component. This value is generally set as a value-binding in the form #{myBean.myProperty}, where myProperty can be any data-type of Java (also user-defined data-types), if a converter for this data-type exists. Special cases: 1) f:selectItems - value needs to bind to a list (or an array) of javax.faces.model.SelectItem-instances 2) components implementing UISelectMany (e.g. h:selectManyCheckbox) - value needs to bind to a list (or an array) of values, where the values need to be of the same data-type as the choices of the associated f:selectItems-component 3) components implementing UIData (e.g. h:dataTable) - value needs to bind to a list (or an array) of values, which will be iterated over when the data-table is processed	String
valueChangeListener	A method binding EL expression, accepting a ValueChangeEvent parameter and returning void. The specified method is invoked if this component is modified. The phase that this handler is fired in can be controlled via the immediate attribute.	String

<h:inputSecret>

Renders as an HTML input tag with its type set to "password". Unless otherwise specified, all attributes accept static values or EL expressions. Can contain: JSP

Attributes

Name	Description	Type
accesskey	HTML: Sets the access key for this element.	String
align	HTML: Specifies the horizontal alignment of this element. Deprecated in HTML 4.01.	String
alt	HTML: Specifies alternative text that can be used by a browser that can't show this element.	String
binding	Identifies a backing bean property (of type UIComponent or appropriate subclass) to bind to this component instance. This value must be an EL expression.	String
converter	An expression that specifies the Converter for this component. If the value binding expression is a String, the String is used as an ID to look up a Converter. If the value binding expression is a Converter, uses that instance as the converter. The value can either be a static value (ID case only) or an EL expression.	String
dir	HTML: The direction of text display, either 'ltr' (left-to-right) or 'rtl' (right-to-left).	String
disabled	HTML: When true, this element cannot receive focus.	String
id	The developer-assigned ID of this component. The ID must be unique within the scope of the tag's enclosing naming container (e.g. h:form or f:subview). This value must be a static value.	String
immediate	A boolean value that identifies the phase during which value change events should fire. During normal event processing, value change events are fired during the "process validations" phase of request processing. If this attribute is set to "true", these methods are fired instead at the end of the "apply request values" phase.	String
lang	HTML: The base language of this document.	String
maxlength	HTML: The maximum number of characters allowed to be entered.	String
onblur	HTML: Specifies a script to be invoked when the element loses focus.	String
onchange	HTML: Specifies a script to be invoked when the element is modified.	String
onclick	HTML: Script to be invoked when the element is clicked.	String
ondblclick	HTML: Script to be invoked when the element is double-clicked.	String
onfocus	HTML: Specifies a script to be invoked when the element receives focus.	String
onkeydown	HTML: Script to be invoked when a key is pressed down over this element.	String
onkeypress	HTML: Script to be invoked when a key is pressed over this element.	String
onkeyup	HTML: Script to be invoked when a key is released over this element.	String
onmousedown	HTML: Script to be invoked when the pointing device is pressed over this element.	String
onmousemove	HTML: Script to be invoked when the pointing device is moved while it is in this element.	String
onmouseout	HTML: Script to be invoked when the pointing device is moves out of this element.	String
onmouseover	HTML: Script to be invoked when the pointing device is moved into this element.	String
onmouseup	HTML: Script to be invoked when the pointing device is released over this element.	String
onselect	HTML: Specifies a script to be invoked when the element is selected.	String
readonly	HTML: When true, indicates that this component cannot be modified by the user. The element may receive focus unless it has also been disabled.	String
redisplay	If true, the value will be re-sent (in plaintext) when the form is rerendered (see JSF.7.4.4). Default is false.	String
rendered	A boolean value that indicates whether this component should be rendered. Default value: true.	String
required	A boolean value that indicates whether an input value is required. If this value is true, and no input value is provided, the error message javax.faces.component.UIInput.REQUIRED is posted.	String
size	HTML: The initial width of this control, in characters.	String
style	HTML: CSS styling instructions.	String
styleClass	The CSS class for this element. Corresponds to the HTML 'class' attribute.	String
tabindex	HTML: Specifies the position of this element within the tab order of the document.	String
title	HTML: An advisory title for this element. Often used by the user agent as a tooltip.	String
validator	A method binding EL expression, accepting FacesContext, UIComponent, and Object parameters, and returning void, that validates the component's local value.	String
value	The initial value of this component. This value is generally set as a value-binding in the form #{myBean.myProperty}, where myProperty can be any data-type of Java (also user-defined data-types), if a converter for this data-type exists. Special cases: 1) f:selectItems - value needs to bind to a list (or an array) of javax.faces.model.SelectItem-instances 2) components implementing UISelectMany (e.g. h:selectManyCheckbox) - value needs to bind to a list (or an array) of values, where the values need to be of the same data-type as the choices of the associated f:selectItems-component 3) components implementing UIData (e.g. h:dataTable) - value needs to bind to a list (or an array) of values, which will be iterated over when the data-table is processed	String
valueChangeListener	A method binding EL expression, accepting a ValueChangeEvent parameter and returning void. The specified method is invoked if this component is modified. The phase that this handler is fired in can be controlled via the immediate attribute.	String

<h:inputText>

Renders a HTML input element. Unless otherwise specified, all attributes accept static values or EL expressions. Can contain: JSP

Attributes

Name	Description	Type
accesskey	HTML: Sets the access key for this element.	String
align	HTML: Specifies the horizontal alignment of this element. Deprecated in HTML 4.01.	String
alt	HTML: Specifies alternative text that can be used by a browser that can't show this element.	String
binding	Identifies a backing bean property (of type UIComponent or appropriate subclass) to bind to this component instance. This value must be an EL expression.	String
converter	An expression that specifies the Converter for this component. If the value binding expression is a String, the String is used as an ID to look up a Converter. If the value binding expression is a Converter, uses that instance as the converter. The value can either be a static value (ID case only) or an EL expression.	String
dir	HTML: The direction of text display, either 'ltr' (left-to-right) or 'rtl' (right-to-left).	String
disabled	HTML: When true, this element cannot receive focus.	String
id	The developer-assigned ID of this component. The ID must be unique within the scope of the tag's enclosing naming container (e.g. h:form or f:subview). This value must be a static value.	String
immediate	A boolean value that identifies the phase during which value change events should fire. During normal event processing, value change events are fired during the "process validations" phase of request processing. If this attribute is set to "true", these methods are fired instead at the end of the "apply request values" phase.	String
lang	HTML: The base language of this document.	String
maxlength	HTML: The maximum number of characters allowed to be entered.	String
onblur	HTML: Specifies a script to be invoked when the element loses focus.	String
onchange	HTML: Specifies a script to be invoked when the element is modified.	String
onclick	HTML: Script to be invoked when the element is clicked.	String
ondblclick	HTML: Script to be invoked when the element is double-clicked.	String
onfocus	HTML: Specifies a script to be invoked when the element receives focus.	String
onkeydown	HTML: Script to be invoked when a key is pressed down over this element.	String
onkeypress	HTML: Script to be invoked when a key is pressed over this element.	String
onkeyup	HTML: Script to be invoked when a key is released over this element.	String
onmousedown	HTML: Script to be invoked when the pointing device is pressed over this element.	String
onmousemove	HTML: Script to be invoked when the pointing device is moved while it is in this element.	String
onmouseout	HTML: Script to be invoked when the pointing device is moves out of this element.	String
onmouseover	HTML: Script to be invoked when the pointing device is moved into this element.	String
onmouseup	HTML: Script to be invoked when the pointing device is released over this element.	String
onselect	HTML: Specifies a script to be invoked when the element is selected.	String
readonly	HTML: When true, indicates that this component cannot be modified by the user. The element may receive focus unless it has also been disabled.	String
rendered	A boolean value that indicates whether this component should be rendered. Default value: true.	String
required	A boolean value that indicates whether an input value is required. If this value is true, and no input value is provided, the error message javax.faces.component.UIInput.REQUIRED is posted.	String
size	HTML: The initial width of this control, in characters.	String
style	HTML: CSS styling instructions.	String
styleClass	The CSS class for this element. Corresponds to the HTML 'class' attribute.	String
tabindex	HTML: Specifies the position of this element within the tab order of the document.	String
title	HTML: An advisory title for this element. Often used by the user agent as a tooltip.	String
validator	A method binding EL expression, accepting FacesContext, UIComponent, and Object parameters, and returning void, that validates the component's local value.	String
value	The initial value of this component. This value is generally set as a value-binding in the form #{myBean.myProperty}, where myProperty can be any data-type of Java (also user-defined data-types), if a converter for this data-type exists. Special cases: 1) f:selectItems - value needs to bind to a list (or an array) of javax.faces.model.SelectItem-instances 2) components implementing UISelectMany (e.g. h:selectManyCheckbox) - value needs to bind to a list (or an array) of values, where the values need to be of the same data-type as the choices of the associated f:selectItems-component 3) components implementing UIData (e.g. h:dataTable) - value needs to bind to a list (or an array) of values, which will be iterated over when the data-table is processed	String
valueChangeListener	A method binding EL expression, accepting a ValueChangeEvent parameter and returning void. The specified method is invoked if this component is modified. The phase that this handler is fired in can be controlled via the immediate attribute.	String

<h:inputTextarea>

Renders a HTML textarea element. Unless otherwise specified, all attributes accept static values or EL expressions. Can contain: JSP

Attributes

Name	Description	Type
accesskey	HTML: Sets the access key for this element.	String
binding	Identifies a backing bean property (of type UIComponent or appropriate subclass) to bind to this component instance. This value must be an EL expression.	String
cols	HTML: The width of this element, in characters.	String
converter	An expression that specifies the Converter for this component. If the value binding expression is a String, the String is used as an ID to look up a Converter. If the value binding expression is a Converter, uses that instance as the converter. The value can either be a static value (ID case only) or an EL expression.	String
datafld	Reserved for future use.	String
dataformatas	Reserved for future use.	String
datasrc	Reserved for future use.	String
dir	HTML: The direction of text display, either 'ltr' (left-to-right) or 'rtl' (right-to-left).	String
disabled	HTML: When true, this element cannot receive focus.	String
id	The developer-assigned ID of this component. The ID must be unique within the scope of the tag's enclosing naming container (e.g. h:form or f:subview). This value must be a static value.	String
immediate	A boolean value that identifies the phase during which value change events should fire. During normal event processing, value change events are fired during the "process validations" phase of request processing. If this attribute is set to "true", these methods are fired instead at the end of the "apply request values" phase.	String
lang	HTML: The base language of this document.	String
onblur	HTML: Specifies a script to be invoked when the element loses focus.	String
onchange	HTML: Specifies a script to be invoked when the element is modified.	String
onclick	HTML: Script to be invoked when the element is clicked.	String
ondblclick	HTML: Script to be invoked when the element is double-clicked.	String
onfocus	HTML: Specifies a script to be invoked when the element receives focus.	String
onkeydown	HTML: Script to be invoked when a key is pressed down over this element.	String
onkeypress	HTML: Script to be invoked when a key is pressed over this element.	String
onkeyup	HTML: Script to be invoked when a key is released over this element.	String
onmousedown	HTML: Script to be invoked when the pointing device is pressed over this element.	String
onmousemove	HTML: Script to be invoked when the pointing device is moved while it is in this element.	String
onmouseout	HTML: Script to be invoked when the pointing device is moves out of this element.	String
onmouseover	HTML: Script to be invoked when the pointing device is moved into this element.	String
onmouseup	HTML: Script to be invoked when the pointing device is released over this element.	String
onselect	HTML: Specifies a script to be invoked when the element is selected.	String
readonly	HTML: When true, indicates that this component cannot be modified by the user. The element may receive focus unless it has also been disabled.	String
rendered	A boolean value that indicates whether this component should be rendered. Default value: true.	String
required	A boolean value that indicates whether an input value is required. If this value is true, and no input value is provided, the error message javax.faces.component.UIInput.REQUIRED is posted.	String
rows	HTML: The height of this element, in characters.	String
style	HTML: CSS styling instructions.	String
styleClass	The CSS class for this element. Corresponds to the HTML 'class' attribute.	String
tabindex	HTML: Specifies the position of this element within the tab order of the document.	String
title	HTML: An advisory title for this element. Often used by the user agent as a tooltip.	String
validator	A method binding EL expression, accepting FacesContext, UIComponent, and Object parameters, and returning void, that validates the component's local value.	String
value	The initial value of this component. This value is generally set as a value-binding in the form #{myBean.myProperty}, where myProperty can be any data-type of Java (also user-defined data-types), if a converter for this data-type exists. Special cases: 1) f:selectItems - value needs to bind to a list (or an array) of javax.faces.model.SelectItem-instances 2) components implementing UISelectMany (e.g. h:selectManyCheckbox) - value needs to bind to a list (or an array) of values, where the values need to be of the same data-type as the choices of the associated f:selectItems-component 3) components implementing UIData (e.g. h:dataTable) - value needs to bind to a list (or an array) of values, which will be iterated over when the data-table is processed	String
valueChangeListener	A method binding EL expression, accepting a ValueChangeEvent parameter and returning void. The specified method is invoked if this component is modified. The phase that this handler is fired in can be controlled via the immediate attribute.	String

<h:message>

Renders the first FacesMessage that is assigned to the component referenced by the "for" attribute. Unless otherwise specified, all attributes accept static values or EL expressions. Can contain: JSP

Attributes

Name	Description	Type
binding	Identifies a backing bean property (of type UIComponent or appropriate subclass) to bind to this component instance. This value must be an EL expression.	String
dir	HTML: The direction of text display, either 'ltr' (left-to-right) or 'rtl' (right-to-left).	String
errorClass	CSS class to be used for messages with severity "ERROR".	String
errorStyle	CSS style to be used for messages with severity "ERROR".	String
fatalClass	CSS class to be used for messages with severity "FATAL".	String
fatalStyle	CSS style to be used for messages with severity "FATAL".	String
for*	An EL expression, returning a String, with the unique ID of the component for which messages should be displayed. This string has the same format as that accepted by the UIComponent.findComponent() method.	String
id	The developer-assigned ID of this component. The ID must be unique within the scope of the tag's enclosing naming container (e.g. h:form or f:subview). This value must be a static value.	String
infoClass	CSS class to be used for messages with severity "INFO".	String
infoStyle	CSS style to be used for messages with severity "INFO".	String
lang	HTML: The base language of this document.	String
onclick	HTML: Script to be invoked when the element is clicked.	String
ondblclick	HTML: Script to be invoked when the element is double-clicked.	String
onkeydown	HTML: Script to be invoked when a key is pressed down over this element.	String
onkeypress	HTML: Script to be invoked when a key is pressed over this element.	String
onkeyup	HTML: Script to be invoked when a key is released over this element.	String
onmousedown	HTML: Script to be invoked when the pointing device is pressed over this element.	String
onmousemove	HTML: Script to be invoked when the pointing device is moved while it is in this element.	String
onmouseout	HTML: Script to be invoked when the pointing device is moves out of this element.	String
onmouseover	HTML: Script to be invoked when the pointing device is moved into this element.	String
onmouseup	HTML: Script to be invoked when the pointing device is released over this element.	String
rendered	A boolean value that indicates whether this component should be rendered. Default value: true.	String
showDetail	An EL expression, returning a boolean, that controls whether the detail text of the associated messages is displayed. Default: false.	String
showSummary	An EL expression, returning a boolean, that controls whether the summary text of the associated messages is displayed. Default: true.	String
style	HTML: CSS styling instructions.	String
styleClass	The CSS class for this element. Corresponds to the HTML 'class' attribute.	String
title	HTML: An advisory title for this element. Often used by the user agent as a tooltip.	String
tooltip	If true, the message summary will be rendered as a tooltip (i.e. HTML title attribute).	String
warnClass	CSS class to be used for messages with severity "WARN".	String
warnStyle	CSS style to be used for messages with severity "WARN".	String

<h:messages>

Renders all or some FacesMessages depending on the "for" and "globalOnly" attributes: <ul> <li>If globalOnly = true, only global messages, that have no associated clientId, will be displayed.</li> <li>else if there is a "for" attribute, only messages that are assigned to the component referenced by the "for" attribute are displayed.</li> <li>else all messages are displayed.</li> </ul> Unless otherwise specified, all attributes accept static values or EL expressions. Can contain: JSP

Attributes

Name	Description	Type
binding	Identifies a backing bean property (of type UIComponent or appropriate subclass) to bind to this component instance. This value must be an EL expression.	String
dir	HTML: The direction of text display, either 'ltr' (left-to-right) or 'rtl' (right-to-left).	String
errorClass	CSS class to be used for messages with severity "ERROR".	String
errorStyle	CSS style to be used for messages with severity "ERROR".	String
fatalClass	CSS class to be used for messages with severity "FATAL".	String
fatalStyle	CSS style to be used for messages with severity "FATAL".	String
globalOnly	A boolean value that controls whether global messages (those without IDs) should be displayed. Default: true.	String
id	The developer-assigned ID of this component. The ID must be unique within the scope of the tag's enclosing naming container (e.g. h:form or f:subview). This value must be a static value.	String
infoClass	CSS class to be used for messages with severity "INFO".	String
infoStyle	CSS style to be used for messages with severity "INFO".	String
lang	HTML: The base language of this document.	String
layout	The layout: "table" or "list". Default: list	String
onclick	HTML: Script to be invoked when the element is clicked.	String
ondblclick	HTML: Script to be invoked when the element is double-clicked.	String
onkeydown	HTML: Script to be invoked when a key is pressed down over this element.	String
onkeypress	HTML: Script to be invoked when a key is pressed over this element.	String
onkeyup	HTML: Script to be invoked when a key is released over this element.	String
onmousedown	HTML: Script to be invoked when the pointing device is pressed over this element.	String
onmousemove	HTML: Script to be invoked when the pointing device is moved while it is in this element.	String
onmouseout	HTML: Script to be invoked when the pointing device is moves out of this element.	String
onmouseover	HTML: Script to be invoked when the pointing device is moved into this element.	String
onmouseup	HTML: Script to be invoked when the pointing device is released over this element.	String
rendered	A boolean value that indicates whether this component should be rendered. Default value: true.	String
showDetail	A boolean value that controls whether the detail text of the associated messages is displayed. Default: false.	String
showSummary	A boolean value that controls whether the summary text of the associated messages is displayed. Default: true.	String
style	HTML: CSS styling instructions.	String
styleClass	The CSS class for this element. Corresponds to the HTML 'class' attribute.	String
title	HTML: An advisory title for this element. Often used by the user agent as a tooltip.	String
tooltip	If true, the message summary will be rendered as a tooltip (i.e. HTML title attribute).	String
warnClass	CSS class to be used for messages with severity "WARN".	String
warnStyle	CSS style to be used for messages with severity "WARN".	String

<h:outputFormat>

Renders as text, applying the child f:param values to the value attribute as a MessageFormat string. If this element has an ID or CSS style properties, the text is wrapped in a span element. Unless otherwise specified, all attributes accept static values or EL expressions.

Can contain: JSP

Attributes

Name	Description	Type
binding	Identifies a backing bean property (of type UIComponent or appropriate subclass) to bind to this component instance. This value must be an EL expression.	String
converter	An expression that specifies the Converter for this component. If the value binding expression is a String, the String is used as an ID to look up a Converter. If the value binding expression is a Converter, uses that instance as the converter. The value can either be a static value (ID case only) or an EL expression.	String
dir	HTML: The direction of text display, either 'ltr' (left-to-right) or 'rtl' (right-to-left).	String
escape	Indicates whether rendered markup should be escaped. Default: true	String
id	The developer-assigned ID of this component. The ID must be unique within the scope of the tag's enclosing naming container (e.g. h:form or f:subview). This value must be a static value.	String
lang	HTML: The base language of this document.	String
onclick	HTML: Script to be invoked when the element is clicked.	String
ondblclick	HTML: Script to be invoked when the element is double-clicked.	String
onkeydown	HTML: Script to be invoked when a key is pressed down over this element.	String
onkeypress	HTML: Script to be invoked when a key is pressed over this element.	String
onkeyup	HTML: Script to be invoked when a key is released over this element.	String
onmousedown	HTML: Script to be invoked when the pointing device is pressed over this element.	String
onmousemove	HTML: Script to be invoked when the pointing device is moved while it is in this element.	String
onmouseout	HTML: Script to be invoked when the pointing device is moves out of this element.	String
onmouseover	HTML: Script to be invoked when the pointing device is moved into this element.	String
onmouseup	HTML: Script to be invoked when the pointing device is released over this element.	String
rendered	A boolean value that indicates whether this component should be rendered. Default value: true.	String
style	HTML: CSS styling instructions.	String
styleClass	The CSS class for this element. Corresponds to the HTML 'class' attribute.	String
title	HTML: An advisory title for this element. Often used by the user agent as a tooltip.	String
value	The initial value of this component. This value is generally set as a value-binding in the form #{myBean.myProperty}, where myProperty can be any data-type of Java (also user-defined data-types), if a converter for this data-type exists. Special cases: 1) f:selectItems - value needs to bind to a list (or an array) of javax.faces.model.SelectItem-instances 2) components implementing UISelectMany (e.g. h:selectManyCheckbox) - value needs to bind to a list (or an array) of values, where the values need to be of the same data-type as the choices of the associated f:selectItems-component 3) components implementing UIData (e.g. h:dataTable) - value needs to bind to a list (or an array) of values, which will be iterated over when the data-table is processed	String

<h:outputLabel>

Renders a HTML label element. In addition to the JSF specification, MyFaces allows it to directly give an output text via the "value" attribute. Unless otherwise specified, all attributes accept static values or EL expressions.

Can contain: JSP

Attributes

Name	Description	Type
accesskey	HTML: Sets the access key for this element.	String
binding	Identifies a backing bean property (of type UIComponent or appropriate subclass) to bind to this component instance. This value must be an EL expression.	String
converter	An expression that specifies the Converter for this component. If the value binding expression is a String, the String is used as an ID to look up a Converter. If the value binding expression is a Converter, uses that instance as the converter. The value can either be a static value (ID case only) or an EL expression.	String
dir	HTML: The direction of text display, either 'ltr' (left-to-right) or 'rtl' (right-to-left).	String
for	The client ID of the target input element of this label.	String
id	The developer-assigned ID of this component. The ID must be unique within the scope of the tag's enclosing naming container (e.g. h:form or f:subview). This value must be a static value.	String
lang	HTML: The base language of this document.	String
onblur	HTML: Specifies a script to be invoked when the element loses focus.	String
onclick	HTML: Script to be invoked when the element is clicked.	String
ondblclick	HTML: Script to be invoked when the element is double-clicked.	String
onfocus	HTML: Specifies a script to be invoked when the element receives focus.	String
onkeydown	HTML: Script to be invoked when a key is pressed down over this element.	String
onkeypress	HTML: Script to be invoked when a key is pressed over this element.	String
onkeyup	HTML: Script to be invoked when a key is released over this element.	String
onmousedown	HTML: Script to be invoked when the pointing device is pressed over this element.	String
onmousemove	HTML: Script to be invoked when the pointing device is moved while it is in this element.	String
onmouseout	HTML: Script to be invoked when the pointing device is moves out of this element.	String
onmouseover	HTML: Script to be invoked when the pointing device is moved into this element.	String
onmouseup	HTML: Script to be invoked when the pointing device is released over this element.	String
rendered	A boolean value that indicates whether this component should be rendered. Default value: true.	String
style	HTML: CSS styling instructions.	String
styleClass	The CSS class for this element. Corresponds to the HTML 'class' attribute.	String
tabindex	HTML: Specifies the position of this element within the tab order of the document.	String
title	HTML: An advisory title for this element. Often used by the user agent as a tooltip.	String
value	The initial value of this component. This value is generally set as a value-binding in the form #{myBean.myProperty}, where myProperty can be any data-type of Java (also user-defined data-types), if a converter for this data-type exists. Special cases: 1) f:selectItems - value needs to bind to a list (or an array) of javax.faces.model.SelectItem-instances 2) components implementing UISelectMany (e.g. h:selectManyCheckbox) - value needs to bind to a list (or an array) of values, where the values need to be of the same data-type as the choices of the associated f:selectItems-component 3) components implementing UIData (e.g. h:dataTable) - value needs to bind to a list (or an array) of values, which will be iterated over when the data-table is processed	String

<h:outputLink>

Renders a HTML a element. Child f:param elements are added to the href attribute as query parameters. Other children are rendered as the link text or image. Unless otherwise specified, all attributes accept static values or EL expressions.

Can contain: JSP

Attributes

Name	Description	Type
accesskey	HTML: Sets the access key for this element.	String
binding	Identifies a backing bean property (of type UIComponent or appropriate subclass) to bind to this component instance. This value must be an EL expression.	String
charset	HTML: Specifies the character encoding of the linked resource.	String
converter	An expression that specifies the Converter for this component. If the value binding expression is a String, the String is used as an ID to look up a Converter. If the value binding expression is a Converter, uses that instance as the converter. The value can either be a static value (ID case only) or an EL expression.	String
coords	HTML: The coordinates of regions within a client side image map.	String
dir	HTML: The direction of text display, either 'ltr' (left-to-right) or 'rtl' (right-to-left).	String
hreflang	HTML: The language of the linked resource.	String
id	The developer-assigned ID of this component. The ID must be unique within the scope of the tag's enclosing naming container (e.g. h:form or f:subview). This value must be a static value.	String
lang	HTML: The base language of this document.	String
onblur	HTML: Specifies a script to be invoked when the element loses focus.	String
onclick	HTML: Script to be invoked when the element is clicked.	String
ondblclick	HTML: Script to be invoked when the element is double-clicked.	String
onfocus	HTML: Specifies a script to be invoked when the element receives focus.	String
onkeydown	HTML: Script to be invoked when a key is pressed down over this element.	String
onkeypress	HTML: Script to be invoked when a key is pressed over this element.	String
onkeyup	HTML: Script to be invoked when a key is released over this element.	String
onmousedown	HTML: Script to be invoked when the pointing device is pressed over this element.	String
onmousemove	HTML: Script to be invoked when the pointing device is moved while it is in this element.	String
onmouseout	HTML: Script to be invoked when the pointing device is moves out of this element.	String
onmouseover	HTML: Script to be invoked when the pointing device is moved into this element.	String
onmouseup	HTML: Script to be invoked when the pointing device is released over this element.	String
rel	HTML: The relationship between the current document and the linked resource.	String
rendered	A boolean value that indicates whether this component should be rendered. Default value: true.	String
rev	HTML: The type(s) describing the reverse link for the linked resource.	String
shape	HTML: The shape of a region in a client side image map.	String
style	HTML: CSS styling instructions.	String
styleClass	The CSS class for this element. Corresponds to the HTML 'class' attribute.	String
tabindex	HTML: Specifies the position of this element within the tab order of the document.	String
target	HTML: Names the frame that should display content generated by invoking this action.	String
title	HTML: An advisory title for this element. Often used by the user agent as a tooltip.	String
type	HTML: A hint to the user agent about the content type of the linked resource.	String
value	The initial value of this component. This value is generally set as a value-binding in the form #{myBean.myProperty}, where myProperty can be any data-type of Java (also user-defined data-types), if a converter for this data-type exists. Special cases: 1) f:selectItems - value needs to bind to a list (or an array) of javax.faces.model.SelectItem-instances 2) components implementing UISelectMany (e.g. h:selectManyCheckbox) - value needs to bind to a list (or an array) of values, where the values need to be of the same data-type as the choices of the associated f:selectItems-component 3) components implementing UIData (e.g. h:dataTable) - value needs to bind to a list (or an array) of values, which will be iterated over when the data-table is processed	String

<h:outputText>

Renders the value of the associated UIOutput component. If this element has an ID or CSS style properties, the text is wrapped in a span element. Unless otherwise specified, all attributes accept static values or EL expressions.

Can contain: JSP

Attributes

Name	Description	Type
binding	Identifies a backing bean property (of type UIComponent or appropriate subclass) to bind to this component instance. This value must be an EL expression.	String
converter	An expression that specifies the Converter for this component. If the value binding expression is a String, the String is used as an ID to look up a Converter. If the value binding expression is a Converter, uses that instance as the converter. The value can either be a static value (ID case only) or an EL expression.	String
dir	HTML: The direction of text display, either 'ltr' (left-to-right) or 'rtl' (right-to-left).	String
escape	Indicates whether rendered markup should be escaped. Default: true	String
id	The developer-assigned ID of this component. The ID must be unique within the scope of the tag's enclosing naming container (e.g. h:form or f:subview). This value must be a static value.	String
lang	HTML: The base language of this document.	String
onclick	HTML: Script to be invoked when the element is clicked.	String
ondblclick	HTML: Script to be invoked when the element is double-clicked.	String
onkeydown	HTML: Script to be invoked when a key is pressed down over this element.	String
onkeypress	HTML: Script to be invoked when a key is pressed over this element.	String
onkeyup	HTML: Script to be invoked when a key is released over this element.	String
onmousedown	HTML: Script to be invoked when the pointing device is pressed over this element.	String
onmousemove	HTML: Script to be invoked when the pointing device is moved while it is in this element.	String
onmouseout	HTML: Script to be invoked when the pointing device is moves out of this element.	String
onmouseover	HTML: Script to be invoked when the pointing device is moved into this element.	String
onmouseup	HTML: Script to be invoked when the pointing device is released over this element.	String
rendered	A boolean value that indicates whether this component should be rendered. Default value: true.	String
style	HTML: CSS styling instructions.	String
styleClass	The CSS class for this element. Corresponds to the HTML 'class' attribute.	String
title	HTML: An advisory title for this element. Often used by the user agent as a tooltip.	String
value	The initial value of this component. This value is generally set as a value-binding in the form #{myBean.myProperty}, where myProperty can be any data-type of Java (also user-defined data-types), if a converter for this data-type exists. Special cases: 1) f:selectItems - value needs to bind to a list (or an array) of javax.faces.model.SelectItem-instances 2) components implementing UISelectMany (e.g. h:selectManyCheckbox) - value needs to bind to a list (or an array) of values, where the values need to be of the same data-type as the choices of the associated f:selectItems-component 3) components implementing UIData (e.g. h:dataTable) - value needs to bind to a list (or an array) of values, which will be iterated over when the data-table is processed	String

<h:panelGrid>

This element renders as an HTML table with specified number of columns. Children of this element are rendered as cells in the table, filling rows from left to right. Facets named "header" and "footer" are optional and specify the content of the thead and tfoot rows, respectively. Unless otherwise specified, all attributes accept static values or EL expressions.

Can contain: JSP

Attributes

Name	Description	Type
align	HTML: Specifies the horizontal alignment of this element. Deprecated in HTML 4.01.	String
bgcolor	HTML: The background color of this element.	String
binding	Identifies a backing bean property (of type UIComponent or appropriate subclass) to bind to this component instance. This value must be an EL expression.	String
border	HTML: Specifies the width of the border of this element, in pixels. Deprecated in HTML 4.01.	String
cellpadding	HTML: Specifies the amount of empty space between the cell border and its contents. It can be either a pixel length or a percentage.	String
cellspacing	HTML: Specifies the amount of space between the cells of the table. It can be either a pixel length or a percentage of available space.	String
columnClasses	A comma separated list of CSS class names to apply to td elements in each column.	String
columns	Specifies the number of columns in the grid.	String
datafld	Reserved for future use.	String
dataformatas	Reserved for future use.	String
datasrc	Reserved for future use.	String
dir	HTML: The direction of text display, either 'ltr' (left-to-right) or 'rtl' (right-to-left).	String
footerClass	The CSS class to be applied to footer cells.	String
frame	HTML: Controls what part of the frame that surrounds a table is visible. Values include: void, above, below, hsides, lhs, rhs, vsides, box, and border.	String
headerClass	The CSS class to be applied to header cells.	String
id	The developer-assigned ID of this component. The ID must be unique within the scope of the tag's enclosing naming container (e.g. h:form or f:subview). This value must be a static value.	String
lang	HTML: The base language of this document.	String
onclick	HTML: Script to be invoked when the element is clicked.	String
ondblclick	HTML: Script to be invoked when the element is double-clicked.	String
onkeydown	HTML: Script to be invoked when a key is pressed down over this element.	String
onkeypress	HTML: Script to be invoked when a key is pressed over this element.	String
onkeyup	HTML: Script to be invoked when a key is released over this element.	String
onmousedown	HTML: Script to be invoked when the pointing device is pressed over this element.	String
onmousemove	HTML: Script to be invoked when the pointing device is moved while it is in this element.	String
onmouseout	HTML: Script to be invoked when the pointing device is moves out of this element.	String
onmouseover	HTML: Script to be invoked when the pointing device is moved into this element.	String
onmouseup	HTML: Script to be invoked when the pointing device is released over this element.	String
rendered	A boolean value that indicates whether this component should be rendered. Default value: true.	String
rowClasses	A comma separated list of CSS class names to apply to td elements in each row.	String
rules	HTML: Controls how rules are rendered between cells. Values include: none, groups, rows, cols, and all.	String
style	HTML: CSS styling instructions.	String
styleClass	The CSS class for this element. Corresponds to the HTML 'class' attribute.	String
summary	HTML: Provides a summary of the contents of the table, for accessibility purposes.	String
title	HTML: An advisory title for this element. Often used by the user agent as a tooltip.	String
width	HTML: Specifies the desired width of the table, as a pixel length or a percentage of available space.	String

<h:panelGroup>

This element is used to group other components where the specification requires one child element. If any of the HTML or CSS attributes are set, its content is rendered within a span element. Unless otherwise specified, all attributes accept static values or EL expressions.

Can contain: JSP

Attributes

Name	Description	Type
binding	Identifies a backing bean property (of type UIComponent or appropriate subclass) to bind to this component instance. This value must be an EL expression.	String
dir	HTML: The direction of text display, either 'ltr' (left-to-right) or 'rtl' (right-to-left).	String
id	The developer-assigned ID of this component. The ID must be unique within the scope of the tag's enclosing naming container (e.g. h:form or f:subview). This value must be a static value.	String
lang	HTML: The base language of this document.	String
onclick	HTML: Script to be invoked when the element is clicked.	String
ondblclick	HTML: Script to be invoked when the element is double-clicked.	String
onkeydown	HTML: Script to be invoked when a key is pressed down over this element.	String
onkeypress	HTML: Script to be invoked when a key is pressed over this element.	String
onkeyup	HTML: Script to be invoked when a key is released over this element.	String
onmousedown	HTML: Script to be invoked when the pointing device is pressed over this element.	String
onmousemove	HTML: Script to be invoked when the pointing device is moved while it is in this element.	String
onmouseout	HTML: Script to be invoked when the pointing device is moves out of this element.	String
onmouseover	HTML: Script to be invoked when the pointing device is moved into this element.	String
onmouseup	HTML: Script to be invoked when the pointing device is released over this element.	String
rendered	A boolean value that indicates whether this component should be rendered. Default value: true.	String
style	HTML: CSS styling instructions.	String
styleClass	The CSS class for this element. Corresponds to the HTML 'class' attribute.	String
title	HTML: An advisory title for this element. Often used by the user agent as a tooltip.	String

<h:selectBooleanCheckbox>

Allow the user to choose a "true" or "false" value, presented as a checkbox. Renders as an HTML input tag with its type set to "checkbox", and its name attribute set to the id. The "checked" attribute is rendered if the value of this component is true. Unless otherwise specified, all attributes accept static values or EL expressions.

Can contain: JSP

Attributes

Name	Description	Type
accesskey	HTML: Sets the access key for this element.	String
alt	HTML: Specifies alternative text that can be used by a browser that can't show this element.	String
binding	Identifies a backing bean property (of type UIComponent or appropriate subclass) to bind to this component instance. This value must be an EL expression.	String
converter	An expression that specifies the Converter for this component. If the value binding expression is a String, the String is used as an ID to look up a Converter. If the value binding expression is a Converter, uses that instance as the converter. The value can either be a static value (ID case only) or an EL expression.	String
datafld	Reserved for future use.	String
dataformatas	Reserved for future use.	String
datasrc	Reserved for future use.	String
dir	HTML: The direction of text display, either 'ltr' (left-to-right) or 'rtl' (right-to-left).	String
disabled	HTML: When true, this element cannot receive focus.	String
id	The developer-assigned ID of this component. The ID must be unique within the scope of the tag's enclosing naming container (e.g. h:form or f:subview). This value must be a static value.	String
immediate	A boolean value that identifies the phase during which value change events should fire. During normal event processing, value change events are fired during the "process validations" phase of request processing. If this attribute is set to "true", these methods are fired instead at the end of the "apply request values" phase.	String
lang	HTML: The base language of this document.	String
onblur	HTML: Specifies a script to be invoked when the element loses focus.	String
onchange	HTML: Specifies a script to be invoked when the element is modified.	String
onclick	HTML: Script to be invoked when the element is clicked.	String
ondblclick	HTML: Script to be invoked when the element is double-clicked.	String
onfocus	HTML: Specifies a script to be invoked when the element receives focus.	String
onkeydown	HTML: Script to be invoked when a key is pressed down over this element.	String
onkeypress	HTML: Script to be invoked when a key is pressed over this element.	String
onkeyup	HTML: Script to be invoked when a key is released over this element.	String
onmousedown	HTML: Script to be invoked when the pointing device is pressed over this element.	String
onmousemove	HTML: Script to be invoked when the pointing device is moved while it is in this element.	String
onmouseout	HTML: Script to be invoked when the pointing device is moves out of this element.	String
onmouseover	HTML: Script to be invoked when the pointing device is moved into this element.	String
onmouseup	HTML: Script to be invoked when the pointing device is released over this element.	String
onselect	HTML: Specifies a script to be invoked when the element is selected.	String
readonly	HTML: When true, indicates that this component cannot be modified by the user. The element may receive focus unless it has also been disabled.	String
rendered	A boolean value that indicates whether this component should be rendered. Default value: true.	String
required	A boolean value that indicates whether an input value is required. If this value is true, and no input value is provided, the error message javax.faces.component.UIInput.REQUIRED is posted.	String
style	HTML: CSS styling instructions.	String
styleClass	The CSS class for this element. Corresponds to the HTML 'class' attribute.	String
tabindex	HTML: Specifies the position of this element within the tab order of the document.	String
title	HTML: An advisory title for this element. Often used by the user agent as a tooltip.	String
validator	A method binding EL expression, accepting FacesContext, UIComponent, and Object parameters, and returning void, that validates the component's local value.	String
value	The initial value of this component. This value is generally set as a value-binding in the form #{myBean.myProperty}, where myProperty can be any data-type of Java (also user-defined data-types), if a converter for this data-type exists. Special cases: 1) f:selectItems - value needs to bind to a list (or an array) of javax.faces.model.SelectItem-instances 2) components implementing UISelectMany (e.g. h:selectManyCheckbox) - value needs to bind to a list (or an array) of values, where the values need to be of the same data-type as the choices of the associated f:selectItems-component 3) components implementing UIData (e.g. h:dataTable) - value needs to bind to a list (or an array) of values, which will be iterated over when the data-table is processed	String
valueChangeListener	A method binding EL expression, accepting a ValueChangeEvent parameter and returning void. The specified method is invoked if this component is modified. The phase that this handler is fired in can be controlled via the immediate attribute.	String

<h:selectManyCheckbox>

Allow the user to select zero or more items from a set of available options. This is presented as a table with one cell per available option; each cell contains a checkbox and the option's label. The "layout" attribute determines whether the checkboxes are laid out horizontally or vertically. The set of available options is defined by adding child f:selectItem or f:selectItems components to this component. The value attribute must be a value-binding expression to a property of type List, Object array or primitive array. That "collection" is expected to contain objects of the same type as SelectItem.getValue() returns for the child SelectItem objects. On rendering, any child whose value is in the list will be selected initially. During the update phase, the property setter is called to replace the original collection with a completely new collection object of the appropriate type. The new collection object contains the value of each child SelectItem object that is currently selected. Unless otherwise specified, all attributes accept static values or EL expressions.

Can contain: JSP

Attributes

Name	Description	Type
accesskey	HTML: Sets the access key for this element.	String
alt	HTML: Specifies alternative text that can be used by a browser that can't show this element.	String
binding	Identifies a backing bean property (of type UIComponent or appropriate subclass) to bind to this component instance. This value must be an EL expression.	String
border	HTML: Specifies the width of the border of this element, in pixels. Deprecated in HTML 4.01.	String
converter	An expression that specifies the Converter for this component. If the value binding expression is a String, the String is used as an ID to look up a Converter. If the value binding expression is a Converter, uses that instance as the converter. The value can either be a static value (ID case only) or an EL expression.	String
datafld	Reserved for future use.	String
dataformatas	Reserved for future use.	String
datasrc	Reserved for future use.	String
dir	HTML: The direction of text display, either 'ltr' (left-to-right) or 'rtl' (right-to-left).	String
disabled	HTML: When true, this element cannot receive focus.	String
disabledClass	The CSS class assigned to the label element for enabled choices.	String
enabledClass	The CSS class assigned to the label element for enabled choices.	String
id	The developer-assigned ID of this component. The ID must be unique within the scope of the tag's enclosing naming container (e.g. h:form or f:subview). This value must be a static value.	String
immediate	A boolean value that identifies the phase during which value change events should fire. During normal event processing, value change events are fired during the "process validations" phase of request processing. If this attribute is set to "true", these methods are fired instead at the end of the "apply request values" phase.	String
lang	HTML: The base language of this document.	String
layout	Controls the layout direction of the child elements. Values include: lineDirection (vertical) and pageDirection (horzontal).	String
onblur	HTML: Specifies a script to be invoked when the element loses focus.	String
onchange	HTML: Specifies a script to be invoked when the element is modified.	String
onclick	HTML: Script to be invoked when the element is clicked.	String
ondblclick	HTML: Script to be invoked when the element is double-clicked.	String
onfocus	HTML: Specifies a script to be invoked when the element receives focus.	String
onkeydown	HTML: Script to be invoked when a key is pressed down over this element.	String
onkeypress	HTML: Script to be invoked when a key is pressed over this element.	String
onkeyup	HTML: Script to be invoked when a key is released over this element.	String
onmousedown	HTML: Script to be invoked when the pointing device is pressed over this element.	String
onmousemove	HTML: Script to be invoked when the pointing device is moved while it is in this element.	String
onmouseout	HTML: Script to be invoked when the pointing device is moves out of this element.	String
onmouseover	HTML: Script to be invoked when the pointing device is moved into this element.	String
onmouseup	HTML: Script to be invoked when the pointing device is released over this element.	String
onselect	HTML: Specifies a script to be invoked when the element is selected.	String
readonly	HTML: When true, indicates that this component cannot be modified by the user. The element may receive focus unless it has also been disabled.	String
rendered	A boolean value that indicates whether this component should be rendered. Default value: true.	String
required	A boolean value that indicates whether an input value is required. If this value is true, and no input value is provided, the error message javax.faces.component.UIInput.REQUIRED is posted.	String
style	HTML: CSS styling instructions.	String
styleClass	The CSS class for this element. Corresponds to the HTML 'class' attribute.	String
tabindex	HTML: Specifies the position of this element within the tab order of the document.	String
title	HTML: An advisory title for this element. Often used by the user agent as a tooltip.	String
validator	A method binding EL expression, accepting FacesContext, UIComponent, and Object parameters, and returning void, that validates the component's local value.	String
value	The initial value of this component. This value is generally set as a value-binding in the form #{myBean.myProperty}, where myProperty can be any data-type of Java (also user-defined data-types), if a converter for this data-type exists. Special cases: 1) f:selectItems - value needs to bind to a list (or an array) of javax.faces.model.SelectItem-instances 2) components implementing UISelectMany (e.g. h:selectManyCheckbox) - value needs to bind to a list (or an array) of values, where the values need to be of the same data-type as the choices of the associated f:selectItems-component 3) components implementing UIData (e.g. h:dataTable) - value needs to bind to a list (or an array) of values, which will be iterated over when the data-table is processed	String
valueChangeListener	A method binding EL expression, accepting a ValueChangeEvent parameter and returning void. The specified method is invoked if this component is modified. The phase that this handler is fired in can be controlled via the immediate attribute.	String

<h:selectManyListbox>

Allow the user to select zero or more items from a set of available options. This is presented as a listbox which allows multiple rows in the list to be selected simultaneously. The set of available options is defined by adding child f:selectItem or f:selectItems components to this component. The list is rendered as an HTML select element. The "multiple" attribute is set on the element and the size attribute is set to the provided value, defaulting to the number of items in the list if no value is provided. If the size is set to 1, then a "drop-down" list (aka "combo-box") is presented, though if this is the intention then a selectManyMenu should be used instead. The value attribute must be a value-binding expression to a property of type List, Object array or primitive array. That "collection" is expected to contain objects of the same type as SelectItem.getValue() returns for the child SelectItem objects. On rendering, any child whose value is in the list will be selected initially. During the update phase, the property is set to contain a "collection" of values for those child SelectItem objects that are currently selected. Unless otherwise specified, all attributes accept static values or EL expressions.

Can contain: JSP

Attributes

Name	Description	Type
accesskey	HTML: Sets the access key for this element.	String
binding	Identifies a backing bean property (of type UIComponent or appropriate subclass) to bind to this component instance. This value must be an EL expression.	String
converter	An expression that specifies the Converter for this component. If the value binding expression is a String, the String is used as an ID to look up a Converter. If the value binding expression is a Converter, uses that instance as the converter. The value can either be a static value (ID case only) or an EL expression.	String
datafld	Reserved for future use.	String
dataformatas	Reserved for future use.	String
datasrc	Reserved for future use.	String
dir	HTML: The direction of text display, either 'ltr' (left-to-right) or 'rtl' (right-to-left).	String
disabled	HTML: When true, this element cannot receive focus.	String
disabledClass		String
enabledClass		String
id	The developer-assigned ID of this component. The ID must be unique within the scope of the tag's enclosing naming container (e.g. h:form or f:subview). This value must be a static value.	String
immediate	A boolean value that identifies the phase during which value change events should fire. During normal event processing, value change events are fired during the "process validations" phase of request processing. If this attribute is set to "true", these methods are fired instead at the end of the "apply request values" phase.	String
lang	HTML: The base language of this document.	String
onblur	HTML: Specifies a script to be invoked when the element loses focus.	String
onchange	HTML: Specifies a script to be invoked when the element is modified.	String
onclick	HTML: Script to be invoked when the element is clicked.	String
ondblclick	HTML: Script to be invoked when the element is double-clicked.	String
onfocus	HTML: Specifies a script to be invoked when the element receives focus.	String
onkeydown	HTML: Script to be invoked when a key is pressed down over this element.	String
onkeypress	HTML: Script to be invoked when a key is pressed over this element.	String
onkeyup	HTML: Script to be invoked when a key is released over this element.	String
onmousedown	HTML: Script to be invoked when the pointing device is pressed over this element.	String
onmousemove	HTML: Script to be invoked when the pointing device is moved while it is in this element.	String
onmouseout	HTML: Script to be invoked when the pointing device is moves out of this element.	String
onmouseover	HTML: Script to be invoked when the pointing device is moved into this element.	String
onmouseup	HTML: Script to be invoked when the pointing device is released over this element.	String
onselect	HTML: Specifies a script to be invoked when the element is selected.	String
readonly	HTML: When true, indicates that this component cannot be modified by the user. The element may receive focus unless it has also been disabled.	String
rendered	A boolean value that indicates whether this component should be rendered. Default value: true.	String
required	A boolean value that indicates whether an input value is required. If this value is true, and no input value is provided, the error message javax.faces.component.UIInput.REQUIRED is posted.	String
size	see JSF Spec.	String
style	HTML: CSS styling instructions.	String
styleClass	The CSS class for this element. Corresponds to the HTML 'class' attribute.	String
tabindex	HTML: Specifies the position of this element within the tab order of the document.	String
title	HTML: An advisory title for this element. Often used by the user agent as a tooltip.	String
validator	A method binding EL expression, accepting FacesContext, UIComponent, and Object parameters, and returning void, that validates the component's local value.	String
value	The initial value of this component. This value is generally set as a value-binding in the form #{myBean.myProperty}, where myProperty can be any data-type of Java (also user-defined data-types), if a converter for this data-type exists. Special cases: 1) f:selectItems - value needs to bind to a list (or an array) of javax.faces.model.SelectItem-instances 2) components implementing UISelectMany (e.g. h:selectManyCheckbox) - value needs to bind to a list (or an array) of values, where the values need to be of the same data-type as the choices of the associated f:selectItems-component 3) components implementing UIData (e.g. h:dataTable) - value needs to bind to a list (or an array) of values, which will be iterated over when the data-table is processed	String
valueChangeListener	A method binding EL expression, accepting a ValueChangeEvent parameter and returning void. The specified method is invoked if this component is modified. The phase that this handler is fired in can be controlled via the immediate attribute.	String

<h:selectManyMenu>

Allow the user to select zero or more items from a set of available options. This is presented as a drop-down "combo-box" which allows multiple rows in the list to be selected simultaneously. The set of available options is defined by adding child f:selectItem or f:selectItems components to this component. Renders as an HTML select element, with the choices made up of child f:selectItem or f:selectItems elements. The multiple attribute is set and the size attribute is set to 1. The value attribute must be a value-binding expression to a property of type List, Object array or primitive array. That "collection" is expected to contain objects of the same type as SelectItem.getValue() returns for the child SelectItem objects. On rendering, any child whose value is in the list will be selected initially. During the update phase, the property is set to contain a "collection" of values for those child SelectItem objects that are currently selected. Unless otherwise specified, all attributes accept static values or EL expressions.

Can contain: JSP

Attributes

Name	Description	Type
accesskey	HTML: Sets the access key for this element.	String
binding	Identifies a backing bean property (of type UIComponent or appropriate subclass) to bind to this component instance. This value must be an EL expression.	String
converter	An expression that specifies the Converter for this component. If the value binding expression is a String, the String is used as an ID to look up a Converter. If the value binding expression is a Converter, uses that instance as the converter. The value can either be a static value (ID case only) or an EL expression.	String
datafld	Reserved for future use.	String
dataformatas	Reserved for future use.	String
datasrc	Reserved for future use.	String
dir	HTML: The direction of text display, either 'ltr' (left-to-right) or 'rtl' (right-to-left).	String
disabled	HTML: When true, this element cannot receive focus.	String
disabledClass		String
enabledClass		String
id	The developer-assigned ID of this component. The ID must be unique within the scope of the tag's enclosing naming container (e.g. h:form or f:subview). This value must be a static value.	String
immediate	A boolean value that identifies the phase during which value change events should fire. During normal event processing, value change events are fired during the "process validations" phase of request processing. If this attribute is set to "true", these methods are fired instead at the end of the "apply request values" phase.	String
lang	HTML: The base language of this document.	String
onblur	HTML: Specifies a script to be invoked when the element loses focus.	String
onchange	HTML: Specifies a script to be invoked when the element is modified.	String
onclick	HTML: Script to be invoked when the element is clicked.	String
ondblclick	HTML: Script to be invoked when the element is double-clicked.	String
onfocus	HTML: Specifies a script to be invoked when the element receives focus.	String
onkeydown	HTML: Script to be invoked when a key is pressed down over this element.	String
onkeypress	HTML: Script to be invoked when a key is pressed over this element.	String
onkeyup	HTML: Script to be invoked when a key is released over this element.	String
onmousedown	HTML: Script to be invoked when the pointing device is pressed over this element.	String
onmousemove	HTML: Script to be invoked when the pointing device is moved while it is in this element.	String
onmouseout	HTML: Script to be invoked when the pointing device is moves out of this element.	String
onmouseover	HTML: Script to be invoked when the pointing device is moved into this element.	String
onmouseup	HTML: Script to be invoked when the pointing device is released over this element.	String
onselect	HTML: Specifies a script to be invoked when the element is selected.	String
readonly	HTML: When true, indicates that this component cannot be modified by the user. The element may receive focus unless it has also been disabled.	String
rendered	A boolean value that indicates whether this component should be rendered. Default value: true.	String
required	A boolean value that indicates whether an input value is required. If this value is true, and no input value is provided, the error message javax.faces.component.UIInput.REQUIRED is posted.	String
style	HTML: CSS styling instructions.	String
styleClass	The CSS class for this element. Corresponds to the HTML 'class' attribute.	String
tabindex	HTML: Specifies the position of this element within the tab order of the document.	String
title	HTML: An advisory title for this element. Often used by the user agent as a tooltip.	String
validator	A method binding EL expression, accepting FacesContext, UIComponent, and Object parameters, and returning void, that validates the component's local value.	String
value	The initial value of this component. This value is generally set as a value-binding in the form #{myBean.myProperty}, where myProperty can be any data-type of Java (also user-defined data-types), if a converter for this data-type exists. Special cases: 1) f:selectItems - value needs to bind to a list (or an array) of javax.faces.model.SelectItem-instances 2) components implementing UISelectMany (e.g. h:selectManyCheckbox) - value needs to bind to a list (or an array) of values, where the values need to be of the same data-type as the choices of the associated f:selectItems-component 3) components implementing UIData (e.g. h:dataTable) - value needs to bind to a list (or an array) of values, which will be iterated over when the data-table is processed	String
valueChangeListener	A method binding EL expression, accepting a ValueChangeEvent parameter and returning void. The specified method is invoked if this component is modified. The phase that this handler is fired in can be controlled via the immediate attribute.	String

<h:selectOneListbox>

Allow the user to choose one option from a set of options. Rendered as a listbox with the MULTIPLE attribute set to false. The available choices are defined via child f:selectItem or f:selectItems elements. The size of the listbox defaults to the number of available choices; if size is explicitly set to a smaller value, then scrollbars will be rendered. If size is set to 1 then a "drop-down menu" (aka "combo-box") is rendered, though if this is the intent then selectOneMenu should be used instead. The value attribute of this component is read to determine which of the available options is initially selected; its value should match the "value" property of one of the child SelectItem objects. On submit of the enclosing form, the value attribute's bound property is updated to contain the "value" property from the chosen SelectItem. Unless otherwise specified, all attributes accept static values or EL expressions.

Can contain: JSP

Attributes

Name	Description	Type
accesskey	HTML: Sets the access key for this element.	String
binding	Identifies a backing bean property (of type UIComponent or appropriate subclass) to bind to this component instance. This value must be an EL expression.	String
converter	An expression that specifies the Converter for this component. If the value binding expression is a String, the String is used as an ID to look up a Converter. If the value binding expression is a Converter, uses that instance as the converter. The value can either be a static value (ID case only) or an EL expression.	String
datafld	Reserved for future use.	String
dataformatas	Reserved for future use.	String
datasrc	Reserved for future use.	String
dir	HTML: The direction of text display, either 'ltr' (left-to-right) or 'rtl' (right-to-left).	String
disabled	HTML: When true, this element cannot receive focus.	String
disabledClass		String
enabledClass		String
id	The developer-assigned ID of this component. The ID must be unique within the scope of the tag's enclosing naming container (e.g. h:form or f:subview). This value must be a static value.	String
immediate	A boolean value that identifies the phase during which value change events should fire. During normal event processing, value change events are fired during the "process validations" phase of request processing. If this attribute is set to "true", these methods are fired instead at the end of the "apply request values" phase.	String
lang	HTML: The base language of this document.	String
onblur	HTML: Specifies a script to be invoked when the element loses focus.	String
onchange	HTML: Specifies a script to be invoked when the element is modified.	String
onclick	HTML: Script to be invoked when the element is clicked.	String
ondblclick	HTML: Script to be invoked when the element is double-clicked.	String
onfocus	HTML: Specifies a script to be invoked when the element receives focus.	String
onkeydown	HTML: Script to be invoked when a key is pressed down over this element.	String
onkeypress	HTML: Script to be invoked when a key is pressed over this element.	String
onkeyup	HTML: Script to be invoked when a key is released over this element.	String
onmousedown	HTML: Script to be invoked when the pointing device is pressed over this element.	String
onmousemove	HTML: Script to be invoked when the pointing device is moved while it is in this element.	String
onmouseout	HTML: Script to be invoked when the pointing device is moves out of this element.	String
onmouseover	HTML: Script to be invoked when the pointing device is moved into this element.	String
onmouseup	HTML: Script to be invoked when the pointing device is released over this element.	String
onselect	HTML: Specifies a script to be invoked when the element is selected.	String
readonly	HTML: When true, indicates that this component cannot be modified by the user. The element may receive focus unless it has also been disabled.	String
rendered	A boolean value that indicates whether this component should be rendered. Default value: true.	String
required	A boolean value that indicates whether an input value is required. If this value is true, and no input value is provided, the error message javax.faces.component.UIInput.REQUIRED is posted.	String
size	see JSF Spec.	String
style	HTML: CSS styling instructions.	String
styleClass	The CSS class for this element. Corresponds to the HTML 'class' attribute.	String
tabindex	HTML: Specifies the position of this element within the tab order of the document.	String
title	HTML: An advisory title for this element. Often used by the user agent as a tooltip.	String
validator	A method binding EL expression, accepting FacesContext, UIComponent, and Object parameters, and returning void, that validates the component's local value.	String
value	The initial value of this component. This value is generally set as a value-binding in the form #{myBean.myProperty}, where myProperty can be any data-type of Java (also user-defined data-types), if a converter for this data-type exists. Special cases: 1) f:selectItems - value needs to bind to a list (or an array) of javax.faces.model.SelectItem-instances 2) components implementing UISelectMany (e.g. h:selectManyCheckbox) - value needs to bind to a list (or an array) of values, where the values need to be of the same data-type as the choices of the associated f:selectItems-component 3) components implementing UIData (e.g. h:dataTable) - value needs to bind to a list (or an array) of values, which will be iterated over when the data-table is processed	String
valueChangeListener	A method binding EL expression, accepting a ValueChangeEvent parameter and returning void. The specified method is invoked if this component is modified. The phase that this handler is fired in can be controlled via the immediate attribute.	String

<h:selectOneMenu>

Allow the user to choose one option from a set of options. Renders a drop-down menu (aka "combo-box") containing a set of choices, of which only one can be chosen at a time. The available choices are defined via child f:selectItem or f:selectItems elements. The value attribute of this component is read to determine which of the available options is initially selected; its value should match the "value" property of one of the child SelectItem objects. On submit of the enclosing form, the value attribute's bound property is updated to contain the "value" property from the chosen SelectItem. Unless otherwise specified, all attributes accept static values or EL expressions.

Can contain: JSP

Attributes

Name	Description	Type
accesskey	HTML: Sets the access key for this element.	String
binding	Identifies a backing bean property (of type UIComponent or appropriate subclass) to bind to this component instance. This value must be an EL expression.	String
converter	An expression that specifies the Converter for this component. If the value binding expression is a String, the String is used as an ID to look up a Converter. If the value binding expression is a Converter, uses that instance as the converter. The value can either be a static value (ID case only) or an EL expression.	String
datafld	Reserved for future use.	String
dataformatas	Reserved for future use.	String
datasrc	Reserved for future use.	String
dir	HTML: The direction of text display, either 'ltr' (left-to-right) or 'rtl' (right-to-left).	String
disabled	HTML: When true, this element cannot receive focus.	String
disabledClass		String
enabledClass		String
id	The developer-assigned ID of this component. The ID must be unique within the scope of the tag's enclosing naming container (e.g. h:form or f:subview). This value must be a static value.	String
immediate	A boolean value that identifies the phase during which value change events should fire. During normal event processing, value change events are fired during the "process validations" phase of request processing. If this attribute is set to "true", these methods are fired instead at the end of the "apply request values" phase.	String
lang	HTML: The base language of this document.	String
onblur	HTML: Specifies a script to be invoked when the element loses focus.	String
onchange	HTML: Specifies a script to be invoked when the element is modified.	String
onclick	HTML: Script to be invoked when the element is clicked.	String
ondblclick	HTML: Script to be invoked when the element is double-clicked.	String
onfocus	HTML: Specifies a script to be invoked when the element receives focus.	String
onkeydown	HTML: Script to be invoked when a key is pressed down over this element.	String
onkeypress	HTML: Script to be invoked when a key is pressed over this element.	String
onkeyup	HTML: Script to be invoked when a key is released over this element.	String
onmousedown	HTML: Script to be invoked when the pointing device is pressed over this element.	String
onmousemove	HTML: Script to be invoked when the pointing device is moved while it is in this element.	String
onmouseout	HTML: Script to be invoked when the pointing device is moves out of this element.	String
onmouseover	HTML: Script to be invoked when the pointing device is moved into this element.	String
onmouseup	HTML: Script to be invoked when the pointing device is released over this element.	String
onselect	HTML: Specifies a script to be invoked when the element is selected.	String
readonly	HTML: When true, indicates that this component cannot be modified by the user. The element may receive focus unless it has also been disabled.	String
rendered	A boolean value that indicates whether this component should be rendered. Default value: true.	String
required	A boolean value that indicates whether an input value is required. If this value is true, and no input value is provided, the error message javax.faces.component.UIInput.REQUIRED is posted.	String
style	HTML: CSS styling instructions.	String
styleClass	The CSS class for this element. Corresponds to the HTML 'class' attribute.	String
tabindex	HTML: Specifies the position of this element within the tab order of the document.	String
title	HTML: An advisory title for this element. Often used by the user agent as a tooltip.	String
validator	A method binding EL expression, accepting FacesContext, UIComponent, and Object parameters, and returning void, that validates the component's local value.	String
value	The initial value of this component. This value is generally set as a value-binding in the form #{myBean.myProperty}, where myProperty can be any data-type of Java (also user-defined data-types), if a converter for this data-type exists. Special cases: 1) f:selectItems - value needs to bind to a list (or an array) of javax.faces.model.SelectItem-instances 2) components implementing UISelectMany (e.g. h:selectManyCheckbox) - value needs to bind to a list (or an array) of values, where the values need to be of the same data-type as the choices of the associated f:selectItems-component 3) components implementing UIData (e.g. h:dataTable) - value needs to bind to a list (or an array) of values, which will be iterated over when the data-table is processed	String
valueChangeListener	A method binding EL expression, accepting a ValueChangeEvent parameter and returning void. The specified method is invoked if this component is modified. The phase that this handler is fired in can be controlled via the immediate attribute.	String

<h:selectOneRadio>

Allow the user to choose one option from a set of options. Renders as an HTML table element, containing an input element for each child f:selectItem or f:selectItems elements. The input elements are rendered as type radio. The value attribute of this component is read to determine which of the available options is initially selected; its value should match the "value" property of one of the child SelectItem objects. On submit of the enclosing form, the value attribute's bound property is updated to contain the "value" property from the chosen SelectItem. Unless otherwise specified, all attributes accept static values or EL expressions.

Can contain: JSP

Attributes

Name	Description	Type
accesskey	HTML: Sets the access key for this element.	String
alt	HTML: Specifies alternative text that can be used by a browser that can't show this element.	String
binding	Identifies a backing bean property (of type UIComponent or appropriate subclass) to bind to this component instance. This value must be an EL expression.	String
border	Width in pixels of the border to be drawn around the table containing the options list.	String
converter	An expression that specifies the Converter for this component. If the value binding expression is a String, the String is used as an ID to look up a Converter. If the value binding expression is a Converter, uses that instance as the converter. The value can either be a static value (ID case only) or an EL expression.	String
datafld	Reserved for future use.	String
dataformatas	Reserved for future use.	String
datasrc	Reserved for future use.	String
dir	HTML: The direction of text display, either 'ltr' (left-to-right) or 'rtl' (right-to-left).	String
disabled	HTML: When true, this element cannot receive focus.	String
disabledClass		String
enabledClass		String
id	The developer-assigned ID of this component. The ID must be unique within the scope of the tag's enclosing naming container (e.g. h:form or f:subview). This value must be a static value.	String
immediate	A boolean value that identifies the phase during which value change events should fire. During normal event processing, value change events are fired during the "process validations" phase of request processing. If this attribute is set to "true", these methods are fired instead at the end of the "apply request values" phase.	String
lang	HTML: The base language of this document.	String
layout	Orientation of the options list. Valid values are "pageDirection" for a vertical layout, or "lineDirection" for horizontal. The default value is "lineDirection".	String
onblur	HTML: Specifies a script to be invoked when the element loses focus.	String
onchange	HTML: Specifies a script to be invoked when the element is modified.	String
onclick	HTML: Script to be invoked when the element is clicked.	String
ondblclick	HTML: Script to be invoked when the element is double-clicked.	String
onfocus	HTML: Specifies a script to be invoked when the element receives focus.	String
onkeydown	HTML: Script to be invoked when a key is pressed down over this element.	String
onkeypress	HTML: Script to be invoked when a key is pressed over this element.	String
onkeyup	HTML: Script to be invoked when a key is released over this element.	String
onmousedown	HTML: Script to be invoked when the pointing device is pressed over this element.	String
onmousemove	HTML: Script to be invoked when the pointing device is moved while it is in this element.	String
onmouseout	HTML: Script to be invoked when the pointing device is moves out of this element.	String
onmouseover	HTML: Script to be invoked when the pointing device is moved into this element.	String
onmouseup	HTML: Script to be invoked when the pointing device is released over this element.	String
onselect	HTML: Specifies a script to be invoked when the element is selected.	String
readonly	HTML: When true, indicates that this component cannot be modified by the user. The element may receive focus unless it has also been disabled.	String
rendered	A boolean value that indicates whether this component should be rendered. Default value: true.	String
required	A boolean value that indicates whether an input value is required. If this value is true, and no input value is provided, the error message javax.faces.component.UIInput.REQUIRED is posted.	String
style	HTML: CSS styling instructions.	String
styleClass	The CSS class for this element. Corresponds to the HTML 'class' attribute.	String
tabindex	HTML: Specifies the position of this element within the tab order of the document.	String
title	HTML: An advisory title for this element. Often used by the user agent as a tooltip.	String
validator	A method binding EL expression, accepting FacesContext, UIComponent, and Object parameters, and returning void, that validates the component's local value.	String
value	The initial value of this component. This value is generally set as a value-binding in the form #{myBean.myProperty}, where myProperty can be any data-type of Java (also user-defined data-types), if a converter for this data-type exists. Special cases: 1) f:selectItems - value needs to bind to a list (or an array) of javax.faces.model.SelectItem-instances 2) components implementing UISelectMany (e.g. h:selectManyCheckbox) - value needs to bind to a list (or an array) of values, where the values need to be of the same data-type as the choices of the associated f:selectItems-component 3) components implementing UIData (e.g. h:dataTable) - value needs to bind to a list (or an array) of values, which will be iterated over when the data-table is processed	String
valueChangeListener	A method binding EL expression, accepting a ValueChangeEvent parameter and returning void. The specified method is invoked if this component is modified. The phase that this handler is fired in can be controlled via the immediate attribute.	String

MyFaces Projects

Project Documentation

Tag reference sheet

JSF core tag library.

<f:actionListener>

Attributes

<f:attribute>

Attributes

<f:convertDateTime>

Attributes

<f:convertNumber>

Attributes

<f:converter>

Attributes

<f:facet>

Attributes

<f:loadBundle>

Attributes

<f:param>

Attributes

<f:selectItem>

Attributes

<f:selectItems>

Attributes

<f:subview>

Attributes

<f:validateDoubleRange>

Attributes

<f:validateLength>

Attributes

<f:validateLongRange>

Attributes

<f:validator>

Attributes

<f:valueChangeListener>

Attributes

<f:verbatim>

Attributes

<f:view>

Attributes

JSF HTML tag library.

<h:column>

Attributes

<h:commandButton>

Attributes

<h:commandLink>

Attributes

<h:dataTable>

Attributes

<h:form>

Attributes

<h:graphicImage>

Attributes

<h:inputHidden>

Attributes

<h:inputSecret>

Attributes

<h:inputText>

Attributes

<h:inputTextarea>

Attributes

<h:message>

Attributes

<h:messages>

Attributes

<h:outputFormat>

Attributes

<h:outputLabel>

Attributes

<h:outputLink>

Attributes

<h:outputText>

Attributes

<h:panelGrid>

Attributes

<h:panelGroup>

Attributes

<h:selectBooleanCheckbox>

Attributes

<h:selectManyCheckbox>