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.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 Base class for components that provide a new "namespace" for the ids of their child components
- 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
- 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. <p> Unless otherwise specified, all attributes accept static values or EL expressions. </p>
Can contain: empty
<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> <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> <p> See the javadoc for UIComponent.getAttributes for more details. </p> <p> Unless otherwise specified, all attributes accept static values or EL expressions. </p>
Can contain: empty
<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. see Javadoc of <a href="http://java.sun.com/javaee/javaserverfaces/1.2/docs/api/index.html">JSF Specification</a>
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. see Javadoc of <a href="http://java.sun.com/javaee/javaserverfaces/1.2/docs/api/index.html">JSF Specification</a>
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 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
<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. see Javadoc of <a href="http://java.sun.com/javaee/javaserverfaces/1.2/docs/api/index.html">JSF Specification</a>
Can contain: JSP
<f:loadBundle>
Loads a resource bundle and saves it as a variable in the request scope. <p> Unless otherwise specified, all attributes accept static values or EL expressions. </p> <p> TODO: We should find a way to save loaded bundles in the state, because otherwise on the next request the bundle map will not be present before the render phase and value bindings that reference to the bundle will always log annoying "Variable 'xxx' could not be resolved" error messages. </p>
Can contain: empty
<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. </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 |
| id | Get a string which uniquely identifies this UIComponent within the scope of the nearest ancestor NamingContainer component. The id is not necessarily unique across all components in the current view. | String |
| name | The name under which the value is stored. | String |
| value | The value of this component. | 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. </p> <p> UISelectItem should be nestetd inside a UISelectMany or UISelectOne component, and results in the addition of a SelectItem instance to the list of available options for the parent component </p>
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 | The escape setting for the label of this selection item. | String |
| id | Get a string which uniquely identifies this UIComponent within the scope of the nearest ancestor NamingContainer component. The id is not necessarily unique across all components in the current view. | String |
| itemDescription | For use in development tools. | String |
| itemDisabled | Determine whether this item can be chosen by the user. When true, this item cannot be chosen by the user. If this method is ever called, then any EL-binding for the disabled property will be ignored. | String |
| itemLabel | The string which will be presented to the user for this option. | String |
| itemValue | The value for this Item. | String |
| value | The initial value of this component. | 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. </p> <p> UISelectItems should be nested inside a UISelectMany or UISelectOne component, and results in the addition of one ore more SelectItem instance to the list of available options for the parent component </p>
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 | Get a string which uniquely identifies this UIComponent within the scope of the nearest ancestor NamingContainer component. The id is not necessarily unique across all components in the current view. | String |
| value | The initial value of this component. | String |
<f:subview>
Base class for components that provide a new "namespace" for the ids of their child components. <p> See the javadocs for interface NamingContainer for further details. </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 |
| id* | Get a string which uniquely identifies this UIComponent within the scope of the nearest ancestor NamingContainer component. The id is not necessarily unique across all components in the current view. | 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. see Javadoc of <a href="http://java.sun.com/javaee/javaserverfaces/1.2/docs/api/index.html">JSF Specification</a>
Can contain: empty
<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. see Javadoc of <a href="http://java.sun.com/javaee/javaserverfaces/1.2/docs/api/index.html">JSF Specification</a>
Can contain: empty
<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. see Javadoc of <a href="http://java.sun.com/javaee/javaserverfaces/1.2/docs/api/index.html">JSF Specification</a>
Can contain: empty
<f:validator>
Creates a validator and associates it with the nearest parent UIComponent. <p> 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> <p> Commonly associated with an h:inputText entity, but may be applied to any input component. </p> <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> <p> Unless otherwise specified, all attributes accept static values or EL expressions. </p>
Can contain: empty
<f:valueChangeListener>
Adds the specified ValueChangeListener to the nearest parent UIComponent (which is expected to be a UIInput component). <p> 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> <p> Unless otherwise specified, all attributes accept static values or EL expressions. </p>
Can contain: empty
<f:view>
Creates a JSF View, which is a container that holds all of the components that are part of the view. <p> Unless otherwise specified, all attributes accept static values or EL expressions. </p> <p> See the javadoc for this class in the <a href="http://java.sun.com/j2ee/javaserverfaces/1.2/docs/api/index.html">JSF Specification</a> for further details. </p>
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 for this view. <p> Defaults to the default locale specified in the faces configuration file. </p> | String |
| renderKitId | Defines what renderkit should be used to render this view. | String |
JSF HTML tag library.
This tag library implements the standard JSF HTML 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
- 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>
Creates a UIComponent that represents a single column of data within a parent UIData component. <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 | Get a string which uniquely identifies this UIComponent within the scope of the nearest ancestor NamingContainer component. The id is not necessarily unique across all components in the current view. | 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.
Can contain: JSP
Attributes
| Name | Description | Type |
|---|---|---|
| accesskey | HTML: Sets the access key for this element. | String |
| action | The action to take when this command is invoked. <p> 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. </p> <p> 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. </p> | String |
| actionListener | 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 | Get a string which uniquely identifies this UIComponent within the scope of the nearest ancestor NamingContainer component. The id is not necessarily unique across all components in the current view. | 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. <p> 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. </p> | String |
| label | A display name for this component. | 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 |
| 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 text to display to the user for this command component. | String |
<h:commandLink>
This tag renders as an HTML a element.
Can contain: JSP
Attributes
| Name | Description | Type |
|---|---|---|
| accesskey | HTML: Sets the access key for this element. | String |
| action | The action to take when this command is invoked. <p> 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. </p> <p> 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. </p> | String |
| actionListener | 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 |
| disabled | When true, this element cannot receive focus. | String |
| hreflang | HTML: The language of the linked resource. | String |
| id | Get a string which uniquely identifies this UIComponent within the scope of the nearest ancestor NamingContainer component. The id is not necessarily unique across all components in the current view. | String |
| immediate | A boolean value that identifies the phase during which action events should fire. <p> 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. </p> | 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 text to display to the user for this command component. | String |
<h:dataTable>
This component renders an HTML table element. <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 | 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 |
| captionClass | A comma separated list of CSS class names to apply to all captions. If there 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 separating the classes with a space. | String |
| captionStyle | Gets The CSS class to be applied to the Caption. | 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 |
| dir | HTML: The direction of text display, either 'ltr' (left-to-right) or 'rtl' (right-to-left). | String |
| first | Defines the index of the first row to be displayed, starting from 0. | 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 | Get a string which uniquely identifies this UIComponent within the scope of the nearest ancestor NamingContainer component. The id is not necessarily unique across all components in the current view. | 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 | Defines the maximum number of rows of data to be displayed. <p> Specify zero to display all rows from the "first" row to the end of available data. </p> | 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. <p> The value referenced by the EL expression can be of any type. </p> <ul> <li>A value of type DataModel is used directly.</li> <li>Array-like parameters of type array-of-Object, java.util.List, java.sql.ResultSet or javax.servlet.jsp.jstl.sql.Result are wrapped in a corresponding DataModel that knows how to iterate over the elements.</li> <li>Other values are wrapped in a DataModel as a single row.</li> </ul> <p> Note in particular that unordered collections, eg Set are not supported. Therefore if the value expression references such an object then the table will be considered to contain just one element - the collection itself. </p> | String |
| var | Defines the name of the request-scope variable that will hold the current row during iteration. <p> During rendering of child components of this UIData, the variable with this name can be read to learn what the "rowData" object for the row currently being rendered is. </p> <p> This value must be a static value, ie an EL expression is not permitted. </p> | 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.
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 | Get a string which uniquely identifies this UIComponent within the scope of the nearest ancestor NamingContainer component. The id is not necessarily unique across all components in the current view. | 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 |
| prependId | 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. <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 | 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 | Get a string which uniquely identifies this UIComponent within the scope of the nearest ancestor NamingContainer component. The id is not necessarily unique across all components in the current view. | 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. <p> If the URL starts with a '/', it is relative to the context path of the web application. </p> | 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. <p> 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. </p> | String |
| converterMessage | Text to be displayed to the user as an error message when conversion of a submitted value to the target type fails. <p> </p> | String |
| id | Get a string which uniquely identifies this UIComponent within the scope of the nearest ancestor NamingContainer component. The id is not necessarily unique across all components in the current view. | String |
| immediate | A boolean value that identifies the phase during which action events should fire. <p> 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. </p> | 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. <p> If this value is true and no input value is provided by a postback operation, then the "requiredMessage" text is registered as a FacesMessage for the request, and validation fails. </p> <p> Default value: false. </p> | String |
| requiredMessage | Text to be displayed to the user as an error message when this component is marked as "required" but no input data is present during a postback (ie the user left the required field blank). | String |
| validator | A method-binding EL expression which is invoked during the validation phase for this component. <p> The invoked method is expected to check the submitted value for this component, and if not acceptable then report a validation error for the component. </p> <p> The method is expected to have the prototype </p> <code>public void aMethod(FacesContext, UIComponent,Object)</code> | String |
| validatorMessage | Text which will be shown if validation fails. | String |
| value | Gets 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. <p> The phase in which this method is invoked can be controlled via the immediate attribute. </p> | String |
<h:inputSecret>
Renders as an HTML input tag with its type set to "password".
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 |
| 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. <p> 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. </p> | String |
| converterMessage | Text to be displayed to the user as an error message when conversion of a submitted value to the target type fails. <p> </p> | 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 | Get a string which uniquely identifies this UIComponent within the scope of the nearest ancestor NamingContainer component. The id is not necessarily unique across all components in the current view. | String |
| immediate | A boolean value that identifies the phase during which action events should fire. <p> 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. </p> | String |
| label | A display name for this component. | 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. <p> If this value is true and no input value is provided by a postback operation, then the "requiredMessage" text is registered as a FacesMessage for the request, and validation fails. </p> <p> Default value: false. </p> | String |
| requiredMessage | Text to be displayed to the user as an error message when this component is marked as "required" but no input data is present during a postback (ie the user left the required field blank). | 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 which is invoked during the validation phase for this component. <p> The invoked method is expected to check the submitted value for this component, and if not acceptable then report a validation error for the component. </p> <p> The method is expected to have the prototype </p> <code>public void aMethod(FacesContext, UIComponent,Object)</code> | String |
| validatorMessage | Text which will be shown if validation fails. | String |
| value | Gets 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. <p> The phase in which this method is invoked can be controlled via the immediate attribute. </p> | String |
<h:inputText>
Renders a HTML input element.
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 |
| 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. <p> 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. </p> | String |
| converterMessage | Text to be displayed to the user as an error message when conversion of a submitted value to the target type fails. <p> </p> | 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 | Get a string which uniquely identifies this UIComponent within the scope of the nearest ancestor NamingContainer component. The id is not necessarily unique across all components in the current view. | String |
| immediate | A boolean value that identifies the phase during which action events should fire. <p> 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. </p> | String |
| label | A display name for this component. | 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. <p> If this value is true and no input value is provided by a postback operation, then the "requiredMessage" text is registered as a FacesMessage for the request, and validation fails. </p> <p> Default value: false. </p> | String |
| requiredMessage | Text to be displayed to the user as an error message when this component is marked as "required" but no input data is present during a postback (ie the user left the required field blank). | 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 which is invoked during the validation phase for this component. <p> The invoked method is expected to check the submitted value for this component, and if not acceptable then report a validation error for the component. </p> <p> The method is expected to have the prototype </p> <code>public void aMethod(FacesContext, UIComponent,Object)</code> | String |
| validatorMessage | Text which will be shown if validation fails. | String |
| value | Gets 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. <p> The phase in which this method is invoked can be controlled via the immediate attribute. </p> | String |
<h:inputTextarea>
Renders a HTML textarea element.
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. <p> 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. </p> | String |
| converterMessage | Text to be displayed to the user as an error message when conversion of a submitted value to the target type fails. <p> </p> | 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 | Get a string which uniquely identifies this UIComponent within the scope of the nearest ancestor NamingContainer component. The id is not necessarily unique across all components in the current view. | String |
| immediate | A boolean value that identifies the phase during which action events should fire. <p> 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. </p> | String |
| label | A display name for this component. | 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. <p> If this value is true and no input value is provided by a postback operation, then the "requiredMessage" text is registered as a FacesMessage for the request, and validation fails. </p> <p> Default value: false. </p> | String |
| requiredMessage | Text to be displayed to the user as an error message when this component is marked as "required" but no input data is present during a postback (ie the user left the required field blank). | 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 which is invoked during the validation phase for this component. <p> The invoked method is expected to check the submitted value for this component, and if not acceptable then report a validation error for the component. </p> <p> The method is expected to have the prototype </p> <code>public void aMethod(FacesContext, UIComponent,Object)</code> | String |
| validatorMessage | Text which will be shown if validation fails. | String |
| value | Gets 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. <p> The phase in which this method is invoked can be controlled via the immediate attribute. </p> | 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 | 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* | The ID of the component whose attached FacesMessage object (if present) should be diplayed by this component. <p> This is a required property on the component. </p> | String |
| id | Get a string which uniquely identifies this UIComponent within the scope of the nearest ancestor NamingContainer component. The id is not necessarily unique across all components in the current view. | 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 |
| 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 true. | String |
| showSummary | Specifies whether the summary information from the message should be shown. Defaults to false. | 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>
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 | 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 | Get a string which uniquely identifies this UIComponent within the scope of the nearest ancestor NamingContainer component. The id is not necessarily unique across all components in the current view. | 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 |
| 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 | 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.
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. <p> 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. </p> | 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 | Get a string which uniquely identifies this UIComponent within the scope of the nearest ancestor NamingContainer component. The id is not necessarily unique across all components in the current view. | String |
| lang | HTML: The base language of this document. | 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 | Gets 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.
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. <p> 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. </p> | 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 |
| for | The client ID of the target input element of this label. | String |
| id | Get a string which uniquely identifies this UIComponent within the scope of the nearest ancestor NamingContainer component. The id is not necessarily unique across all components in the current view. | 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 | Gets 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.
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. <p> 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. </p> | 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 |
| disabled | When true, this element cannot receive focus. | String |
| hreflang | HTML: The language of the linked resource. | String |
| id | Get a string which uniquely identifies this UIComponent within the scope of the nearest ancestor NamingContainer component. The id is not necessarily unique across all components in the current view. | 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 | Gets 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.
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. <p> 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. </p> | 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 | Get a string which uniquely identifies this UIComponent within the scope of the nearest ancestor NamingContainer component. The id is not necessarily unique across all components in the current view. | String |
| lang | HTML: The base language of this document. | 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 | Gets The initial value of this component. | String |
<h:panelGrid>
This element renders as an HTML table with specified number of columns. <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 | 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 |
| captionClass | A comma separated list of CSS class names to apply to all captions. If there 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 separating the classes with a space. | String |
| captionStyle | Gets The CSS class to be applied to the Caption. | 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 |
| 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 | Get a string which uniquely identifies this UIComponent within the scope of the nearest ancestor NamingContainer component. The id is not necessarily unique across all components in the current view. | 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.
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 | Get a string which uniquely identifies this UIComponent within the scope of the nearest ancestor NamingContainer component. The id is not necessarily unique across all components in the current view. | 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 | HTML: 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>
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. <p> 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. </p> | String |
| converterMessage | Text to be displayed to the user as an error message when conversion of a submitted value to the target type fails. <p> </p> | 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 | Get a string which uniquely identifies this UIComponent within the scope of the nearest ancestor NamingContainer component. The id is not necessarily unique across all components in the current view. | String |
| immediate | A boolean value that identifies the phase during which action events should fire. <p> 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. </p> | String |
| label | A display name for this component. | 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. <p> If this value is true and no input value is provided by a postback operation, then the "requiredMessage" text is registered as a FacesMessage for the request, and validation fails. </p> <p> Default value: false. </p> | String |
| requiredMessage | Text to be displayed to the user as an error message when this component is marked as "required" but no input data is present during a postback (ie the user left the required field blank). | 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 which is invoked during the validation phase for this component. <p> The invoked method is expected to check the submitted value for this component, and if not acceptable then report a validation error for the component. </p> <p> The method is expected to have the prototype </p> <code>public void aMethod(FacesContext, UIComponent,Object)</code> | String |
| validatorMessage | Text which will be shown if validation fails. | String |
| value | Gets 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. <p> The phase in which this method is invoked can be controlled via the immediate attribute. </p> | String |
<h:selectManyCheckbox>
Allow the user to select zero or more items from a set of available options. <p> 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. </p> <p> The set of available options is defined by adding child f:selectItem or f:selectItems components to this component. </p> <p> 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. </p>
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 |
| 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. <p> 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. </p> | String |
| converterMessage | Text to be displayed to the user as an error message when conversion of a submitted value to the target type fails. <p> </p> | 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 | Get a string which uniquely identifies this UIComponent within the scope of the nearest ancestor NamingContainer component. The id is not necessarily unique across all components in the current view. | String |
| immediate | A boolean value that identifies the phase during which action events should fire. <p> 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. </p> | String |
| label | A display name for this component. | 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. <p> If this value is true and no input value is provided by a postback operation, then the "requiredMessage" text is registered as a FacesMessage for the request, and validation fails. </p> <p> Default value: false. </p> | String |
| requiredMessage | Text to be displayed to the user as an error message when this component is marked as "required" but no input data is present during a postback (ie the user left the required field blank). | 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 which is invoked during the validation phase for this component. <p> The invoked method is expected to check the submitted value for this component, and if not acceptable then report a validation error for the component. </p> <p> The method is expected to have the prototype </p> <code>public void aMethod(FacesContext, UIComponent,Object)</code> | String |
| validatorMessage | Text which will be shown if validation fails. | String |
| value | Gets 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. <p> The phase in which this method is invoked can be controlled via the immediate attribute. </p> | 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. <p> The set of available options is defined by adding child f:selectItem or f:selectItems components to this component. </p> <p> 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. </p> <p> 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. </p>
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. <p> 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. </p> | String |
| converterMessage | Text to be displayed to the user as an error message when conversion of a submitted value to the target type fails. <p> </p> | 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 | Get a string which uniquely identifies this UIComponent within the scope of the nearest ancestor NamingContainer component. The id is not necessarily unique across all components in the current view. | String |
| immediate | A boolean value that identifies the phase during which action events should fire. <p> 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. </p> | String |
| label | A display name for this component. | 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. <p> If this value is true and no input value is provided by a postback operation, then the "requiredMessage" text is registered as a FacesMessage for the request, and validation fails. </p> <p> Default value: false. </p> | String |
| requiredMessage | Text to be displayed to the user as an error message when this component is marked as "required" but no input data is present during a postback (ie the user left the required field blank). | 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 which is invoked during the validation phase for this component. <p> The invoked method is expected to check the submitted value for this component, and if not acceptable then report a validation error for the component. </p> <p> The method is expected to have the prototype </p> <code>public void aMethod(FacesContext, UIComponent,Object)</code> | String |
| validatorMessage | Text which will be shown if validation fails. | String |
| value | Gets 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. <p> The phase in which this method is invoked can be controlled via the immediate attribute. </p> | 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. <p> The set of available options is defined by adding child f:selectItem or f:selectItems components to this component. </p> <p> 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. </p> <p> 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. </p>
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. <p> 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. </p> | String |
| converterMessage | Text to be displayed to the user as an error message when conversion of a submitted value to the target type fails. <p> </p> | 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 | Get a string which uniquely identifies this UIComponent within the scope of the nearest ancestor NamingContainer component. The id is not necessarily unique across all components in the current view. | String |
| immediate | A boolean value that identifies the phase during which action events should fire. <p> 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. </p> | String |
| label | A display name for this component. | 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. <p> If this value is true and no input value is provided by a postback operation, then the "requiredMessage" text is registered as a FacesMessage for the request, and validation fails. </p> <p> Default value: false. </p> | String |
| requiredMessage | Text to be displayed to the user as an error message when this component is marked as "required" but no input data is present during a postback (ie the user left the required field blank). | 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 which is invoked during the validation phase for this component. <p> The invoked method is expected to check the submitted value for this component, and if not acceptable then report a validation error for the component. </p> <p> The method is expected to have the prototype </p> <code>public void aMethod(FacesContext, UIComponent,Object)</code> | String |
| validatorMessage | Text which will be shown if validation fails. | String |
| value | Gets 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. <p> The phase in which this method is invoked can be controlled via the immediate attribute. </p> | String |
<h:selectOneListbox>
Allow the user to choose one option from a set of options. <p> Rendered as a listbox with the MULTIPLE attribute set to false. </p> <p> 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. </p> <p> 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. </p> <p> On submit of the enclosing form, the value attribute's bound property is updated to contain the "value" property from the chosen SelectItem. </p>
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. <p> 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. </p> | String |
| converterMessage | Text to be displayed to the user as an error message when conversion of a submitted value to the target type fails. <p> </p> | 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 | Get a string which uniquely identifies this UIComponent within the scope of the nearest ancestor NamingContainer component. The id is not necessarily unique across all components in the current view. | String |
| immediate | A boolean value that identifies the phase during which action events should fire. <p> 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. </p> | String |
| label | A display name for this component. | 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. <p> If this value is true and no input value is provided by a postback operation, then the "requiredMessage" text is registered as a FacesMessage for the request, and validation fails. </p> <p> Default value: false. </p> | String |
| requiredMessage | Text to be displayed to the user as an error message when this component is marked as "required" but no input data is present during a postback (ie the user left the required field blank). | 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 which is invoked during the validation phase for this component. <p> The invoked method is expected to check the submitted value for this component, and if not acceptable then report a validation error for the component. </p> <p> The method is expected to have the prototype </p> <code>public void aMethod(FacesContext, UIComponent,Object)</code> | String |
| validatorMessage | Text which will be shown if validation fails. | String |
| value | Gets 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. <p> The phase in which this method is invoked can be controlled via the immediate attribute. </p> | String |
<h:selectOneMenu>
Allow the user to choose one option from a set of options. <p> 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. </p> <p> 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. </p> <p> On submit of the enclosing form, the value attribute's bound property is updated to contain the "value" property from the chosen SelectItem. </p>
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. <p> 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. </p> | String |
| converterMessage | Text to be displayed to the user as an error message when conversion of a submitted value to the target type fails. <p> </p> | 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 | Get a string which uniquely identifies this UIComponent within the scope of the nearest ancestor NamingContainer component. The id is not necessarily unique across all components in the current view. | String |
| immediate | A boolean value that identifies the phase during which action events should fire. <p> 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. </p> | String |
| label | A display name for this component. | 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. <p> If this value is true and no input value is provided by a postback operation, then the "requiredMessage" text is registered as a FacesMessage for the request, and validation fails. </p> <p> Default value: false. </p> | String |
| requiredMessage | Text to be displayed to the user as an error message when this component is marked as "required" but no input data is present during a postback (ie the user left the required field blank). | 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 which is invoked during the validation phase for this component. <p> The invoked method is expected to check the submitted value for this component, and if not acceptable then report a validation error for the component. </p> <p> The method is expected to have the prototype </p> <code>public void aMethod(FacesContext, UIComponent,Object)</code> | String |
| validatorMessage | Text which will be shown if validation fails. | String |
| value | Gets 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. <p> The phase in which this method is invoked can be controlled via the immediate attribute. </p> | String |
<h:selectOneRadio>
Allow the user to choose one option from a set of options. <p> 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. </p> <p> 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. </p> <p> On submit of the enclosing form, the value attribute's bound property is updated to contain the "value" property from the chosen SelectItem. </p>
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 |
| 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. <p> 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. </p> | String |
| converterMessage | Text to be displayed to the user as an error message when conversion of a submitted value to the target type fails. <p> </p> | 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 | Get a string which uniquely identifies this UIComponent within the scope of the nearest ancestor NamingContainer component. The id is not necessarily unique across all components in the current view. | String |
| immediate | A boolean value that identifies the phase during which action events should fire. <p> 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. </p> | String |
| label | A display name for this component. | 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. <p> If this value is true and no input value is provided by a postback operation, then the "requiredMessage" text is registered as a FacesMessage for the request, and validation fails. </p> <p> Default value: false. </p> | String |
| requiredMessage | Text to be displayed to the user as an error message when this component is marked as "required" but no input data is present during a postback (ie the user left the required field blank). | 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 which is invoked during the validation phase for this component. <p> The invoked method is expected to check the submitted value for this component, and if not acceptable then report a validation error for the component. </p> <p> The method is expected to have the prototype </p> <code>public void aMethod(FacesContext, UIComponent,Object)</code> | String |
| validatorMessage | Text which will be shown if validation fails. | String |
| value | Gets 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. <p> The phase in which this method is invoked can be controlled via the immediate attribute. </p> | String |