Apache MyFaces
MyFaces Projects
Documentation
Project Documentation
Foundation

Tag reference sheet

Tag library reference for the following tag libraries:

f

This tag library implements the standard JSF core tags.

This is version 1.2.

  • 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
  • phaseListener Register a PhaseListener instance
  • 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
  • setPropertyActionListener
  • 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
binding Value binding expression that evaluates to an object that implements javax.faces.event.ActionListener. String
type The fully qualified class name of the ActionListener class. String

<f:attribute>

This tag associates an attribute with the nearest parent UIComponent. <p> 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. <p> 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. <p> See the javadoc for UIComponent.getAttributes for more details. <p> 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
binding A ValueExpression that evaluates to a DateTimeConverter. String
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
binding A ValueExpression that evaluates to a NumberConverter. String
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 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
binding A ValueExpression that evaluates to a Converter. String
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. <p> 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
name A String containing the name of the parameter. String
value The value of this parameter. String

<f:phaseListener>

Register a PhaseListener instance

Can contain: empty

Attributes

Name Description Type
binding Value binding expression that evaluates to a PhaseListener. String
type Class name of the PhaseListener to be created and registered. 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. <p> 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
escape Flag indicating that characters that are sensitive in the value of the <code>itemLabel</code> attribute must be escaped. This flag is set to "true" by default. 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. <p> 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:setPropertyActionListener>

Can contain: empty

Attributes

Name Description Type
target* ValueExpression for the destination of the value attribute. String
value* ValueExpression for the value of the target attribute. 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: JSP

Attributes

Name Description Type
binding A ValueExpression that evaluates to a DoubleRangeValidator. String
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: JSP

Attributes

Name Description Type
binding A ValueExpression that evaluates to a LenghtValidator. String
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: JSP

Attributes

Name Description Type
binding A ValueExpression that evaluates to a LongRangeValidator. String
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. <p> Commonly associated with an h:inputText entity, but may be applied to any input component. <p> 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 <i>method</i> (rather than a registered validation type, as this tag does). <p> Unless otherwise specified, all attributes accept static values or EL expressions.

Can contain: empty

Attributes

Name Description Type
binding A ValueExpression that evaluates to an implementation of the javax.faces.validator.Validator interface. String
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. <p> Unless otherwise specified, all attributes accept static values or EL expressions.

Can contain: empty

Attributes

Name Description Type
binding Value binding expression that evaluates to an implementation of the javax.faces.event.ValueChangeListener interface. String
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. <p> 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
rendered Flag indicating whether or not this component should be rendered (during Render Response Phase), or processed on any subsequent form submit. The default value for this property is true. 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
afterPhase MethodBinding pointing to a method that takes a javax.faces.event.PhaseEvent and returns void, called after every phase except for restore view. String
beforePhase MethodBinding pointing to a method that takes a javax.faces.event.PhaseEvent and returns void, called before every phase except for restore view. String
locale The locale of this view. Default: the default locale from the configuration file. String
renderKitId Id for the RenderKit to use when rendering this page. String

Apache MyFaces HTML

This tag library implements the standard JSF core tags.

This is version 1.2.

  • column Creates a UIComponent that represents a single column of data within a parent UIData component
  • commandButton This tag renders as an HTML input element
  • commandLink This tag renders as an HTML a element
  • dataTable This component renders 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 text displaying information about 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>

<p> Creates a UIComponent that represents a single column of data within a parent UIData component. </p> <p> This tag is commonly used as a child of the h:dataTable tag, to represent a column of data within an html table. It can be decorated with nested "header" and "footer" facets which cause the output of header and footer rows. </p> <p> The non-facet child components of this column are re-rendered on each table row to generate the content of the cell. Those child components can reference the "var" attribute of the containing h:dataTable to generate appropriate output for each row. </p>

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
footerClass CSS class to be used for the footer. String
headerClass CSS class to be used for the header. 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 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 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 The direction of text display, either 'ltr' (left-to-right) or 'rtl' (right-to-left). String
disabled 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 Absolute or relative URL of the image 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
label A diplay name for this component. String
lang The base language of this document. String
onblur Specifies a script to be invoked when the element loses focus. String
onchange Specifies a script to be invoked when the element is modified. String
onclick Script to be invoked when the element is clicked. String
ondblclick Script to be invoked when the element is double-clicked. String
onfocus Specifies a script to be invoked when the element receives focus. String
onkeydown Script to be invoked when a key is pressed down over this element. String
onkeypress Script to be invoked when a key is pressed over this element. String
onkeyup Script to be invoked when a key is released over this element. String
onmousedown Script to be invoked when the pointing device is pressed over this element. String
onmousemove Script to be invoked when the pointing device is moved while it is in this element. String
onmouseout Script to be invoked when the pointing device is moves out of this element. String
onmouseover Script to be invoked when the pointing device is moved into this element. String
onmouseup Script to be invoked when the pointing device is released over this element. String
onselect Specifies a script to be invoked when the element is selected. String
readonly 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
style CSS styling instructions. String
styleClass The CSS class for this element. Corresponds to the HTML 'class' attribute. String
tabindex Specifies the position of this element within the tab order of the document. String
title An advisory title for this element. Often used by the user agent as a tooltip. String
type 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 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 Specifies the character encoding of the linked resource. String
coords The position and the shape of the hotspot. String
dir The direction of text display, either 'ltr' (left-to-right) or 'rtl' (right-to-left). String
disabled When true, this element cannot receive focus. String
hreflang The language code for teh link. 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 The base language of this document. String
onblur Specifies a script to be invoked when the element loses focus. String
onclick Script to be invoked when the element is clicked. String
ondblclick Script to be invoked when the element is double-clicked. String
onfocus Specifies a script to be invoked when the element receives focus. String
onkeydown Script to be invoked when a key is pressed down over this element. String
onkeypress Script to be invoked when a key is pressed over this element. String
onkeyup Script to be invoked when a key is released over this element. String
onmousedown Script to be invoked when the pointing device is pressed over this element. String
onmousemove Script to be invoked when the pointing device is moved while it is in this element. String
onmouseout Script to be invoked when the pointing device is moves out of this element. String
onmouseover Script to be invoked when the pointing device is moved into this element. String
onmouseup Script to be invoked when the pointing device is released over this element. String
rel A space-separated list of links defining the relationship from the current document to the anchor specified by this hyperlink String
rendered A boolean value that indicates whether this component should be rendered. Default value: true. String
rev A space-separated list of Reverselinks. String
shape The shape of the hot spot on the screen (for use in client-side image maps). Valid values are: default (entire region); rect (rectangular region); circle (circular region); and poly (polygonal region). String
style CSS styling instructions. String
styleClass The CSS class for this element. Corresponds to the HTML 'class' attribute. String
tabindex Specifies the position of this element within the tab order of the document. String
target Names the frame that should display content generated by invoking this action. String
title An advisory title for this element. Often used by the user agent as a tooltip. String
type 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>

<p> This component renders an HTML table element. </p> <p> This component may have nested facets with names "header" and "footer" to specify header and footer rows. </p> <p> The non-facet children of this component are expected to be h:column components which describe the columns of the table. </p>

Can contain: JSP

Attributes

Name Description Type
bgcolor 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 Specifies the width of the border of this element, in pixels. Deprecated in HTML 4.01. String
captionClass A comma separated list of CSS class names to apply to all captions. If tere are less classes than the number of rows, apply the same sequence of classes to the remaining captions, so the pattern is repeated. More than one class can be applied to a row by separing the classes with a space. String
captionStyle The CSS class to be applied to the Caption. String
cellpadding 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 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. More than one class can be applied to a column by separing the classes with a space. I there are less classes than the number of columns, apply the same sequence of classes to the remaining columns. If there are more classes specified than the number of columns, ignore the last classes String
dir 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 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 The base language of this document. String
onclick Script to be invoked when the element is clicked. String
ondblclick Script to be invoked when the element is double-clicked. String
onkeydown Script to be invoked when a key is pressed down over this element. String
onkeypress Script to be invoked when a key is pressed over this element. String
onkeyup Script to be invoked when a key is released over this element. String
onmousedown Script to be invoked when the pointing device is pressed over this element. String
onmousemove Script to be invoked when the pointing device is moved while it is in this element. String
onmouseout Script to be invoked when the pointing device is moves out of this element. String
onmouseover Script to be invoked when the pointing device is moved into this element. String
onmouseup 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. If tere are less classes than the number of rows, apply the same sequence of classes to the remaining rows, so the pattern is repeated. More than one class can be applied to a row by separing the classes with a space. String
rows The number of rows to be displayed. Specify zero for all remaining rows in the table. String
rules Controls how rules are rendered between cells. Values include: none, groups, rows, cols, and all. String
style CSS styling instructions. String
styleClass The CSS class for this element. Corresponds to the HTML 'class' attribute. String
summary Provides a summary of the contents of the table, for accessibility purposes. String
title 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 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 Provides a comma-separated list of content types that the server processing this form can handle. String
acceptcharset 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 The direction of text display, either 'ltr' (left-to-right) or 'rtl' (right-to-left). String
enctype 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 The base language of this document. String
onclick Script to be invoked when the element is clicked. String
ondblclick Script to be invoked when the element is double-clicked. String
onkeydown Script to be invoked when a key is pressed down over this element. String
onkeypress Script to be invoked when a key is pressed over this element. String
onkeyup Script to be invoked when a key is released over this element. String
onmousedown Script to be invoked when the pointing device is pressed over this element. String
onmousemove Script to be invoked when the pointing device is moved while it is in this element. String
onmouseout Script to be invoked when the pointing device is moves out of this element. String
onmouseover Script to be invoked when the pointing device is moved into this element. String
onmouseup Script to be invoked when the pointing device is released over this element. String
onreset Script to be invoked when this form is reset. String
onsubmit Script to be invoked when this form is submitted. String
prependId Defines a flag indicating whether or not this form should prepend its id to its descendent's id during the clientId generation process. If this flag is not set, the default value is true. String
rendered A boolean value that indicates whether this component should be rendered. Default value: true. String
style CSS styling instructions. String
styleClass The CSS class for this element. Corresponds to the HTML 'class' attribute. String
target Names the frame that should display content generated by invoking this action. String
title An advisory title for this element. Often used by the user agent as a tooltip. String

<h:graphicImage>

<p>Renders an HTML img element.</p> <p> The value attribute specifies the url of the image to be displayed; see the documentation for attribute "url" for more details. </p>

Can contain: JSP

Attributes

Name Description Type
alt 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 The direction of text display, either 'ltr' (left-to-right) or 'rtl' (right-to-left). String
height 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 Specifies server-side image map handling for this image. String
lang The base language of this document. String
longdesc A link to a long description of the image. String
onclick Script to be invoked when the element is clicked. String
ondblclick Script to be invoked when the element is double-clicked. String
onkeydown Script to be invoked when a key is pressed down over this element. String
onkeypress Script to be invoked when a key is pressed over this element. String
onkeyup Script to be invoked when a key is released over this element. String
onmousedown Script to be invoked when the pointing device is pressed over this element. String
onmousemove Script to be invoked when the pointing device is moved while it is in this element. String
onmouseout Script to be invoked when the pointing device is moves out of this element. String
onmouseover Script to be invoked when the pointing device is moved into this element. String
onmouseup 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 CSS styling instructions. String
styleClass The CSS class for this element. Corresponds to the HTML 'class' attribute. String
title An advisory title for this element. Often used by the user agent as a tooltip. String
url <p> The URL of the image. If the URL starts with a '/', it is relative to the context path of the web application. </p> <p> This attribute is an alias for the "value" property. </p> String
usemap Specifies an image map to use with this image. String
value The value property of the UIGraphic String
width 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. The value can either be a static value (ID) or an EL expression. When a static id is specified, an instance of the converter type registered with that id is used. When this is an EL expression, the result of evaluating the expression must be an object that implements the Converter interface. String
converterMessage Text of the converter message. 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
rendered A boolean value that indicates whether this component should be rendered. Default value: true. String
required A boolean value that indicates whether a value is required. Default value: false. String
requiredMessage Text which will be shown if a required value is not submitted. String
validator A method which is invoked during the validation phase for this component. It is expected to check the submitted value for this component, and if not acceptable then report a validation error for the component. String
validatorMessage Text which will be shown, if validation fails. String
value The initial value of this component. String
valueChangeListener A method which is invoked during postback processing for the current view if the submitted value for this component is not equal to the value which the "value" expression for this component returns. The phase in which this method is invoked 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 Sets the access key for this element. String
alt Specifies alternative text that can be used by a browser that can't show this element. String
autocomplete If the value of this attribute is "off", render "off" as the value of the attribute. This indicates that the browser should disable its autocomplete feature for this component. This is useful for components that perform autocompletion and do not want the browser interfering. If this attribute is not set or the value is "on", render nothing. 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. The value can either be a static value (ID) or an EL expression. When a static id is specified, an instance of the converter type registered with that id is used. When this is an EL expression, the result of evaluating the expression must be an object that implements the Converter interface. String
converterMessage Text of the converter message. String
dir The direction of text display, either 'ltr' (left-to-right) or 'rtl' (right-to-left). String
disabled 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 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
label A diplay name for this component. String
lang The base language of this document. String
maxlength The maximum number of characters allowed to be entered. String
onblur Specifies a script to be invoked when the element loses focus. String
onchange Specifies a script to be invoked when the element is modified. String
onclick Script to be invoked when the element is clicked. String
ondblclick Script to be invoked when the element is double-clicked. String
onfocus Specifies a script to be invoked when the element receives focus. String
onkeydown Script to be invoked when a key is pressed down over this element. String
onkeypress Script to be invoked when a key is pressed over this element. String
onkeyup Script to be invoked when a key is released over this element. String
onmousedown Script to be invoked when the pointing device is pressed over this element. String
onmousemove Script to be invoked when the pointing device is moved while it is in this element. String
onmouseout Script to be invoked when the pointing device is moves out of this element. String
onmouseover Script to be invoked when the pointing device is moved into this element. String
onmouseup Script to be invoked when the pointing device is released over this element. String
onselect Specifies a script to be invoked when the element is selected. String
readonly 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 Flag indicating that any existing value in this field should be rendered when the form is created. Because this is a potential security risk, password values are not displayed by default. String
rendered A boolean value that indicates whether this component should be rendered. Default value: true. String
required A boolean value that indicates whether a value is required. Default value: false. String
requiredMessage Text which will be shown if a required value is not submitted. String
size The initial width of this control, in characters. String
style CSS styling instructions. String
styleClass The CSS class for this element. Corresponds to the HTML 'class' attribute. String
tabindex Specifies the position of this element within the tab order of the document. String
title An advisory title for this element. Often used by the user agent as a tooltip. String
validator A method which is invoked during the validation phase for this component. It is expected to check the submitted value for this component, and if not acceptable then report a validation error for the component. String
validatorMessage Text which will be shown, if validation fails. String
value The initial value of this component. String
valueChangeListener A method which is invoked during postback processing for the current view if the submitted value for this component is not equal to the value which the "value" expression for this component returns. The phase in which this method is invoked 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 Sets the access key for this element. String
alt Specifies alternative text that can be used by a browser that can't show this element. String
autocomplete If the value of this attribute is "off", render "off" as the value of the attribute. This indicates that the browser should disable its autocomplete feature for this component. This is useful for components that perform autocompletion and do not want the browser interfering. If this attribute is not set or the value is "on", render nothing. 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. The value can either be a static value (ID) or an EL expression. When a static id is specified, an instance of the converter type registered with that id is used. When this is an EL expression, the result of evaluating the expression must be an object that implements the Converter interface. String
converterMessage Text of the converter message. String
dir The direction of text display, either 'ltr' (left-to-right) or 'rtl' (right-to-left). String
disabled 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 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
label A diplay name for this component. String
lang The base language of this document. String
maxlength The maximum number of characters allowed to be entered. String
onblur Specifies a script to be invoked when the element loses focus. String
onchange Specifies a script to be invoked when the element is modified. String
onclick Script to be invoked when the element is clicked. String
ondblclick Script to be invoked when the element is double-clicked. String
onfocus Specifies a script to be invoked when the element receives focus. String
onkeydown Script to be invoked when a key is pressed down over this element. String
onkeypress Script to be invoked when a key is pressed over this element. String
onkeyup Script to be invoked when a key is released over this element. String
onmousedown Script to be invoked when the pointing device is pressed over this element. String
onmousemove Script to be invoked when the pointing device is moved while it is in this element. String
onmouseout Script to be invoked when the pointing device is moves out of this element. String
onmouseover Script to be invoked when the pointing device is moved into this element. String
onmouseup Script to be invoked when the pointing device is released over this element. String
onselect Specifies a script to be invoked when the element is selected. String
readonly 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 a value is required. Default value: false. String
requiredMessage Text which will be shown if a required value is not submitted. String
size The initial width of this control, in characters. String
style CSS styling instructions. String
styleClass The CSS class for this element. Corresponds to the HTML 'class' attribute. String
tabindex Specifies the position of this element within the tab order of the document. String
title An advisory title for this element. Often used by the user agent as a tooltip. String
validator A method which is invoked during the validation phase for this component. It is expected to check the submitted value for this component, and if not acceptable then report a validation error for the component. String
validatorMessage Text which will be shown, if validation fails. String
value The initial value of this component. String
valueChangeListener A method which is invoked during postback processing for the current view if the submitted value for this component is not equal to the value which the "value" expression for this component returns. The phase in which this method is invoked 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 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 The width of this element, in characters. String
converter An expression that specifies the Converter for this component. The value can either be a static value (ID) or an EL expression. When a static id is specified, an instance of the converter type registered with that id is used. When this is an EL expression, the result of evaluating the expression must be an object that implements the Converter interface. String
converterMessage Text of the converter message. String
dir The direction of text display, either 'ltr' (left-to-right) or 'rtl' (right-to-left). String
disabled 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 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
label A diplay name for this component. String
lang The base language of this document. String
onblur Specifies a script to be invoked when the element loses focus. String
onchange Specifies a script to be invoked when the element is modified. String
onclick Script to be invoked when the element is clicked. String
ondblclick Script to be invoked when the element is double-clicked. String
onfocus Specifies a script to be invoked when the element receives focus. String
onkeydown Script to be invoked when a key is pressed down over this element. String
onkeypress Script to be invoked when a key is pressed over this element. String
onkeyup Script to be invoked when a key is released over this element. String
onmousedown Script to be invoked when the pointing device is pressed over this element. String
onmousemove Script to be invoked when the pointing device is moved while it is in this element. String
onmouseout Script to be invoked when the pointing device is moves out of this element. String
onmouseover Script to be invoked when the pointing device is moved into this element. String
onmouseup Script to be invoked when the pointing device is released over this element. String
onselect Specifies a script to be invoked when the element is selected. String
readonly 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 a value is required. Default value: false. String
requiredMessage Text which will be shown if a required value is not submitted. String
rows The height of this element, in characters. String
style CSS styling instructions. String
styleClass The CSS class for this element. Corresponds to the HTML 'class' attribute. String
tabindex Specifies the position of this element within the tab order of the document. String
title An advisory title for this element. Often used by the user agent as a tooltip. String
validator A method which is invoked during the validation phase for this component. It is expected to check the submitted value for this component, and if not acceptable then report a validation error for the component. String
validatorMessage Text which will be shown, if validation fails. String
value The initial value of this component. String
valueChangeListener A method which is invoked during postback processing for the current view if the submitted value for this component is not equal to the value which the "value" expression for this component returns. The phase in which this method is invoked can be controlled via the immediate attribute. String

<h:message>

Renders text displaying information about the first FacesMessage that is assigned to the component referenced by the "for" attribute.

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 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* The ID of the component whose attached FacesMessage object (if present) should be diplayed by this component. 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 The base language of this document. String
rendered A boolean value that indicates whether this component should be rendered. Default value: true. String
showDetail Specifies whether the detailed information from the message should be shown. Default to false. String
showSummary Specifies whether the summary information from the message should be shown. Defaults to true. String
style CSS styling instructions. String
styleClass The CSS class for this element. Corresponds to the HTML 'class' attribute. String
title 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:<br> <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 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 Specifies whether only messages (FacesMessage objects) not associated with a specific component should be displayed, ie whether messages should be ignored if they are attached to a particular component. Defaults to false. 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 The base language of this document. String
layout The layout: "table" or "list". Default: list String
rendered A boolean value that indicates whether this component should be rendered. Default value: true. String
showDetail Specifies whether the detailed information from the message should be shown. Defaults to false. String
showSummary Specifies whether the summary information from the message should be shown. Defaults to true. String
style CSS styling instructions. String
styleClass The CSS class for this element. Corresponds to the HTML 'class' attribute. String
title 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. The value can either be a static value (ID) or an EL expression. When a static id is specified, an instance of the converter type registered with that id is used. When this is an EL expression, the result of evaluating the expression must be an object that implements the Converter interface. String
dir 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 The base language of this document. String
rendered A boolean value that indicates whether this component should be rendered. Default value: true. String
style CSS styling instructions. String
styleClass The CSS class for this element. Corresponds to the HTML 'class' attribute. String
title An advisory title for this element. Often used by the user agent as a tooltip. String
value The initial value of this component. 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 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. The value can either be a static value (ID) or an EL expression. When a static id is specified, an instance of the converter type registered with that id is used. When this is an EL expression, the result of evaluating the expression must be an object that implements the Converter interface. String
dir 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
for Client ID the label should be displayed for. 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 The base language of this document. String
onblur Specifies a script to be invoked when the element loses focus. String
onclick Script to be invoked when the element is clicked. String
ondblclick Script to be invoked when the element is double-clicked. String
onfocus Specifies a script to be invoked when the element receives focus. String
onkeydown Script to be invoked when a key is pressed down over this element. String
onkeypress Script to be invoked when a key is pressed over this element. String
onkeyup Script to be invoked when a key is released over this element. String
onmousedown Script to be invoked when the pointing device is pressed over this element. String
onmousemove Script to be invoked when the pointing device is moved while it is in this element. String
onmouseout Script to be invoked when the pointing device is moves out of this element. String
onmouseover Script to be invoked when the pointing device is moved into this element. String
onmouseup 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 CSS styling instructions. String
styleClass The CSS class for this element. Corresponds to the HTML 'class' attribute. String
tabindex Specifies the position of this element within the tab order of the document. String
title An advisory title for this element. Often used by the user agent as a tooltip. String
value The initial value of this component. 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 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 Specifies the character encoding of the linked resource. String
converter An expression that specifies the Converter for this component. The value can either be a static value (ID) or an EL expression. When a static id is specified, an instance of the converter type registered with that id is used. When this is an EL expression, the result of evaluating the expression must be an object that implements the Converter interface. String
coords The position and the shape of the hotspot. String
dir The direction of text display, either 'ltr' (left-to-right) or 'rtl' (right-to-left). String
disabled When true, this element cannot receive focus. String
hreflang The language code for teh link. 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 The base language of this document. String
onblur Specifies a script to be invoked when the element loses focus. String
onclick Script to be invoked when the element is clicked. String
ondblclick Script to be invoked when the element is double-clicked. String
onfocus Specifies a script to be invoked when the element receives focus. String
onkeydown Script to be invoked when a key is pressed down over this element. String
onkeypress Script to be invoked when a key is pressed over this element. String
onkeyup Script to be invoked when a key is released over this element. String
onmousedown Script to be invoked when the pointing device is pressed over this element. String
onmousemove Script to be invoked when the pointing device is moved while it is in this element. String
onmouseout Script to be invoked when the pointing device is moves out of this element. String
onmouseover Script to be invoked when the pointing device is moved into this element. String
onmouseup Script to be invoked when the pointing device is released over this element. String
rel A space-separated list of links defining the relationship from the current document to the anchor specified by this hyperlink String
rendered A boolean value that indicates whether this component should be rendered. Default value: true. String
rev A space-separated list of Reverselinks. String
shape The shape of the hot spot on the screen (for use in client-side image maps). Valid values are: default (entire region); rect (rectangular region); circle (circular region); and poly (polygonal region). String
style CSS styling instructions. String
styleClass The CSS class for this element. Corresponds to the HTML 'class' attribute. String
tabindex Specifies the position of this element within the tab order of the document. String
target Names the frame that should display content generated by invoking this action. String
title An advisory title for this element. Often used by the user agent as a tooltip. String
type A hint to the user agent about the content type of the linked resource. String
value The initial value of this component. 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. The value can either be a static value (ID) or an EL expression. When a static id is specified, an instance of the converter type registered with that id is used. When this is an EL expression, the result of evaluating the expression must be an object that implements the Converter interface. String
dir 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 The base language of this document. String
rendered A boolean value that indicates whether this component should be rendered. Default value: true. String
style CSS styling instructions. String
styleClass The CSS class for this element. Corresponds to the HTML 'class' attribute. String
title An advisory title for this element. Often used by the user agent as a tooltip. String
value The initial value of this component. String

<h:panelGrid>

<p> This element renders as an HTML table with specified number of columns. </p> <p> 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. </p>

Can contain: JSP

Attributes

Name Description Type
bgcolor 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 Specifies the width of the border of this element, in pixels. Deprecated in HTML 4.01. String
captionClass CSS class to be used for the caption. String
captionStyle CSS style to be used for the caption. String
cellpadding 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 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. The first item in the list gets applied to the first column, the second item in the list gets applied to the second column, etc. After all entries in the list have been used, the list repeats again. String
columns Specifies the number of columns in the grid. String
dir The direction of text display, either 'ltr' (left-to-right) or 'rtl' (right-to-left). String
footerClass CSS class to be used for the footer. String
frame 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 CSS class to be used for the header. 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 The base language of this document. String
onclick Script to be invoked when the element is clicked. String
ondblclick Script to be invoked when the element is double-clicked. String
onkeydown Script to be invoked when a key is pressed down over this element. String
onkeypress Script to be invoked when a key is pressed over this element. String
onkeyup Script to be invoked when a key is released over this element. String
onmousedown Script to be invoked when the pointing device is pressed over this element. String
onmousemove Script to be invoked when the pointing device is moved while it is in this element. String
onmouseout Script to be invoked when the pointing device is moves out of this element. String
onmouseover Script to be invoked when the pointing device is moved into this element. String
onmouseup 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. The first item in the list gets applied to the first row, the second item in the list gets applied to the second row, etc. After all entries in the list have been used, the list repeats again. String
rules Controls how rules are rendered between cells. Values include: none, groups, rows, cols, and all. String
style CSS styling instructions. String
styleClass The CSS class for this element. Corresponds to the HTML 'class' attribute. String
summary Provides a summary of the contents of the table, for accessibility purposes. String
title An advisory title for this element. Often used by the user agent as a tooltip. String
width 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
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
layout The type of layout markup to use when rendering this group. If the value is "block" the renderer must produce an HTML "div" element. Otherwise HTML "span" element must be produced. String
rendered A boolean value that indicates whether this component should be rendered. Default value: true. String
style CSS styling instructions. String
styleClass The CSS class for this element. Corresponds to the HTML 'class' attribute. String

<h:selectBooleanCheckbox>

Allow the user to choose a "true" or "false" value, presented as a checkbox. <p> 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. <p> Unless otherwise specified, all attributes accept static values or EL expressions.

Can contain: JSP

Attributes

Name Description Type
accesskey 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. The value can either be a static value (ID) or an EL expression. When a static id is specified, an instance of the converter type registered with that id is used. When this is an EL expression, the result of evaluating the expression must be an object that implements the Converter interface. String
converterMessage Text of the converter message. String
dir The direction of text display, either 'ltr' (left-to-right) or 'rtl' (right-to-left). String
disabled 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 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
label A diplay name for this component. String
lang The base language of this document. String
onblur Specifies a script to be invoked when the element loses focus. String
onchange Specifies a script to be invoked when the element is modified. String
onclick Script to be invoked when the element is clicked. String
ondblclick Script to be invoked when the element is double-clicked. String
onfocus Specifies a script to be invoked when the element receives focus. String
onkeydown Script to be invoked when a key is pressed down over this element. String
onkeypress Script to be invoked when