Foundation

Tag reference sheet

Tag library reference for the following tag libraries:

Tomahawk tag library 1.2.

MyFaces subproject that contains components and other goodies to be used with any JSF implementation.

This is version 1.1.7.

  • aliasBean The aliasBean tag allows you to create a temporary name for a real bean
  • aliasBeansScope Holds several aliases that are configured by aliasBean tags
  • buffer A component that renders its child components into an in-memory buffer rather than render them directly to the response stream
  • captcha
  • checkbox Renders a HTML input of type "checkbox"
  • collapsiblePanel A component which just renders as a single icon (with optional label) when "collapsed", hiding all child components
  • column A tag that extend h:column to provide HTML passthrough attributes
  • columns The tag allows dynamic columns in a datatable
  • commandButton Extends standard commandButton by user role support
  • commandLink Extends standard commandLink by user role support and the HTML target attribute
  • commandNavigation Command, that represents a navigation item
  • commandNavigation2 Must be nested inside a panel_navigation action and renders a clickable navigation item
  • commandSortHeader Clickable sort column header
  • dataList Similar to dataTable, but does not render a table
  • dataScroller Scroller for UIData components eg
  • dataTable The MyFacesDataTable extends the standard JSF DataTable by two important features: Possiblity to save the state of the DataModel
  • div Places a div around its children
  • document Document to enclose the whole document
  • documentBody Document to enclose the document body
  • documentHead Document to enclose the document head
  • dojoInitializer Default component for the dojo intializer This component is purely non visual, and serves for quick hacking, and prototyping the dojo toolkit within verbatimed html
  • fieldset Renders an HTML Fieldset
  • graphicImage Extends standard graphicImage
  • headerLink Link used to collapse or expand a t:collapsiblePanel
  • htmlTag Creates an arbitrary HTML tag which encloses any child components
  • iconProvider
  • inputCalendar Provides a calendar
  • inputDate Custom input control for dates and times
  • inputFileUpload Creates a file-selection widget in the rendered page which allows a user to select a file for uploading to the server
  • inputHidden Extended version of {@link javax
  • inputHtml HTML Editor using the kupu library
  • inputSecret Extends standard inputSecret, adding the "redisplay" property
  • inputText Extends standard inputText by user role support
  • inputTextHelp Extends standard inputText by helptext support
  • inputTextarea Extends standard inputTextarea by user role support
  • jsValueChangeListener Value change listener on client side
  • jsValueSet Setting a value from the model in java-script so that it can be used (e
  • jscookMenu Renders a Javascript Menu
  • message MyFaces extension to the standard messages tag: see summaryDetailSeparator attribute
  • messages MyFaces extension to the standard messages tag: see showInputLabel attribute
  • navigationMenuItem A menu item
  • navigationMenuItems A tree of menu items as returned by a value-expression
  • newspaperTable Model for a table in multiple balanced columns
  • outputLabel Extends standard outputLabel with user role support
  • outputText Extends standard outputText with user role support
  • panelGrid Extends standard panelGrid with user role support
  • panelGroup Extends standard panelGroup with user role support
  • panelLayout Determines where its children are positioned within the page relative to each other, similar to a Swing layout component
  • panelNavigation Renders a vertical menu structure with support for nested menu items
  • panelNavigation2 Renders a vertical menu structure with support for nested menu items
  • panelStack A stack of panels, to switch panels dynamically
  • panelTab TODO: Document this component
  • panelTabbedPane TODO: Document this component
  • popup Renders a popup which displays on a mouse event
  • radio This tag is used in conjunction with the extended selectOneRadio tag when the "spread" layout is selected
  • saveState Provides the ability to store a model value inside the view's component tree
  • schedule A schedule component similar to the ones found in Outlook or Evolution Renders a schedule component, showing appointments and events in a day, workweek, week or month view, similar to the schedule part of MS Outlook or Evolution
  • selectBooleanCheckbox Extends standard selectBooleanCheckbox with user role support
  • selectItems An extended version of the standard UISelectItems
  • selectManyCheckbox Extends standard selectManyCheckbox with user role support
  • selectManyListbox Extends standard selectManyListbox with user role support
  • selectManyMenu Extends standard selectManyMenu with user role support
  • selectManyPicklist A picklist component that allows to select items from one list to another In other words, is a selection component where a set of items can be selected from a list that contains all the available items to a list that contains the selected items
  • selectOneCountry A localized list of countries choose box
  • selectOneLanguage A localized list of languages choose box
  • selectOneListbox Extends standard selectOneListbox with user role support
  • selectOneMenu Extends standard selectOneMenu with user role support
  • selectOneRadio Implements the standard html selectOneRadio tag, with additional features
  • selectOneRow Enhancement for a data-table to select one Row with a radio button
  • stylesheet Renders the path to a common CSS-file
  • subform A SubForm which will allow for partial validation and model update
  • swapImage Unless otherwise specified, all attributes accept static values or EL expressions
  • tabChangeListener Tag to add a tab change listeners to a {@link org
  • toggleGroup Container class allows user to toggle between view/edit mode
  • toggleLink Extends standard outputLink but links to a dynamically rendered resource (image, file,
  • togglePanel Container class allows user to toggle between view/edit mode
  • tree A tree data component
  • tree2 Represents "tree data" in an HTML format
  • treeCheckbox Renders a HTML input of type "treeCheckbox"
  • treeColumn Renders a HTML input of type "treeColumn"
  • treeSelectionListener Tag to add a tree selection listeners to a {@link HtmlTree}
  • updateActionListener Registers an org
  • validateCreditCard A custom validator for creditCards, based upon Jakarta Commons
  • validateEmail A custom validator for email address format, based upons Jakarta Commons
  • validateEqual A custom validator for validations against foreign component values
  • validateRegExpr A custom validator for reg
  • xmlTransform Transforms XML using and XSL stylesheet

Required attributes are marked with a *

<t:aliasBean>

The aliasBean tag allows you to create a temporary name for a real bean. The temporary name exists (is visible) only to the children of the aliasBean. <p> One use of this feature is to pass "parameters" from an including page to an included one. The included page can use any name it desires for beans it needs to reference, and the including page can then use aliasBean to make those names refer to the beans it wishes to "pass" as parameters. </p> <p> Suppose you have a block of components you use often but with different beans. You can create a separate JSP page (or equivalent) containing these beans, where the value-bindings refer to some fictive bean name. Document these names as the required "parameters" for this JSP page. Wherever you wish to use this block you then declare an alias component mapping each of these "parameters" to whatever beans (or literal values) you really want to apply the block to, then use jsp:include (or equivalent) to include the reusable block of components. </p> <p> Note, however, that AliasBean does not work for component bindings; JSF1.1 just has no mechanism available to set up the alias during the "restore view" phase while the bindings of its children are being re-established, and then remove the alias after the child bindings are done. </p> <p> As a special case, if this component's direct parent is an AliasBeansScope then the alias (temporary name) is active until the end of the parent component, rather than the end of this component. </p>

Can contain: JSP

Attributes

Name Description Type
alias Define the "fictive" name which will be visible to the children of this component as an alias to the "real" object specified by the value attribute of this component. 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 existing value that the alias can be set to. This can be a literal string (like "toto") or a reference to an existing bean (like "#{myBean.member1}"). String

<t:aliasBeansScope>

Holds several aliases that are configured by aliasBean tags. <p> The aliasBean tag must enclose all the components that are within the scope of the alias. When multiple aliasas are defined, this makes the page structure very clumsy; for example defining 5 aliases means the content must be nested 5 indentation levels deep. This tag instead allows the content block to be wrapped in just one AliasBeansScope tag, and then have AliasBean tags with empty bodies added as direct children of this component. The scope of the AliasBean tag still starts when the tag begins, but instead of ending when the tag ends the scope of the nested AliasBean tags extends to the end of this component. </p>

Can contain: JSP

Attributes

Name Description Type
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

<t:buffer>

A component that renders its child components into an in-memory buffer rather than render them directly to the response stream. <p> Property "into" is an EL expression that specifies where to store a String holding the results of rendering all the children of this component; this is assigned to after rendering of this component (and its children) is complete. </p> <p> Typically, an h:output tag is then used later in the same page to output the buffer contents. </p> <p> This can be useful with JSF1.1/JSP2.0 to work around the well-known problem where on first render of a page, a component "A" cannot reference a component "B" which is defined later in the page because it has not yet been created. A solution is to define "B" before "A", but wrapped in a Buffer component. Component A can then be rendered and successfully reference "B" because it now exists. And later in the page, the buffer contents can then be output, preserving the original layout. </p> <p> This can also be useful when rendering the same data block multiple times within a page. For example, a datatable can be rendered with a datascroller both before and after it; first render the table into a buffer B1, then render the datascroller into a buffer B2, then output buffers B2,B1,B2. </p>

Can contain: JSP

Attributes

Name Description Type
into* An EL expression that specifies where to store a String holding the results of rendering all the children of this component; this is assigned to after rendering of this component (and its children) is complete. String

<t:captcha>

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
captchaSessionKeyName Determines the CAPTCHA session key name. 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
imageHeight Integer to indicate the CAPTCHA height. default is 81. String
imageWidth Integer to indicate the CAPTCHA width. default is 290. String
rendered A boolean value that indicates whether this component should be rendered. Default value: true. String

<t:checkbox>

Renders a HTML input of type "checkbox". The associated SelectItem comes from an extended selectManyCheckbox component with layout "spread". The selectManyCheckbox is referenced by the "for" attribute. All HTML pass-through attributes for this input are taken from the associated selectManyCheckbox. 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
enabledOnUserRole If user is in given role, this component will be rendered normally. If not, no hyperlink is rendered but all nested tags (=body) are rendered. String
for* id of the referenced extended selectManyCheckbox component 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
index* n-th SelectItem of referenced UISelectMany starting with 0. String
rendered A boolean value that indicates whether this component should be rendered. Default value: true. String
visibleOnUserRole If user is in given role, this component will be rendered normally. If not, nothing is rendered and the body of this tag will be skipped. String

<t:collapsiblePanel>

A component which just renders as a single icon (with optional label) when "collapsed", hiding all child components. When open, the child components can be seen. The title attribute defines the label shown for the collapsible panel.

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
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
enabledOnUserRole If user is in given role, this component will be rendered normally. If not, no hyperlink is rendered but all nested tags (=body) are rendered. 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
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
title HTML: An advisory title for this element. Often used by the user agent as a tooltip. String
titleVar This variable is defined to hold the value of the title component - you can use it for accessing this value in custom headers you define in a facet with name 'header'. String
validatorMessage Text which will be shown if validation fails. String
value Gets The initial value of this component. String
var The variable which you can use to check for the collapsed state of the enclosing component. This is especially useful for custom headers you define in a facet with name 'header'. String
visibleOnUserRole If user is in given role, this component will be rendered normally. If not, nothing is rendered and the body of this tag will be skipped. String

<t:column>

A tag that extend h:column to provide HTML passthrough attributes. Tag t:column can be used instead of h:column in a t:datatable. It provides HTML passthrough attributes for header (th), footer (td) and row cells (td). 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
colspan This attribute specifies the colspan attribute for the cell String
columnId The columnId which will be used as id for the column header. Notice: As the rowId on t:datatable this will not add any namespace to the id. The id will be rendered exactly as you provide it. String
defaultSorted This attribute tells the datatable to make this column the default sorted, when sortable=true String
dir HTML: The direction of text display, either 'ltr' (left-to-right) or 'rtl' (right-to-left). String
footercolspan String
footerdir String
footerlang String
footeronclick String
footerondblclick String
footeronkeydown String
footeronkeypress String
footeronkeyup String
footeronmousedown String
footeronmousemove String
footeronmouseout String
footeronmouseover String
footeronmouseup String
footerstyle String
footerstyleClass Corresponds to the HTML class attribute. String
footertitle String
groupBy This attribute tells the datatable to group by data in this column String
groupByValue Optional - Allows you configure where to get the value to check for the group change condition. Default: all children of the column cell will be checked String
headercolspan String
headerdir String
headerlang String
headeronclick String
headerondblclick String
headeronkeydown String
headeronkeypress String
headeronkeyup String
headeronmousedown String
headeronmousemove String
headeronmouseout String
headeronmouseover String
headeronmouseup String
headerstyle String
headerstyleClass Corresponds to the HTML class attribute. String
headertitle 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
sortPropertyName This attribute tells row object's property by which sorting will be performed on this column String
sortable This attribute makes this column automaticaly sortable by a row object's property 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
width This attribute can be used to set the width of the elements. String

<t:columns>

The tag allows dynamic columns in a datatable. The UIColumns component is used below a t:datatable to create a dynamic count of columns. It is used like a UIData component which iterates through a datamodel to create the columns. 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
colspan This attribute specifies the colspan attribute for the cell String
columnId The columnId which will be used as id for the column header. Notice: As the rowId on t:datatable this will not add any namespace to the id. The id will be rendered exactly as you provide it. String
defaultSorted This attribute tells the datatable to make this column the default sorted, when sortable=true 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
footercolspan String
footerdir String
footerlang String
footeronclick String
footerondblclick String
footeronkeydown String
footeronkeypress String
footeronkeyup String
footeronmousedown String
footeronmousemove String
footeronmouseout String
footeronmouseover String
footeronmouseup String
footerstyle String
footerstyleClass Corresponds to the HTML class attribute. String
footertitle String
groupBy This attribute tells the datatable to group by data in this column String
groupByValue Optional - Allows you configure where to get the value to check for the group change condition. Default: all children of the column cell will be checked String
headercolspan String
headerdir String
headerlang String
headeronclick String
headerondblclick String
headeronkeydown String
headeronkeypress String
headeronkeyup String
headeronmousedown String
headeronmousemove String
headeronmouseout String
headeronmouseover String
headeronmouseup String
headerstyle String
headerstyleClass Corresponds to the HTML class attribute. String
headertitle 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
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
sortPropertyName This attribute tells row object's property by which sorting will be performed on this column String
sortable This attribute makes this column automaticaly sortable by a row object's property 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 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 This attribute can be used to set the width of the elements. String

<t:commandButton>

Extends standard commandButton by user role support. Unless otherwise specified, all attributes accept static values or EL expressions.

Can contain: JSP

Attributes

Name Description Type
accesskey HTML: Sets the access key for this element. String
action 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
actionFor Comma separated list of subForm-ids for which validation and model update should take place when this command is executed. You need to wrap your input components in org.apache.myfaces.custom.subform.SubForm instances for this to work. 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
enabledOnUserRole If user is in given role, this component will be rendered normally. If not, no hyperlink is rendered but all nested tags (=body) are rendered. String
forceId If true, this component will force the use of the specified id when rendering. String
forceIdIndex If false, this component will not append a '[n]' suffix (where 'n' is the row index) to components that are contained within a "list." This value will be true by default and the value will be ignored if the value of forceId is false (or not specified.) 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
visibleOnUserRole If user is in given role, this component will be rendered normally. If not, nothing is rendered and the body of this tag will be skipped. String

<t:commandLink>

Extends standard commandLink by user role support and the HTML target attribute. Unless otherwise specified, all attributes accept static values or EL expressions.

Can contain: JSP

Attributes

Name Description Type
accesskey HTML: Sets the access key for this element. String
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
actionFor Comma separated list of subForm-ids for which validation and model update should take place when this command is executed. You need to wrap your input components in org.apache.myfaces.custom.subform.SubForm instances for this to work. 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 set instead of a Hyperlink a span tag is rendered in the corresponding Component String
disabledStyle CSS-Style Attribute to render when disabled is true String
disabledStyleClass CSS-Style Class to use when disabled is true String
enabledOnUserRole If user is in given role, this component will be rendered normally. If not, no hyperlink is rendered but all nested tags (=body) are rendered. String
forceId If true, this component will force the use of the specified id when rendering. String
forceIdIndex If false, this component will not append a '[n]' suffix (where 'n' is the row index) to components that are contained within a "list." This value will be true by default and the value will be ignored if the value of forceId is false (or not specified.) 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
visibleOnUserRole If user is in given role, this component will be rendered normally. If not, nothing is rendered and the body of this tag will be skipped. String

<t:commandNavigation>

Command, that represents a navigation item. Must be nested inside a panel_navigation action and renders a clickable navigation item. This action is derived from the standard command_link action and has equal attributes. (Replaces former "navigation_item" tag.) Unless otherwise specified, all attributes accept static values or EL expressions.

Can contain: JSP

Attributes

Name Description Type
accesskey HTML: Sets the access key for this element. String
action 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
actionFor Comma separated list of subForm-ids for which validation and model update should take place when this command is executed. You need to wrap your input components in org.apache.myfaces.custom.subform.SubForm instances for this to work. 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 set instead of a Hyperlink a span tag is rendered in the corresponding Component String
disabledStyle CSS-Style Attribute to render when disabled is true String
disabledStyleClass CSS-Style Class to use when disabled is true String
enabledOnUserRole If user is in given role, this component will be rendered normally. If not, no hyperlink is rendered but all nested tags (=body) are rendered. String
forceId If true, this component will force the use of the specified id when rendering. String
forceIdIndex If false, this component will not append a '[n]' suffix (where 'n' is the row index) to components that are contained within a "list." This value will be true by default and the value will be ignored if the value of forceId is false (or not specified.) 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
visibleOnUserRole If user is in given role, this component will be rendered normally. If not, nothing is rendered and the body of this tag will be skipped. String

<t:commandNavigation2>

Must be nested inside a panel_navigation action and renders a clickable navigation item. This action is derived from the standard command_link action and has equal attributes. (Replaces former "navigation_item" tag.) Unless otherwise specified, all attributes accept static values or EL expressions. Many thanks to the guys from Swiss Federal Institute of Intellectual Property and Marc Bouquet for helping to develop this component.

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
actionFor Comma separated list of subForm-ids for which validation and model update should take place when this command is executed. You need to wrap your input components in org.apache.myfaces.custom.subform.SubForm instances for this to work. String
actionListener String
active Menu node is active. String
activeOnViewIds A semicolon separated list of viewIds for which this item should be active. 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 set instead of a Hyperlink a span tag is rendered in the corresponding Component String
disabledStyle CSS-Style Attribute to render when disabled is true String
disabledStyleClass CSS-Style Class to use when disabled is true String
enabledOnUserRole If user is in given role, this component will be rendered normally. If not, no hyperlink is rendered but all nested tags (=body) are rendered. String
externalLink The external link where to redirect when this is clicked. String
forceId If true, this component will force the use of the specified id when rendering. String
forceIdIndex If false, this component will not append a '[n]' suffix (where 'n' is the row index) to components that are contained within a "list." This value will be true by default and the value will be ignored if the value of forceId is false (or not specified.) 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
open Menu node is open. 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
visibleOnUserRole If user is in given role, this component will be rendered normally. If not, nothing is rendered and the body of this tag will be skipped. String

<t:commandSortHeader>

Clickable sort column header. Must be nested inside an extended data_table tag. This tag is derived from the standard command_link tag and has the additional attributes columnName and arrow. Note: In contrast to normal command links, the default for the "immediate" attribute is "true". This is desirable as it avoids validating all input fields in the enclosing form when the column sort order changes. HOWEVER when the table contains input components "immediate" must be set to false; otherwise input fields will render blank after a sort, or will show their old values (ie will not appear to sort though output fields in the table will sort) when sort ordering is changed. Unless otherwise specified, all attributes accept static values or EL expressions.

Can contain: JSP

Attributes

Name Description Type
accesskey HTML: Sets the access key for this element. String
action 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
actionFor Comma separated list of subForm-ids for which validation and model update should take place when this command is executed. You need to wrap your input components in org.apache.myfaces.custom.subform.SubForm instances for this to work. String
actionListener String
arrow Indicates whether an arrow, that shows the sort direction should be rendered. Default: false 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
columnName* The name of this column. This name must uniquely identify this column among all other (sortable) columns in the same data_table. The sortColumn attribute of the embedding data_table reflects the current sort column (see extended data_table). 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 set instead of a Hyperlink a span tag is rendered in the corresponding Component String
disabledStyle CSS-Style Attribute to render when disabled is true String
disabledStyleClass CSS-Style Class to use when disabled is true String
enabledOnUserRole If user is in given role, this component will be rendered normally. If not, no hyperlink is rendered but all nested tags (=body) are rendered. String
forceId If true, this component will force the use of the specified id when rendering. String
forceIdIndex If false, this component will not append a '[n]' suffix (where 'n' is the row index) to components that are contained within a "list." This value will be true by default and the value will be ignored if the value of forceId is false (or not specified.) 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
propertyName The property name associated with this column. This name must be one of the properties of the row object by which the sorting should be performed. The sortProperty attribute of the embedding data_table reflects the current sort property (see extended data_table). 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
visibleOnUserRole If user is in given role, this component will be rendered normally. If not, nothing is rendered and the body of this tag will be skipped. String

<t:dataList>

Similar to dataTable, but does not render a table. Instead the layout attribute controls how each dataRow is rendered. Unless otherwise specified, all attributes accept static values or EL expressions.

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
enabledOnUserRole If user is in given role, this component will be rendered normally. If not, no hyperlink is rendered but all nested tags (=body) are rendered. 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
forceId If true, this component will force the use of the specified id when rendering. String
forceIdIndex If false, this component will not append a '[n]' suffix (where 'n' is the row index) to components that are contained within a "list." This value will be true by default and the value will be ignored if the value of forceId is false (or not specified.) 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
itemStyleClass CSS class to be applied to individual items in the list String
lang HTML: The base language of this document. String
layout simple|unorderedList|orderedList <ul> <li>simple = for each dataRow all children are simply rendered</li> <li>unorderedList = the list is rendered as HTML unordered list (= bullet list)</li> <li>orderedList = the list is rendered as HTML ordered list</li> </ul> Default: simple 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
preserveRowStates Indicates whether the state for each row should not be discarded before the datatable is rendered again. Setting this to true might be hepful if an input component inside the datatable has no valuebinding and the value entered in there should be displayed again. This will only work reliable if the datamodel of the datatable did not change either by sorting, removing or adding rows. Default: false 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
rowCountVar A parameter name, under which the rowCount is set in request scope similar to the var parameter. String
rowIndexVar A parameter name, under which the current rowIndex is set in request scope similar to the var parameter. 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
visibleOnUserRole If user is in given role, this component will be rendered normally. If not, nothing is rendered and the body of this tag will be skipped. String
width HTML: Specifies the desired width of the table, as a pixel length or a percentage of available space. String

<t:dataScroller>

Scroller for UIData components eg. dataTable Must be nested inside footer facet of dataTable OR for attribute must be given so that corresponding uiData can be found. Unless otherwise specified, all attributes accept static values or EL expressions. A component which works together with a UIData component to allow a user to view a large list of data one "page" at a time, and navigate between pages.

Can contain: JSP

Attributes

Name Description Type
actionListener MethodBinding pointing at method acception an ActionEvent with return type void. 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
colspan standard html colspan attribute for table cell String
dir HTML: The direction of text display, either 'ltr' (left-to-right) or 'rtl' (right-to-left). String
displayValueOnly If true, renders only the value of the component, but no input widget. Default is false. String
displayValueOnlyStyle Style used when displayValueOnly is true. String
displayValueOnlyStyleClass Style class used when displayValueOnly is true. String
displayedRowsCountVar A parameter name, under which the actual displayed rows count is set in request scope similar to the var parameter. String
enabledOnUserRole If user is in given role, this component will be rendered normally. If not, no hyperlink is rendered but all nested tags (=body) are rendered. String
fastStep step (pages) used for fastforward and fastrewind String
fastfStyleClass style-class for data-scroller fast-forward-element String
fastrStyleClass style-class for data-scroller fast-rewind-element String
firstRowIndexVar A parameter name, under which the actual first displayed row index is set in request scope similar to the var parameter. String
firstStyleClass style-class for data-scroller first-element String
for The JSF id of a UIData component that this scroller will affect. If this attribute is not present then the datascroller must be a child of a UIData component. String
forceId If true, this component will force the use of the specified id when rendering. String
forceIdIndex If false, this component will not append a '[n]' suffix (where 'n' is the row index) to components that are contained within a "list." This value will be true by default and the value will be ignored if the value of forceId is false (or not specified.) 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 True means that the default ActionListener should be executed immediately (i.e. during Apply Request Values phase of the request processing lifecycle), rather than waiting until the Invoke Application phase. String
lang HTML: The base language of this document. String
lastRowIndexVar A parameter name, under which the actual last displayed row index is set in request scope similar to the var parameter. String
lastStyleClass style-class for data-scroller last-element String
layout The layout this scroller should render with. Default is 'table', 'list' is implemented as well. Additionally you can use 'singleList' - then the data-scroller will render a list, but not the paginator - same with the value 'singleTable'. String
nextStyleClass style-class for dataScroller next-element 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
pageCountVar A parameter name, under which the actual page count is set in request scope similar to the var parameter. String
pageIndexVar A parameter name, under which the actual page index is set in request scope similar to the var parameter. String
paginator If set true, then the paginator gets rendered String
paginatorActiveColumnClass styleClass for paginator's column with pageIndex = currentPageIndex String
paginatorActiveColumnStyle style for paginator's column with pageIndex = currentPageIndex String
paginatorColumnClass styleClass for paginator's column String
paginatorColumnStyle style for paginator's column String
paginatorMaxPages The maximum amount of pages to be displayed in the paginator. String
paginatorRenderLinkForActive 'true' - render a link for the paginator's column with pageIndex = currentPageIndex. Default-value is 'true'. String
paginatorTableClass styleclass for pagingator String
paginatorTableStyle style for pagingator String
previousStyleClass style-class for data-scroller previous-element String
renderFacetsIfSinglePage If set to false, the facets aren't renderd if all the lines are contained on a single page. Default is true. String
rendered A boolean value that indicates whether this component should be rendered. Default value: true. String
rowsCountVar A parameter name, under which the actual rows count is set in request scope similar to the var parameter. 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
visibleOnUserRole If user is in given role, this component will be rendered normally. If not, nothing is rendered and the body of this tag will be skipped. String

<t:dataTable>

The MyFacesDataTable extends the standard JSF DataTable by two important features: <br/> <ul> <li>Possiblity to save the state of the DataModel.</li> <li>Support for clickable sort headers (see SortHeader component).</li> </ul> <br/> Extended data_table that adds some additional features to the standard data_table action: see attribute descriptions for preserveDataModel, sortColumn, sortAscending and preserveSort. <br/> Unless otherwise specified, all attributes accept static values or EL expressions.

Can contain: JSP

Attributes

Name Description Type
align HTML: Specifies the horizontal alignment of this element. Deprecated in HTML 4.01. String
bgcolor HTML: The background color of this element. String
binding Identifies a backing bean property (of type UIComponent or appropriate subclass) to bind to this component instance. This value must be an EL expression. String
bodyStyle Corresponds to the HTML style attribute for the table body tag String
bodyStyleClass Corresponds to the HTML class attribute for the table body tag. 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
datafld Reserved for future use. String
dataformatas Reserved for future use. String
datasrc Reserved for future use. String
detailStampExpandedDefault true|false - true if the detailStamp should be expanded by default. default: false String
detailStampLocation before|after - where to render the detailStamp, before the actual row or after it. default: after String
dir HTML: The direction of text display, either 'ltr' (left-to-right) or 'rtl' (right-to-left). String
embedded Avoids rendering the html table tags, thus, giving you a table rendering just rows. You can use this together with the detailStamp faces of the parent datatable to render child-tables using the same layout as the parent. Notice: You have to ensure both tables do have the same number of columns. Using the colspan attribute of the column tag might help alot. String
enabledOnUserRole If user is in given role, this component will be rendered normally. If not, no hyperlink is rendered but all nested tags (=body) are rendered. String
first The index of the first row to be displayed, where 0 is the first row. String
footerClass The CSS class to be applied to footer cells. String
forceId If true, this component will force the use of the specified id when rendering. String
forceIdIndex If false, this component will not append a '[n]' suffix (where 'n' is the row index) to components that are contained within a "list." This value will be true by default and the value will be ignored if the value of forceId is false (or not specified.) String
forceIdIndexFormula A formula that overrides the default row index in the construction of table's body components. Example : #{myRowVar.key} Warning, the EL should evaluate to a unique value for each row ! 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
newspaperColumns The number of columns to wrap the table over. Default: 1 Set the number of columns the table will be divided over. String
newspaperOrientation The orientation of the newspaper columns in the newspaper table - "horizontal" or "vertical". Default: vertical 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
preserveDataModel Indicates whether the state of the whole DataModel should be saved and restored. When set to false, the value-binding for the "value" attribute of this table is executed each time the page is rendered. When set to true, that value-binding is only executed when the component is first created, and the DataModel state is thereafter saved/restored automatically by the component. When column sorting is used for a table this property needs to be false so that the DataModel can be updated to reflect any changes in the sort criteria. Default: false String
preserveRowStates Indicates whether the state for each row should not be discarded before the datatable is rendered again. Setting this to true might be hepful if an input component inside the datatable has no valuebinding and the value entered in there should be displayed again. This will only work reliable if the datamodel of the datatable did not change either by sorting, removing or adding rows. Default: false String
preserveSort Indicates whether the state of the sortColumn and sortAscending attribute should be saved and restored and written back to the model during the update model phase. Default: true String
previousRowDataVar A parameter name, under which the previous RowData Object is set in request scope similar to the rowIndexVar and rowCountVar parameters. Mind that the value of this request scope attribute is null in the first row or when isRowAvailable returns false for the previous row. String
rendered A boolean value that indicates whether this component should be rendered. Default value: true. String
renderedIfEmpty Indicates whether this table should be rendered if the underlying DataModel is empty. You could as well use rendered="#{not empty bean.list}", but this one causes the getList method of your model bean beeing called up to five times per request, which is not optimal when the list is backed by a DB table. Using renderedIfEmpty="false" solves this problem, because the MyFaces extended HtmlDataTable automatically caches the DataModel and calles the model getter only once per request. Default: true String
rowClasses A comma separated list of CSS class names to apply to td elements in each row. String
rowCountVar A parameter name, under which the rowCount is set in request scope similar to the var parameter. String
rowGroupStyle Corresponds to the HTML style attribute for grouped rows. String
rowGroupStyleClass StyleClass for grouped rows. String
rowId The id to use for String
rowIndexVar A parameter name, under which the current rowIndex is set in request scope similar to the var parameter. String
rowOnClick Defines a JavaScript onclick event handler for each table row String
rowOnDblClick Defines a JavaScript ondblclick event handler for each table row String
rowOnKeyDown Defines a JavaScript onkeydown event handler for each table row String
rowOnKeyPress Defines a JavaScript onkeypress event handler for each table row String
rowOnKeyUp Defines a JavaScript onkeyup event handler for each table row String
rowOnMouseDown Defines a JavaScript onmpusedown event handler for each table row String
rowOnMouseMove Defines a JavaScript onmousemove event handler for each table row String
rowOnMouseOut Defines a JavaScript onmouseout event handler for each table row String
rowOnMouseOver Defines a JavaScript onmouseover event handler for each table row String
rowOnMouseUp Defines a JavaScript onmouseup event handler for each table row String
rowStyle Corresponds to the HTML style attribute for the row tr tag. String
rowStyleClass Corresponds to the HTML class attribute for the row tr tag. String
rows The number of rows to be displayed. Specify zero for all remaining rows in the table. String
rules HTML: Controls how rules are rendered between cells. Values include: none, groups, rows, cols, and all. String
sortAscending Value reference to a model property that gives the current sort direction. The target Boolean property is set to true when the selected sortColumn should be sorted in ascending order, and false otherwise. The method which is bound to the "value" attribute of this table (ie which provides the DataModel used) is expected to use this property to determine how to sort the DataModel's contents. String
sortColumn Value reference to a model property that gives the current sort column name. The target String property is set to the "columnName" of whichever column has been chosen to sort by, and the method which is bound to the "value" attribute of this table (ie which provides the DataModel used) is expected to use this property to determine how to sort the DataModel's contents. String
sortable Define if the table is sortable or not String
sortedColumnVar A parameter name, under which the a boolean is set in request scope similar to the var parameter. TRUE for the column that is currently sorted, FALSE otherwise. 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
varDetailToggler This variable has the boolean property "currentdetailExpanded" which is true if the current detail row is expanded and the action method "toggleDetail" which expand/collapse the current detail row. String
visibleOnUserRole If user is in given role, this component will be rendered normally. If not, nothing is rendered and the body of this tag will be skipped. String
width HTML: Specifies the desired width of the table, as a pixel length or a percentage of available space. String

<t:div>

Places a div around its children. Unless otherwise specified, all attributes accept static values or EL expressions.

Can contain: JSP

Attributes

Name Description Type
binding Identifies a backing bean property (of type UIComponent or appropriate subclass) to bind to this component instance. This value must be an EL expression. String
dir HTML: The direction of text display, either 'ltr' (left-to-right) or 'rtl' (right-to-left). String
enabledOnUserRole If user is in given role, this component will be rendered normally. If not, no hyperlink is rendered but all nested tags (=body) are rendered. String
forceId If true, this component will force the use of the specified id when rendering. String
forceIdIndex If false, this component will not append a '[n]' suffix (where 'n' is the row index) to components that are contained within a "list." This value will be true by default and the value will be ignored if the value of forceId is false (or not specified.) 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
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
visibleOnUserRole If user is in given role, this component will be rendered normally. If not, nothing is rendered and the body of this tag will be skipped. String

<t:document>

Document to enclose the whole document. If not otherwise possible you can use state="start|end" to demarkate the document boundaries

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
state state="start|end". Used to demarkate the document boundaries String

<t:documentBody>

Document to enclose the document body. If not otherwise possible you can use state="start|end" to demarkate the document boundaries

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
onkeypress String
onload String
onresize String
onunload String
rendered A boolean value that indicates whether this component should be rendered. Default value: true. String
state state="start|end". Used to demarkate the document boundaries String
style HTML: CSS styling instructions. String
styleClass The CSS class for this element. Corresponds to the HTML 'class' attribute. String

<t:documentHead>

Document to enclose the document head. If not otherwise possible you can use state="start|end" to demarkate the document boundaries

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
state state="start|end". Used to demarkate the document boundaries String

<t:dojoInitializer>

Default component for the dojo intializer <br/> This component is purely non visual, and serves for quick hacking, and prototyping the dojo toolkit within verbatimed html. <br/> Dojo initializer helper tag for debugging and communication flags. This tag encapsules the Dojo DjConfig meta configuration and also adds the needed dojo required functionality.

Can contain: JSP

Attributes

Name Description Type
allowQueryConfig Triggers a standard dojo allowQueryConfig as defined by the <a href="http://dojotoolkit.org/">Dojo Toolkit</a>. If someone has additional infos about this tag, please fill in here. String
baseScriptUri Triggers a standard dojo baseScriptUri as defined by the <a href="http://dojotoolkit.org/">Dojo Toolkit</a> <br /> <br /> Allows the alteration of the dojo loading root path used by require. String
bindEncoding Triggers a standard dojo bindEncoding as defined by the <a href="http://dojotoolkit.org/">Dojo Toolkit</a> Although this control most of the times is not needed one usage in plain jsf applications can be thought of. The changing of the bind encodings, if you check the parameter list of the control <b>ioSendTransport</b> can be used to change this encoding to any encoding parameter needed. This can be used to change the internal ajax request encodings of various controls in a global manner. 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
debug Triggers a standard dojo debug as defined by the <a href="http://dojotoolkit.org/">Dojo Toolkit</a> <br /> <br /> Enables the dojo debugging framework. The usage of dojo.debug causes output to be displayed in either the current container or a target container, if one is set. String
debugAtAllCosts Triggers a standard dojo debugAtAllCosts as defined by the <a href="http://dojotoolkit.org/">Dojo Toolkit</a> <br /> Tries to enforce debugging even if the browser version does not allow it to work properlys String
debugConsole Triggers a standard dojo debugConsole as defined by the <a href="http://dojotoolkit.org/">Dojo Toolkit</a> <br /> <br /> This flag pops up a separate in frame floating window which receives the debugging output. <br /> <br /> Note: This flag only works if debugging is enabled generally via the debug="true" flag set String
debugContainerId Triggers a standard dojo debugContainerId as defined by the <a href="http://dojotoolkit.org/">Dojo Toolkit</a> <br /> <br /> This flag notifies the Dojo toolkit about the id which should receive the debug output. Dojo has a full debugging framework in it which allows to turn on debug output via a logging mechanism @see dojo.debug() for further references. <br /> <br /> The debugging output is not limited to the current container triggering the debugging statement any container can receive the debugging output this flag is the flag which has to be set for setting a different target id for the debugging output. String
development Triggers a standard dojo development as defined by the <a href="http://dojotoolkit.org/">Dojo Toolkit</a> If this parameter is set to true. The expanded debuggable version of dojo is included if set to false the compressed one is included. String
expanded Triggers a standard dojo development as defined by the <a href="http://dojotoolkit.org/">Dojo Toolkit</a> If you can find additional info about this attribute please fill in here 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
ignoreClassNames Triggers a standard dojo ignoreClassNames as defined by the <a href="http://dojotoolkit.org/">Dojo Toolkit</a> <br /> <br /> This attribute turns on the case insensitive handling of classnames by require and other Dojo class loader mechanisms. <br /> <br /> Case sensitivity is by default turned <b>on</b>. String
ioSendTransport Dojo in its underlying architecture allows various options of server-client side communication. This setting allows the alteration of the communication layer to a different protocol. Currently only in usage is xmlhttprequest, hence setting this encoding will not change too much. But different encodings like iframe are planned for the future. String
parseWidgets Triggers a standard dojo parseWidgets as defined by the <a href="http://dojotoolkit.org/">Dojo Toolkit</a> This parameter is used to turn on or off the dojo widgeting parsing. The parsing is not used by MyFaces for various reasons, but can be used by your own html code. <br /> <br /> For addititional information regarding the Dojo Toolkit widget parsing, visit the <br /> <a href="http://dojotoolkit.org/">Dojo Toolkit Homepage</a> String
preventBackButtonFix Dojo uses internally back button blockers to avoid problems with ajax requests causing the back button, to move out of the back page navigation order. Sometimes this behavior is not wanted and can be turned off with this on a global scale; String
provide Triggers a standard dojo provide as defined by the <a href="http://dojotoolkit.org/">Dojo Toolkit</a> String
rendered A boolean value that indicates whether this component should be rendered. Default value: true. String
require Triggers a standard dojo provide as defined by the <a href="http://dojotoolkit.org/">Dojo Toolkit</a> String
searchIds Triggers a standard dojo development as defined by the <a href="http://dojotoolkit.org/">Dojo Toolkit</a> If you can find additional info about this attribute please fill in here String

<t:fieldset>

Renders an HTML Fieldset

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
enabledOnUserRole If user is in given role, this component will be rendered normally. If not, no hyperlink is rendered but all nested tags (=body) are rendered. String
forceId If true, this component will force the use of the specified id when rendering. String
forceIdIndex If false, this component will not append a '[n]' suffix (where 'n' is the row index) to components that are contained within a "list." This value will be true by default and the value will be ignored if the value of forceId is false (or not specified.) 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
legend The fieldset's legend. 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
visibleOnUserRole If user is in given role, this component will be rendered normally. If not, nothing is rendered and the body of this tag will be skipped. String

<t:graphicImage>

Extends standard graphicImage. Unless otherwise specified, all attributes accept static values or EL expressions.

Can contain: JSP

Attributes

Name Description Type
align HTML: Specifies the horizontal alignment of this element. Deprecated in HTML 4.01. String
alt HTML: Specifies alternative text that can be used by a browser that can't show this element. String
binding Identifies a backing bean property (of type UIComponent or appropriate subclass) to bind to this component instance. This value must be an EL expression. String
border HTML: Specifies the width of the border of this element, in pixels. Deprecated in HTML 4.01. String
dir HTML: The direction of text display, either 'ltr' (left-to-right) or 'rtl' (right-to-left). String
enabledOnUserRole If user is in given role, this component will be rendered normally. If not, no hyperlink is rendered but all nested tags (=body) are rendered. String
forceId If true, this component will force the use of the specified id when rendering. String
forceIdIndex If false, this component will not append a '[n]' suffix (where 'n' is the row index) to components that are contained within a "list." This value will be true by default and the value will be ignored if the value of forceId is false (or not specified.) String
height HTML: Overrides the natural height of this image, by specifying height in pixels. String
hspace HTML: The amount of white space to be inserted to the left and right of this element, in undefined units. Deprecated in HTML 4.01. 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
visibleOnUserRole If user is in given role, this component will be rendered normally. If not, nothing is rendered and the body of this tag will be skipped. String
vspace HTML: The amount of white space to be inserted above and below this element, in undefined units. Deprecated in HTML 4.01. String
width HTML: Overrides the natural width of this image, by specifying width in pixels. String

<t:headerLink>

Link used to collapse or expand a t:collapsiblePanel. Unless otherwise specified, all attributes accept static values or EL expressions.

Can contain: JSP

Attributes

Name Description Type
accesskey HTML: Sets the access key for this element. String
action 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
actionFor Comma separated list of subForm-ids for which validation and model update should take place when this command is executed. You need to wrap your input components in org.apache.myfaces.custom.subform.SubForm instances for this to work. 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 set instead of a Hyperlink a span tag is rendered in the corresponding Component String
disabledStyle CSS-Style Attribute to render when disabled is true String
disabledStyleClass CSS-Style Class to use when disabled is true String
enabledOnUserRole If user is in given role, this component will be rendered normally. If not, no hyperlink is rendered but all nested tags (=body) are rendered. 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
visibleOnUserRole If user is in given role, this component will be rendered normally. If not, nothing is rendered and the body of this tag will be skipped. String

<t:htmlTag>

Creates an arbitrary HTML tag which encloses any child components. The value attribute specifies the name of the generated tag. <br/> If value is an empty string then no tag will be generated, but the child components will be rendered. This differs from setting rendered=false, which prevents child components from being rendered at all. <br/> You can specify some attribute to be added to the component using f:param like this: <br/> <t:htmlTag value="span"> <f:param name="title" value="Hello world!"/> </t:htmlTag> 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
enabledOnUserRole If user is in given role, this component will be rendered normally. If not, no hyperlink is rendered but all nested tags (=body) are rendered. String
forceId If true, this component will force the use of the specified id when rendering. String
forceIdIndex If false, this component will not append a '[n]' suffix (where 'n' is the row index) to components that are contained within a "list." This value will be true by default and the value will be ignored if the value of forceId is false (or not specified.) 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
style HTML: CSS styling instructions. String
styleClass The CSS class for this element. Corresponds to the HTML 'class' attribute. String
value Gets The initial value of this component. String
visibleOnUserRole If user is in given role, this component will be rendered normally. If not, nothing is rendered and the body of this tag will be skipped. String

<t:iconProvider>

Can contain: empty

Attributes

Name Description Type
type* String

<t:inputCalendar>

<p> Provides a calendar. The calendar can be "inline", or a button can be rendered that displays the calendar in a "popup window" when clicked. Javascript is required for the popup window. </p> <p> The two forms of calendar are unfortunately not well integrated; this component is effectively two components that happen to use the same component class. Some attributes on the component are applicable only to the inline form while others are applicable only to the popup form. </p> <p> The appearance of the inline calendar can be controlled via attributes such as currentDayCellClass, dayCellClass, weekRowClass, monthYearRowClass. Attributes "styleLocation", "javascriptLocation", "imageLocation" and all attributes starting with "popup" have no effect on an inline calendar. </p> <ul> <p> The appearance of the popup calendar can be controlled via attributes popupTheme, styleLocation, javascriptLocation and imageLocation: </p> <li>popupTheme: When styleLocation is not overridden then this selects one of the built-in themes ("WH" or "DB"); the default is "DB". This also selects the prefix used for the names of style classes attached to generated dom elements; all style names are of form "jscalendar-{popupTheme}-*". </li> <li>styleLocation: specifies the URL of a directory in which a "theme.css" file exists. A reference to this theme.css file will automatically be output. Specifying "none" as the location prevents the generation of this stylesheet reference; it is assumed that the necessary style rules will be loaded via some other mechanism. Defaults to a reference to a location within the tomahawk jarfile which varies based on popupTheme.</li> <li>javascriptLocation: specifies the URL of a directory in which all the necessary script files can be found. A reference to scripts "prototype.js", "date.js" and "popcalendar.js" will automatically be output. Specifying "none" prevents generation of these references; it is assumed that the necessary javascript functions will be loaded via some other mechanism. Defaults to a reference to a location within the tomahawk jarfile.</li> <li>imageLocation: specifies the URL of a directory in which all the necessary icons are defined. Defaults to a reference to a location within the tomahawk jarfile which varies depending on popupTheme.</li> </ul> Other styling attributes (eg dayCellClass, weekRowClass) are ignored for the popup calendar. <p> Unless otherwise specified, all attributes accept static values or EL expressions. </p>

Can contain: JSP

Attributes

Name Description Type
accesskey HTML: Sets the access key for this element. String
addResources Automatically add the input-calendar scripts and css files to the header - set that to false to provide the scripts yourself. String
align HTML: Specifies the horizontal alignment of this element. Deprecated in HTML 4.01. String
alt HTML: Specifies alternative text that can be used by a browser that can't show this element. String
autocomplete Non HTML standard attribute to disable browser's autocomplete function. 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
currentDayCellClass CSS class to be used for the TD element of the currently selected date. String
datafld Reserved for future use. String
dataformatas Reserved for future use. String
datasrc Reserved for future use. String
dayCellClass CSS class to be used for the TD element containing a day days. 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
disabledOnClientSide If true the input is rendered disabled on the client side and a hidden input is used to actualy submit his value back to the server. String
displayValueOnly If true, renders only the value of the component, but no input widget. Default is false. String
displayValueOnlyStyle Style used when displayValueOnly is true. String
displayValueOnlyStyleClass Style class used when displayValueOnly is true. String
enabledOnUserRole If user is in given role, this component will be rendered normally. If not, no hyperlink is rendered but all nested tags (=body) are rendered. String
forceId If true, this component will force the use of the specified id when rendering. String
forceIdIndex If false, this component will not append a '[n]' suffix (where 'n' is the row index) to components that are contained within a "list." This value will be true by default and the value will be ignored if the value of forceId is false (or not specified.) String
helpText The text that will be rendered in the field - helping the user to find the right format to enter into the field. 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
imageLocation An alternate location to find image resources. If no values is specified, images will be loaded from the resources directory using AddResource and ExtensionsFilter. 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
javascriptLocation An alternate location to find javascript resources. If no values is specified, javascript will be loaded from the resources directory using AddResource and ExtensionsFilter. 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
monthYearRowClass CSS class to be used on the TR element for the header-row showing month and year. 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
popupButtonImageUrl Url to the image for this popupButton. String
popupButtonString Defines the string displayed on the button which leads to the calendar-popup-window (... by default). String
popupButtonStyle Defines the css style for the button which leads to the calendar-popup-window. String
popupButtonStyleClass Defines the css style class for the button which leads to the calendar-popup-window. String
popupDateFormat Defines the date format used by the java-script popup on client. String
popupGotoString Set the string for "Go To Current Month" String
popupLeft Render the input-calendar left of the button, not right like normally done. String
popupScrollLeftMessage Set the string for scrolling to the left. String
popupScrollRightMessage Set the string for scrolling to the right. String
popupSelectDateMessage Set the string for "Select [date] as date" (do not replace [date], it will be replaced by the current date). String
popupSelectMode <p> May be "day", "week", "month" or "none": <ul> <li>day (default): allow the user to select a day.</li> <li>week: only allow the user to select a week.</li> <li>month: only allow the user to select a month.</li> <li>none: equivalent to "readonly".</li> </ul> </p> String
popupSelectMonthMessage Set the string for "Click to select a month". String
popupSelectYearMessage Set the string for "Click to select a year". String
popupTheme Set the theme-prefix for this component. String
popupTodayDateFormat Defines the date format used by the java-script popup on client for the today-is string. String
popupTodayString Set the string for "Today is" String
popupWeekString Set the string for "Wk" 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
renderAsPopup Render the input-calendar as a java-script popup on client. String
renderPopupButtonAsImage If true, renders a calendar icon instead of the button to pop up the calendar. 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
styleLocation An alternate location to find stylesheet resources. If no values is specified, stylesheets will be loaded from the resources directory using AddResource and ExtensionsFilter. 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
visibleOnUserRole If user is in given role, this component will be rendered normally. If not, nothing is rendered and the body of this tag will be skipped. String
weekRowClass CSS class to be used on the TR element for the header-row showing the week-days. String

<t:inputDate>

Custom input control for dates and times. Unless otherwise specified, all attributes accept static values or EL expressions.

Can contain: JSP

Attributes

Name Description Type
accesskey HTML: Sets the access key for this element. String
align HTML: Specifies the horizontal alignment of this element. Deprecated in HTML 4.01. String
alt HTML: Specifies alternative text that can be used by a browser that can't show this element. String
ampm If true, use 12hr times with AM/PM selector; if false, use 24hr time. Default false. 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 Retrieve the converter used by this component. <p> If no converter is selected, submitted values are converted to its inner class UserData on decode method. </p> <p> If some converter is used, submitted values are decoded as a String with the following format: </p> <p></p> <p>year=yyyy</p> <p>month=mm</p> <p>day=dd</p> <p>hours=hh</p> <p>minutes=mm</p> <p>seconds=ss</p> <p>ampm=ampm</p> <p></p> <p> Note that submitted values could be wrong and it is necessary to restore values on render response phase. The converter receive a string with this format on getAsObject method and it is expected the converter encode it on getAsString method, so the renderer can restore the submitted values correctly. </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
emptyAmpmSelection Label to be used when displaying an empty ampm selection String
emptyMonthSelection Label to be used when displaying an empty month selection String
enabledOnUserRole If user is in given role, this component will be rendered normally. If not, no hyperlink is rendered but all nested tags (=body) are rendered. String
forceId If true, this component will force the use of the specified id when rendering. String
forceIdIndex If false, this component will not append a '[n]' suffix (where 'n' is the row index) to components that are contained within a "list." This value will be true by default and the value will be ignored if the value of forceId is false (or not specified.) 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
popupCalendar 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
timeZone String
title HTML: An advisory title for this element. Often used by the user agent as a tooltip. String
type Specifies the type of value to be accepted. Valid values are: date | time | short_time | both | full 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
visibleOnUserRole If user is in given role, this component will be rendered normally. If not, nothing is rendered and the body of this tag will be skipped. String

<t:inputFileUpload>

Creates a file-selection widget in the rendered page which allows a user to select a file for uploading to the server. <p> When the page is selected (using a command component such as commandButton), the currently selected file contents are included in the data posted to the server. The contents are cached somewhere, and an object of type UploadedFile will then be assigned to the property pointed to by the "value" expression of this component. </p> <p> You must enable the Tomahawk ExtensionsFilter to make this component work (see web.xml). </p> <p> Also, don't forget to set the form's attribute "enctype" to "multipart/form-data". See "examples/web/fileupload.jsp" for an example! </p> <p> Unless otherwise specified, all attributes accept static values or EL expressions. </p>

Can contain: JSP

Attributes

Name Description Type
accept This property appears to have no purpose at all. It certainly has no documentation. String
accesskey HTML: Sets the access key for this element. String
align HTML: Specifies the horizontal alignment of this element. Deprecated in HTML 4.01. String
alt HTML: Specifies alternative text that can be used by a browser that can't show this element. String
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
enabledOnUserRole If user is in given role, this component will be rendered normally. If not, no hyperlink is rendered but all nested tags (=body) are rendered. 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
storage This setting was intended to allow control over how the contents of the file get temporarily stored during processing. <p> It allows three options</p> <ul> <li>"default": The file is handled on memory while the file size is below uploadThresholdSize value, otherwise is handled on disk or file storage when decode occur (set submitted value)</li> <li>"memory": The file is loaded to memory when decode occur (set submitted value). In other words, before set the uploaded file as submitted value it is loaded to memory. Use with caution, because it could cause OutOfMemory exceptions when the uploaded files are too big. </li> <li>"file": The file is handled on disk or file storage.</li> </ul> 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 An EL expression to which an UploadedFile object will be assigned on postback if the user specified a file to upload to the server. 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
visibleOnUserRole If user is in given role, this component will be rendered normally. If not, nothing is rendered and the body of this tag will be skipped. String

<t:inputHidden>

Extended version of {@link javax.faces.component.html.HtmlInputHidden} that provides additional MyFaces functionality.

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
forceId If true, this component will force the use of the specified id when rendering. String
forceIdIndex If false, this component will not append a '[n]' suffix (where 'n' is the row index) to components that are contained within a "list." This value will be true by default and the value will be ignored if the value of forceId is false (or not specified.) 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

<t:inputHtml>

HTML Editor using the kupu library. http://kupu.oscom.org/ An inline HTML based word processor based on the Kupu library. See http://kupu.oscom.org Right now, the support is limited to one editor per page (but you can use tabs to have multiple editors, but only one rendered at a time). Unless otherwise specified, all attributes accept static values or EL expressions.

Can contain: JSP

Attributes

Name Description Type
accesskey HTML: Sets the access key for this element. String
addKupuLogo Show the Kupu Logo in the buttons bar. Default is true. String
align HTML: Specifies the horizontal alignment of this element. Deprecated in HTML 4.01. String
allowEditSource Allows the user to edit the HTML source code. Default is true. String
allowExternalLinks Allows the user to insert external links. Default is true. String
alt HTML: Specifies alternative text that can be used by a browser that can't show this element. String
autocomplete Non HTML standard attribute to disable browser's autocomplete function. 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
datafld Reserved for future use. String
dataformatas Reserved for future use. String
datasrc Reserved for future use. String
dir HTML: The direction of text display, either 'ltr' (left-to-right) or 'rtl' (right-to-left). String
disabled HTML: When true, this element cannot receive focus. String
disabledOnClientSide If true the input is rendered disabled on the client side and a hidden input is used to actualy submit his value back to the server. String
displayValueOnly If true, renders only the value of the component, but no input widget. Default is false. String
displayValueOnlyStyle Style used when displayValueOnly is true. String
displayValueOnlyStyleClass Style class used when displayValueOnly is true. String
enabledOnUserRole If user is in given role, this component will be rendered normally. If not, no hyperlink is rendered but all nested tags (=body) are rendered. String
fallback Use a text area instead of the javascript HTML editor. Default is false. Use with caution. String
forceId If true, this component will force the use of the specified id when rendering. String
forceIdIndex If false, this component will not append a '[n]' suffix (where 'n' is the row index) to components that are contained within a "list." This value will be true by default and the value will be ignored if the value of forceId is false (or not specified.) 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
showAllToolBoxes Shortcut to avoid setting all the showXXToolBox to true. Default is false. String
showCleanupExpressionsToolBox Show the Cleanup Expressions tool box next to the text. Default is false. String
showDebugToolBox Show the Debug tool box next to the text. Default is false. String
showImagesToolBox Show the Images tool box next to the text. Default is false. String
showLinksToolBox Show the Links tool box next to the text. Default is false. String
showPropertiesToolBox Show the Properties tool box next to the text. Default is false. String
showTablesToolBox Show the Tables tool box next to the text. Default is false. 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
type The type of the value. It can be either fragment for an HTML fragment (default) or document for a full HTML document, with head, title, body, ... tags. 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
visibleOnUserRole If user is in given role, this component will be rendered normally. If not, nothing is rendered and the body of this tag will be skipped. String

<t:inputSecret>

Extends standard inputSecret, adding the "redisplay" property. Unless otherwise specified, all attributes accept static values or EL expressions.

Can contain: JSP

Attributes

Name Description Type
accesskey HTML: Sets the access key for this element. String
align HTML: Specifies the horizontal alignment of this element. Deprecated in HTML 4.01. String
alt HTML: Specifies alternative text that can be used by a browser that can't show this element. String
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
datafld Reserved for future use. String
dataformatas Reserved for future use. String
datasrc Reserved for future use. String
dir HTML: The direction of text display, either 'ltr' (left-to-right) or 'rtl' (right-to-left). String
disabled HTML: When true, this element cannot receive focus. String
displayValueOnly If true, renders only the value of the component, but no input widget. Default is false. String
displayValueOnlyStyle Style used when displayValueOnly is true. String
displayValueOnlyStyleClass Style class used when displayValueOnly is true. String
enabledOnUserRole If user is in given role, this component will be rendered normally. If not, no hyperlink is rendered but all nested tags (=body) are rendered. String
forceId If true, this component will force the use of the specified id when rendering. String
forceIdIndex If false, this component will not append a '[n]' suffix (where 'n' is the row index) to components that are contained within a "list." This value will be true by default and the value will be ignored if the value of forceId is false (or not specified.) 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
visibleOnUserRole If user is in given role, this component will be rendered normally. If not, nothing is rendered and the body of this tag will be skipped. String

<t:inputText>

Extends standard inputText by user role support. Unless otherwise specified, all attributes accept static values or EL expressions.

Can contain: JSP

Attributes

Name Description Type
accesskey HTML: Sets the access key for this element. String
align HTML: Specifies the horizontal alignment of this element. Deprecated in HTML 4.01. String
alt HTML: Specifies alternative text that can be used by a browser that can't show this element. String
autocomplete Non HTML standard attribute to disable browser's autocomplete function. 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
datafld Reserved for future use. String
dataformatas Reserved for future use. String
datasrc Reserved for future use. String
dir HTML: The direction of text display, either 'ltr' (left-to-right) or 'rtl' (right-to-left). String
disabled HTML: When true, this element cannot receive focus. String
disabledOnClientSide If true the input is rendered disabled on the client side and a hidden input is used to actualy submit his value back to the server. String
displayValueOnly If true, renders only the value of the component, but no input widget. Default is false. String
displayValueOnlyStyle Style used when displayValueOnly is true. String
displayValueOnlyStyleClass Style class used when displayValueOnly is true. String
enabledOnUserRole If user is in given role, this component will be rendered normally. If not, no hyperlink is rendered but all nested tags (=body) are rendered. String
forceId If true, this component will force the use of the specified id when rendering. String
forceIdIndex If false, this component will not append a '[n]' suffix (where 'n' is the row index) to components that are contained within a "list." This value will be true by default and the value will be ignored if the value of forceId is false (or not specified.) 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
visibleOnUserRole If user is in given role, this component will be rendered normally. If not, nothing is rendered and the body of this tag will be skipped. String

<t:inputTextHelp>

Extends standard inputText by helptext support. Unless otherwise specified, all attributes accept static values or EL expressions.

Can contain: JSP

Attributes

Name Description Type
accesskey HTML: Sets the access key for this element. String
align HTML: Specifies the horizontal alignment of this element. Deprecated in HTML 4.01. String
alt HTML: Specifies alternative text that can be used by a browser that can't show this element. String
autocomplete Non HTML standard attribute to disable browser's autocomplete function. 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
datafld Reserved for future use. String
dataformatas Reserved for future use. String
datasrc Reserved for future use. String
dir HTML: The direction of text display, either 'ltr' (left-to-right) or 'rtl' (right-to-left). String
disabled HTML: When true, this element cannot receive focus. String
disabledOnClientSide If true the input is rendered disabled on the client side and a hidden input is used to actualy submit his value back to the server. String
displayValueOnly If true, renders only the value of the component, but no input widget. Default is false. String
displayValueOnlyStyle Style used when displayValueOnly is true. String
displayValueOnlyStyleClass Style class used when displayValueOnly is true. String
enabledOnUserRole If user is in given role, this component will be rendered normally. If not, no hyperlink is rendered but all nested tags (=body) are rendered. String
forceId If true, this component will force the use of the specified id when rendering. String
forceIdIndex If false, this component will not append a '[n]' suffix (where 'n' is the row index) to components that are contained within a "list." This value will be true by default and the value will be ignored if the value of forceId is false (or not specified.) String
helpText 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
selectText 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
visibleOnUserRole If user is in given role, this component will be rendered normally. If not, nothing is rendered and the body of this tag will be skipped. String

<t:inputTextarea>

Extends standard inputTextarea by user role support. Unless otherwise specified, all attributes accept static values or EL expressions.

Can contain: JSP

Attributes

Name Description Type
accesskey HTML: Sets the access key for this element. String
binding Identifies a backing bean property (of type UIComponent or appropriate subclass) to bind to this component instance. This value must be an EL expression. String
cols HTML: The width of this element, in characters. String
converter An expression that specifies the Converter for this component. <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
datafld Reserved for future use. String
dataformatas Reserved for future use. String
datasrc Reserved for future use. String
dir HTML: The direction of text display, either 'ltr' (left-to-right) or 'rtl' (right-to-left). String
disabled HTML: When true, this element cannot receive focus. String
displayValueOnly If true, renders only the value of the component, but no input widget. Default is false. String
displayValueOnlyStyle Style used when displayValueOnly is true. String
displayValueOnlyStyleClass Style class used when displayValueOnly is true. String
enabledOnUserRole If user is in given role, this component will be rendered normally. If not, no hyperlink is rendered but all nested tags (=body) are rendered. String
forceId If true, this component will force the use of the specified id when rendering. String
forceIdIndex If false, this component will not append a '[n]' suffix (where 'n' is the row index) to components that are contained within a "list." This value will be true by default and the value will be ignored if the value of forceId is false (or not specified.) 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
visibleOnUserRole If user is in given role, this component will be rendered normally. If not, nothing is rendered and the body of this tag will be skipped. String
wrap None standard HTML attribute. Possible values are: soft, hard, virtual, physical and off. String

<t:jsValueChangeListener>

Value change listener on client side. <p> This component replicates the 'Value Change Listener' functionality on the client side. It can be used when the user would like a change in the value of one control to trigger off changes in the states of other controls. One or more Javascript Listeners can be nested within the source control (a control belonging to the 'javax.faces.Input' family). When the value of the source control is modified, the listeners are triggered and the states of the target controls modified. </p> <p> Unless otherwise specified, all attributes accept static values or EL expressions. </p>

Can contain: JSP

Attributes

Name Description Type
bodyTagEvent Events are triggered by the 'onchange' event of the source control. Here, an additional event can be specified (onload?). If specified this JavaScript event will be inserted in the body tag. JavaScript code will be the same like it is rendered in the parent component. String
expressionValue* the javascript expression to evaluate. The keyword '$srcElem' resolves to the source control and the keyword '$destElem' resolves to the target control String
for for - the id of the target control String
property The result of the evaluated expression is assigned to the specified property of the target control String

<t:jsValueSet>

Setting a value from the model in java-script so that it can be used (e.g. by the value change listener) afterwards. Unless otherwise specified, all attributes accept static values or EL expressions.

Can contain: JSP

Attributes

Name Description Type
name* javascript variable to be set. String
value* value to be set in the variable. String

<t:jscookMenu>

Renders a Javascript Menu. Nested NavigationMenuItem(s) are rendered as Javascript Menu. <p> This component is based based on the excellent <a href="http://jscook.sourceforge.net/JSCookMenu">JSCookMenu</a> by Heng Yuan. </p> Unless otherwise specified, all attributes accept static values or EL expressions.

Can contain: JSP

Attributes

Name Description Type
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
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
enabledOnUserRole If user is in given role, this component will be rendered normally. If not, no hyperlink is rendered but all nested tags (=body) are rendered. 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
imageLocation An alternate location to find image resources. If no values is specified, images will be loaded from the resources directory using AddResource and ExtensionsFilter. 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
javascriptLocation An alternate location to find javascript resources. If no values is specified, javascript will be loaded from the resources directory using AddResource and ExtensionsFilter. String
layout* String
rendered A boolean value that indicates whether this component should be rendered. Default value: true. String
styleLocation An alternate location to find stylesheet resources. If no values is specified, stylesheets will be loaded from the resources directory using AddResource and ExtensionsFilter. String
theme* String
visibleOnUserRole If user is in given role, this component will be rendered normally. If not, nothing is rendered and the body of this tag will be skipped. String

<t:message>

MyFaces extension to the standard messages tag: see summaryDetailSeparator attribute. Unless otherwise specified, all attributes accept static values or EL expressions.

Can contain: JSP

Attributes

Name Description Type
binding Identifies a backing bean property (of type UIComponent or appropriate subclass) to bind to this component instance. This value must be an EL expression. String
detailFormat If present, instead of rendering the message detail, a MessageFormat with this attribute as pattern is created. The format method of this MessageFormat is called with the message detail as the first argument and the label of the associated component (if any) as the second argument. Example: "The input in field {1} is wrong: {0}" String
dir HTML: The direction of text display, either 'ltr' (left-to-right) or 'rtl' (right-to-left). String
enabledOnUserRole If user is in given role, this component will be rendered normally. If not, no hyperlink is rendered but all nested tags (=body) are rendered. 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
forceId If true, this component will force the use of the specified id when rendering. String
forceIdIndex If false, this component will not append a '[n]' suffix (where 'n' is the row index) to components that are contained within a "list." This value will be true by default and the value will be ignored if the value of forceId is false (or not specified.) String
forceSpan If set to true, an empty span element is rendered. Useful if there is an inputAjax field and the corresponding error message is displayed there. 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
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
replaceIdWithLabel If present, all occurrences of the id of the component for which the message is rendered will be replaced by the label. Default: 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
summaryFormat If present, instead of rendering the message summary, a MessageFormat with this attribute as pattern is created. The format method of this MessageFormat is called with the message summary as the first argument and the label of the associated component (if any) as the second argument. Example: "{0}:" 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
visibleOnUserRole If user is in given role, this component will be rendered normally. If not, nothing is rendered and the body of this tag will be skipped. 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

<t:messages>

MyFaces extension to the standard messages tag: see showInputLabel attribute. Unless otherwise specified, all attributes accept static values or EL expressions.

Can contain: JSP

Attributes

Name Description Type
binding Identifies a backing bean property (of type UIComponent or appropriate subclass) to bind to this component instance. This value must be an EL expression. String
detailFormat If present, instead of rendering the message detail, a MessageFormat with this attribute as pattern is created. The format method of this MessageFormat is called with the message detail as the first argument and the label of the associated component (if any) as the second argument. Example: "The input in field {1} is wrong: {0}" String
dir HTML: The direction of text display, either 'ltr' (left-to-right) or 'rtl' (right-to-left). String
enabledOnUserRole If user is in given role, this component will be rendered normally. If not, no hyperlink is rendered but all nested tags (=body) are rendered. 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
forceId If true, this component will force the use of the specified id when rendering. String
forceIdIndex If false, this component will not append a '[n]' suffix (where 'n' is the row index) to components that are contained within a "list." This value will be true by default and the value will be ignored if the value of forceId is false (or not specified.) String
forceSpan If set to true, an empty span element is rendered. Useful if there is an inputAjax field and the corresponding error message is displayed there. 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
globalSummaryFormat Like summaryFormat, but applies to global messages (i.e. messages not associated with a component). If no globalSummaryFormat is given, the summaryFormat is used for global messages. Example: "{0}:" 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
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
replaceIdWithLabel If present, all occurrences of the id of the component for which the message is rendered will be replaced by the label. Default: 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
summaryFormat If present, instead of rendering the message summary, a MessageFormat with this attribute as pattern is created. The format method of this MessageFormat is called with the message summary as the first argument and the label of the associated component (if any) as the second argument. Example: "{0}:" 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
visibleOnUserRole If user is in given role, this component will be rendered normally. If not, nothing is rendered and the body of this tag will be skipped. 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

<t:navigationMenuItem>

A menu item. Used by navigationMenu, jscookMenu. Unless otherwise specified, all attributes accept static values or EL expressions.

Can contain: JSP

Attributes

Name Description Type
action Specifies the action to take when this command is invoked. If the value is an expression, it is expected to be a method binding EL expression that identifies an action method. An action method accepts no parameters and has a String return value, called the action outcome, that identifies the next view displayed. The phase that this event is fired in can be controlled via the immediate attribute. If the value is a string literal, it is treated as a navigation outcome for the current view. This is functionally equivalent to a reference to an action method that returns the string literal. String
actionListener A method binding EL expression that identifies an action listener method to be invoked if this component is activated by the user. An action listener method accepts a parameter of type javax.faces.event.ActionEvent and returns void. The phase that this event is fired in can be controlled via the immediate attribute. String
binding Identifies a backing bean property (of type UIComponent or appropriate subclass) to bind to this component instance. This value must be an EL expression. String
disabled When set instead of a Hyperlink a span tag is rendered in the corresponding Component String
disabledStyle CSS-Style Attribute to render when disabled is true String
disabledStyleClass CSS-Style Class to use when disabled is true String
enabledOnUserRole If user is in given role, this component will be rendered normally. If not, no hyperlink is rendered but all nested tags (=body) are rendered. String
escape The escape setting for the label of this selection item. String
icon 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
rendered A boolean value that indicates whether this component should be rendered. Default value: true. String
split String
target String
value The initial value of this component. String
visibleOnUserRole If user is in given role, this component will be rendered normally. If not, nothing is rendered and the body of this tag will be skipped. String

<t:navigationMenuItems>

A tree of menu items as returned by a value-expression. Unless otherwise specified, all attributes accept static values or EL expressions.

Can contain: JSP

Attributes

Name Description Type
binding Identifies a backing bean property (of type UIComponent or appropriate subclass) to bind to this component instance. This value must be an EL expression. String
id 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

<t:newspaperTable>

Model for a table in multiple balanced columns. The newspaperTable tag allows a long, narrow table to be wrapped so that it becomes a short, wide table. This allows more information to be shown on a single screen. This is commonly used to present checkboxes for a long list of items. A data table for rendering long skinny tables as short wide table by wrapping the table over a specified number of columns. Unless otherwise specified, all attributes accept static values or EL expressions.

Can contain: JSP

Attributes

Name Description Type
align HTML: Specifies the horizontal alignment of this element. Deprecated in HTML 4.01. String
bgcolor HTML: The background color of this element. String
binding Identifies a backing bean property (of type UIComponent or appropriate subclass) to bind to this component instance. This value must be an EL expression. String
border HTML: Specifies the width of the border of this element, in pixels. Deprecated in HTML 4.01. String
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
datafld Reserved for future use. String
dataformatas Reserved for future use. String
datasrc Reserved for future use. String
dir HTML: The direction of text display, either 'ltr' (left-to-right) or 'rtl' (right-to-left). String
first 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
newspaperColumns Set the number of columns the table will be divided over. In other words, the number of columns to wrap the table over. Default: 1 String
newspaperOrientation The orientation of the newspaper columns in the newspaper table - "horizontal" or "vertical". Default: vertical 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

<t:outputLabel>

Extends standard outputLabel with user role support. Unless otherwise specified, all attributes accept static values or EL expressions.

Can contain: JSP

Attributes

Name Description Type
accesskey HTML: Sets the access key for this element. String
binding Identifies a backing bean property (of type UIComponent or appropriate subclass) to bind to this component instance. This value must be an EL expression. String
converter An expression that specifies the Converter for this component. <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
enabledOnUserRole If user is in given role, this component will be rendered normally. If not, no hyperlink is rendered but all nested tags (=body) are rendered. 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
forceId If true, this component will force the use of the specified id when rendering. String
forceIdIndex If false, this component will not append a '[n]' suffix (where 'n' is the row index) to components that are contained within a "list." This value will be true by default and the value will be ignored if the value of forceId is false (or not specified.) 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
visibleOnUserRole If user is in given role, this component will be rendered normally. If not, nothing is rendered and the body of this tag will be skipped. String

<t:outputText>

Extends standard outputText with user role support. 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
dir HTML: The direction of text display, either 'ltr' (left-to-right) or 'rtl' (right-to-left). String
enabledOnUserRole If user is in given role, this component will be rendered normally. If not, no hyperlink is rendered but all nested tags (=body) are rendered. String
escape Indicates whether rendered markup should be escaped. Default: true String
forceId If true, this component will force the use of the specified id when rendering. String
forceIdIndex If false, this component will not append a '[n]' suffix (where 'n' is the row index) to components that are contained within a "list." This value will be true by default and the value will be ignored if the value of forceId is false (or not specified.) 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
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
visibleOnUserRole If user is in given role, this component will be rendered normally. If not, nothing is rendered and the body of this tag will be skipped. String

<t:panelGrid>

Extends standard panelGrid with user role support. Unless otherwise specified, all attributes accept static values or EL expressions.

Can contain: JSP

Attributes

Name Description Type
align HTML: Specifies the horizontal alignment of this element. Deprecated in HTML 4.01. String
bgcolor HTML: The background color of this element. String
binding Identifies a backing bean property (of type UIComponent or appropriate subclass) to bind to this component instance. This value must be an EL expression. String
border HTML: Specifies the width of the border of this element, in pixels. Deprecated in HTML 4.01. String
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
datafld Reserved for future use. String
dataformatas Reserved for future use. String
datasrc Reserved for future use. String
dir HTML: The direction of text display, either 'ltr' (left-to-right) or 'rtl' (right-to-left). String
displayValueOnly If true, renders only the value of the component, but no input widget. Default is false. String
displayValueOnlyStyle Style used when displayValueOnly is true. String
displayValueOnlyStyleClass Style class used when displayValueOnly is true. String
enabledOnUserRole If user is in given role, this component will be rendered normally. If not, no hyperlink is rendered but all nested tags (=body) are rendered. String
footerClass The CSS class to be applied to footer cells. String
forceId If true, this component will force the use of the specified id when rendering. String
forceIdIndex If false, this component will not append a '[n]' suffix (where 'n' is the row index) to components that are contained within a "list." This value will be true by default and the value will be ignored if the value of forceId is false (or not specified.) 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
visibleOnUserRole If user is in given role, this component will be rendered normally. If not, nothing is rendered and the body of this tag will be skipped. String
width HTML: Specifies the desired width of the table, as a pixel length or a percentage of available space. String

<t:panelGroup>

Extends standard panelGroup with user role support. 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
colspan standard html colspan attribute for table cell String
dir HTML: The direction of text display, either 'ltr' (left-to-right) or 'rtl' (right-to-left). String
displayValueOnly If true, renders only the value of the component, but no input widget. Default is false. String
displayValueOnlyStyle Style used when displayValueOnly is true. String
displayValueOnlyStyleClass Style class used when displayValueOnly is true. String
enabledOnUserRole If user is in given role, this component will be rendered normally. If not, no hyperlink is rendered but all nested tags (=body) are rendered. String
forceId If true, this component will force the use of the specified id when rendering. String
forceIdIndex If false, this component will not append a '[n]' suffix (where 'n' is the row index) to components that are contained within a "list." This value will be true by default and the value will be ignored if the value of forceId is false (or not specified.) 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
layout Determines the type of layout that is used when rendering a panelGroup: when 'block' is specified, an HTML div is rendered instead of the default HTML span. 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
visibleOnUserRole If user is in given role, this component will be rendered normally. If not, nothing is rendered and the body of this tag will be skipped. String

<t:panelLayout>

Determines where its children are positioned within the page relative to each other, similar to a Swing layout component. Unless otherwise specified, all attributes accept static values or EL expressions.

Can contain: JSP

Attributes

Name Description Type
align HTML: Specifies the horizontal alignment of this element. Deprecated in HTML 4.01. String
bgcolor HTML: The background color of this element. String
binding Identifies a backing bean property (of type UIComponent or appropriate subclass) to bind to this component instance. This value must be an EL expression. String
bodyClass CSS class to be used for the table cell. String
bodyStyle CSS class to be used for the table cell. String
border HTML: Specifies the width of the border of this element, in pixels. Deprecated in HTML 4.01. String
cellpadding HTML: Specifies the amount of empty space between the cell border and its contents. It can be either a pixel length or a percentage. String
cellspacing HTML: Specifies the amount of space between the cells of the table. It can be either a pixel length or a percentage of available space. String
datafld Reserved for future use. String
dataformatas Reserved for future use. String
datasrc Reserved for future use. String
dir HTML: The direction of text display, either 'ltr' (left-to-right) or 'rtl' (right-to-left). String
footerClass The CSS class to be applied to footer cells. String
footerStyle CSS class to be used for the table cell. 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
headerStyle CSS class to be used for the table cell. 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
layout <pre> layout | header | navigation | body | footer =================|========|============|=======|======== classic (Default)| top | left | right | bottom navigationRight | top | right | left | bottom upsideDown | bottom | left | right | top </pre> String
navigationClass CSS class to be used for the table cell. String
navigationStyle CSS class to be used for the table cell. 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
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

<t:panelNavigation>

Renders a vertical menu structure with support for nested menu items. Unless otherwise specified, all attributes accept static values or EL expressions. Panel, that includes navigation items ({@link HtmlCommandNavigation}) and other components (separators).

Can contain: JSP

Attributes

Name Description Type
activeItemClass The CSS class of the active navigation item. String
activeItemStyle The CSS Style of the active navigation item. String
align HTML: Specifies the horizontal alignment of this element. Deprecated in HTML 4.01. String
bgcolor HTML: The background color of this element. String
binding Identifies a backing bean property (of type UIComponent or appropriate subclass) to bind to this component instance. This value must be an EL expression. String
border HTML: Specifies the width of the border of this element, in pixels. Deprecated in HTML 4.01. String
cellpadding HTML: Specifies the amount of empty space between the cell border and its contents. It can be either a pixel length or a percentage. String
cellspacing HTML: Specifies the amount of space between the cells of the table. It can be either a pixel length or a percentage of available space. String
datafld Reserved for future use. String
dataformatas Reserved for future use. String
datasrc Reserved for future use. String
dir HTML: The direction of text display, either 'ltr' (left-to-right) or 'rtl' (right-to-left). String
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
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
itemClass The CSS class of closed navigation items. String
itemStyle The CSS Style of closed navigation items. String
lang HTML: The base language of this document. 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
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
openItemClass The CSS class of open navigation items. String
openItemStyle The CSS Style of open navigation items. String
rendered A boolean value that indicates whether this component should be rendered. Default value: true. String
rules HTML: Controls how rules are rendered between cells. Values include: none, groups, rows, cols, and all. String
separatorClass The CSS class for the td element of a separator. String
separatorStyle The CSS Style for the td element of a separator. 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

<t:panelNavigation2>

Renders a vertical menu structure with support for nested menu items. The menu is rendered as unordered List. The menu-tree can be dynamically build using NavigationMenuItem(s). Unless otherwise specified, all attributes accept static values or EL expressions. Many thanks to the guys from Swiss Federal Institute of Intellectual Property and Marc Bouquet for helping to develop this component.

Can contain: JSP

Attributes

Name Description Type
activeItemClass The CSS class of open navigation items. String
activeItemStyle The CSS Style of the active navigation item. String
align HTML: Specifies the horizontal alignment of this element. Deprecated in HTML 4.01. String
bgcolor HTML: The background color of this element. String
binding Identifies a backing bean property (of type UIComponent or appropriate subclass) to bind to this component instance. This value must be an EL expression. String
border HTML: Specifies the width of the border of this element, in pixels. Deprecated in HTML 4.01. String
cellpadding HTML: Specifies the amount of empty space between the cell border and its contents. It can be either a pixel length or a percentage. String
cellspacing HTML: Specifies the amount of space between the cells of the table. It can be either a pixel length or a percentage of available space. String
colspan standard html colspan attribute for table cell String
datafld Reserved for future use. String
dataformatas Reserved for future use. String
datasrc Reserved for future use. String
dir HTML: The direction of text display, either 'ltr' (left-to-right) or 'rtl' (right-to-left). String
disabled When set instead of a Hyperlink a span tag is rendered in the corresponding Component String
disabledStyle CSS-Style Attribute to render when disabled is true String
disabledStyleClass CSS-Style Class to use when disabled is true String
displayValueOnly If true, renders only the value of the component, but no input widget. Default is false. String
displayValueOnlyStyle Style used when displayValueOnly is true. String
displayValueOnlyStyleClass Style class used when displayValueOnly is true. String
enabledOnUserRole If user is in given role, this component will be rendered normally. If not, no hyperlink is rendered but all nested tags (=body) are rendered. String
expandAll If set to true all Items are expanded from the beginning and never closed. String
forceId If true, this component will force the use of the specified id when rendering. String
forceIdIndex If false, this component will not append a '[n]' suffix (where 'n' is the row index) to components that are contained within a "list." This value will be true by default and the value will be ignored if the value of forceId is false (or not specified.) 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
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
itemClass The CSS class of closed navigation items. String
itemStyle The CSS Style of closed navigation items. String
lang HTML: The base language of this document. String
layout 'table' or 'list' Layout (default is 'table') 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
openItemClass The CSS class of open navigation items. String
openItemStyle The CSS Style of open navigation items. String
renderAll If set to true all Items are rendered and other methods, like CSS should be used to hide them as necessary String
rendered A boolean value that indicates whether this component should be rendered. Default value: true. String
rules HTML: Controls how rules are rendered between cells. Values include: none, groups, rows, cols, and all. String
separatorClass The CSS class for the td element of a separator. String
separatorStyle The CSS Style for the td element of a separator. 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
visibleOnUserRole If user is in given role, this component will be rendered normally. If not, nothing is rendered and the body of this tag will be skipped. String
width HTML: Specifies the desired width of the table, as a pixel length or a percentage of available space. String

<t:panelStack>

A stack of panels, to switch panels dynamically. Manage a stack of JSF components and allow for one child component to be choosen for rendering. The behaviour is similar to the CardLayout of Java Swing. Property <code>selectedPanel</code> defines the id of the child to be rendered. If no child panel is selected or if the selected panel can not be found the first child is rendered. Unless otherwise specified, all attributes accept static values or EL expressions.

Can contain: JSP

Attributes

Name Description Type
binding Identifies a backing bean property (of type UIComponent or appropriate subclass) to bind to this component instance. This value must be an EL expression. String
id 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
selectedPanel* String

<t:panelTab>

TODO: Document this component. Unless otherwise specified, all attributes accept static values or EL expressions.

Can contain: JSP

Attributes

Name Description Type
binding Identifies a backing bean property (of type UIComponent or appropriate subclass) to bind to this component instance. This value must be an EL expression. String
dir HTML: The direction of text display, either 'ltr' (left-to-right) or 'rtl' (right-to-left). String
disabled HTML: When true, this element cannot receive focus. String
enabledOnUserRole If user is in given role, this component will be rendered normally. If not, no hyperlink is rendered but all nested tags (=body) are rendered. 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
label Label of this tab. String
lang HTML: The base language of this document. 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
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
visibleOnUserRole If user is in given role, this component will be rendered normally. If not, nothing is rendered and the body of this tag will be skipped. String

<t:panelTabbedPane>

TODO: Document this component. Unless otherwise specified, all attributes accept static values or EL expressions.

Can contain: JSP

Attributes

Name Description Type
activePanelTabVar Boolean Variable that is set in request scope when rendering a panelTab. True means that the currently rendered panelTab is active. String
activeSubStyleClass Style class of the active tab sub cell. String
activeTabStyleClass Style class of the active tab cell. String
align HTML: Specifies the horizontal alignment of this element. Deprecated in HTML 4.01. String
bgcolor HTML: The background color of this element. String
binding Identifies a backing bean property (of type UIComponent or appropriate subclass) to bind to this component instance. This value must be an EL expression. String
border HTML: Specifies the width of the border of this element, in pixels. Deprecated in HTML 4.01. String
cellpadding HTML: Specifies the amount of empty space between the cell border and its contents. It can be either a pixel length or a percentage. String
cellspacing HTML: Specifies the amount of space between the cells of the table. It can be either a pixel length or a percentage of available space. String
datafld Reserved for future use. String
dataformatas Reserved for future use. String
datasrc Reserved for future use. String
dir HTML: The direction of text display, either 'ltr' (left-to-right) or 'rtl' (right-to-left). String
disabledTabStyleClass Style class of the disabled tab cells. String
enabledOnUserRole If user is in given role, this component will be rendered normally. If not, no hyperlink is rendered but all nested tags (=body) are rendered. 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
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
immediateTabChange Define if the process validation and update model phases should be executed before change between tabs, when serverSideTabSwitch = true (if is false, the switch is done by other way so this property does not have any effect). Note that if this property is set as false, only a tab change is done if all input fields inside the form are valid (including input components outside this panel). By default is true, so both phases are not executed. String
inactiveSubStyleClass Style class of the inactive tab sub cells. String
inactiveTabStyleClass Style class of the inactive tab cells. String
lang HTML: The base language of this document. 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
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
rules HTML: Controls how rules are rendered between cells. Values include: none, groups, rows, cols, and all. String
selectedIndex Index of tab that is selected by default. String
serverSideTabSwitch Toggle client-side/server-side tab switches. 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
tabContentStyleClass Style class of the active tab content cell. String
title HTML: An advisory title for this element. Often used by the user agent as a tooltip. String
visibleOnUserRole If user is in given role, this component will be rendered normally. If not, nothing is rendered and the body of this tag will be skipped. String
width HTML: Specifies the desired width of the table, as a pixel length or a percentage of available space. String

<t:popup>

Renders a popup which displays on a mouse event. 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
closePopupOnExitingElement Close the popup when the triggering element is left. String
closePopupOnExitingPopup Close the popup when the popup itself is left. String
dir HTML: The direction of text display, either 'ltr' (left-to-right) or 'rtl' (right-to-left). String
displayAtDistanceX Pop the panel up in horizontal distance of x pixels from event. String
displayAtDistanceY Pop the panel up in vertical distance of y pixels from event. String
enabledOnUserRole If user is in given role, this component will be rendered normally. If not, no hyperlink is rendered but all nested tags (=body) are rendered. 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
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
visibleOnUserRole If user is in given role, this component will be rendered normally. If not, nothing is rendered and the body of this tag will be skipped. String

<t:radio>

This tag is used in conjunction with the extended selectOneRadio tag when the "spread" layout is selected. It specifies the position within the document that the radio button corresponding to a specific SelectItem should be rendered. All HTML pass-through attributes for this input are taken from the associated selectOneRadio. 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
enabledOnUserRole If user is in given role, this component will be rendered normally. If not, no hyperlink is rendered but all nested tags (=body) are rendered. String
for* The id of the referenced extended selectOneRadio component. This value is resolved to the particular component using the standard UIComponent.findComponent() searching algorithm. 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
index* The index of the corresponding SelectItem, where 0 represents the first SelectItem. String
rendered A boolean value that indicates whether this component should be rendered. Default value: true. String
visibleOnUserRole If user is in given role, this component will be rendered normally. If not, nothing is rendered and the body of this tag will be skipped. String

<t:saveState>

Provides the ability to store a model value inside the view's component tree. <p> JSF provides three scopes for managed beans and therefore all the model objects that the managed beans reference: request, session, application. However a common requirement is a way for a model object to have a scope that is tied to the duration of the current view; that is longer than the request scope but shorter than session scope. </p> <p> This component simply holds a reference to an arbitrary object (specified by the value property). Because this object is an ordinary component whose scope is the current view, the reference to the model automatically has that same scope. </p> <p> When the value is an EL expression, then after the view is restored the recreated target object is stored at the specified location. </p> <p> The object being saved must either: </p> <ul> <li>implement java.io.Serializable, or</li> <li>implement javax.faces.component.StateHolder and have a default constructor.</li> </ul> <p> Note that the saved object can be "chained" from view to view in order to extend its lifetime from a single view to a sequence of views if desired. A UISaveState component with an EL expression such as "#{someBean}" will save the object state after render, and restore it on postback. If navigation occurs to some other view and that view has a UISaveState component with the same EL expression then the object will simply be saved into the new view, thus extending its lifetime. </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
value The value of this component. String

<t:schedule>

A schedule component similar to the ones found in Outlook or Evolution <p> Renders a schedule component, showing appointments and events in a day, workweek, week or month view, similar to the schedule part of MS Outlook or Evolution. </p><p> The component is backed by an implementation of the ScheduleModel interface. Creating a custom model can be easily achieved by implementing this interface, or by overriding the AbstractScheduleModel class. </p><p> AbstractHtmlSchedule class holds all properties specific to the HTML version of the Schedule component. </p>

Can contain: JSP

Attributes

Name Description Type
action Gets Specifies the action to take when this command is invoked. If the value is an expression, it is expected to be a method binding EL expression that identifies an action method. An action method accepts no parameters and has a String return value, called the action outcome, that identifies the next view displayed. The phase that this event is fired in can be controlled via the immediate attribute. If the value is a string literal, it is treated as a navigation outcome for the current view. This is functionally equivalent to a reference to an action method that returns the string literal. String
actionListener String
backgroundClass 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
columnClass String
compactMonthDayOfWeekDateFormat String
compactMonthRowHeight String
compactWeekRowHeight String
contentClass String
converter String
dateClass String
dayClass String
detailedRowHeight String
enabledOnUserRole If user is in given role, this component will be rendered normally. If not, no hyperlink is rendered but all nested tags (=body) are rendered. String
entryClass String
entryRenderer String
evenClass String
expandToFitEntries String
foregroundClass String
freeClass String
gutterClass String
headerClass String
headerDateFormat String
holidayClass String
hourNotation <p> Show dates in 24 hour notation or 12 hour notation. </p> String
hoursClass 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 String
inactiveDayClass String
minutesClass String
monthClass String
mouseListener String
readonly String
renderZeroLengthEntries String
rendered A boolean value that indicates whether this component should be rendered. Default value: true. String
selectedClass String
selectedEntryClass String
splitWeekend String
submitOnClick Should the parent form of this schedule be submitted when the user clicks on a day? Note that this will only work when the readonly property is set to false. String
subtitleClass String
textClass String
theme String
titleClass String
tooltip String
unevenClass String
value String
visibleEndHour String
visibleOnUserRole If user is in given role, this component will be rendered normally. If not, nothing is rendered and the body of this tag will be skipped. String
visibleStartHour String
weekClass the css class of the table representing a week in the compact mode (default: week) String
workingEndHour String
workingStartHour String

<t:selectBooleanCheckbox>

Extends standard selectBooleanCheckbox with user role support. Unless otherwise specified, all attributes accept static values or EL expressions.

Can contain: JSP

Attributes

Name Description Type
accesskey HTML: Sets the access key for this element. String
alt HTML: Specifies alternative text that can be used by a browser that can't show this element. String
binding Identifies a backing bean property (of type UIComponent or appropriate subclass) to bind to this component instance. This value must be an EL expression. String
converter An expression that specifies the Converter for this component. <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
datafld Reserved for future use. String
dataformatas Reserved for future use. String
datasrc Reserved for future use. String
dir HTML: The direction of text display, either 'ltr' (left-to-right) or 'rtl' (right-to-left). String
disabled HTML: When true, this element cannot receive focus. String
displayValueOnly If true, renders only the value of the component, but no input widget. Default is false. String
displayValueOnlyStyle Style used when displayValueOnly is true. String
displayValueOnlyStyleClass Style class used when displayValueOnly is true. String
enabledOnUserRole If user is in given role, this component will be rendered normally. If not, no hyperlink is rendered but all nested tags (=body) are rendered. String
escape Indicates whether rendered markup should be escaped. Default: true String
forceId If true, this component will force the use of the specified id when rendering. String
forceIdIndex If false, this component will not append a '[n]' suffix (where 'n' is the row index) to components that are contained within a "list." This value will be true by default and the value will be ignored if the value of forceId is false (or not specified.) 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
visibleOnUserRole If user is in given role, this component will be rendered normally. If not, nothing is rendered and the body of this tag will be skipped. String

<t:selectItems>

An extended version of the standard UISelectItems. Populates the SelectItem collection from the given value automatically using the itemLabel and itemValue attributes. By using the component there is no need to manually create a SelectItem collection because component automatically populates SelectItem objects from types like Collection, Map and etc..

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
itemDescription name of the selectitem String
itemDisabled disabled state of the selectitem String
itemLabel name of the selectitem String
itemLabelEscaped indicate if the label should be escaped of the selectitem String
itemValue value of the selectitem String
value The initial value of this component. String
var name of the iterator String

<t:selectManyCheckbox>

Extends standard selectManyCheckbox with user role support. Additionally this extended selectManyCheckbox accepts a layout attribute of value "spread" (see custom checkbox tag). Unless otherwise specified, all attributes accept static values or EL expressions.

Can contain: JSP

Attributes

Name Description Type
accesskey HTML: Sets the access key for this element. String
alt HTML: Specifies alternative text that can be used by a browser that can't show this element. String
binding Identifies a backing bean property (of type UIComponent or appropriate subclass) to bind to this component instance. This value must be an EL expression. String
border HTML: Specifies the width of the border of this element, in pixels. Deprecated in HTML 4.01. String
converter An expression that specifies the Converter for this component. <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
datafld Reserved for future use. String
dataformatas Reserved for future use. String
datasrc Reserved for future use. String
dir HTML: The direction of text display, either 'ltr' (left-to-right) or 'rtl' (right-to-left). String
disabled HTML: When true, this element cannot receive focus. String
disabledClass The CSS class assigned to the label element for enabled choices. String
displayValueOnly If true, renders only the value of the component, but no input widget. Default is false. String
displayValueOnlyStyle Style used when displayValueOnly is true. String
displayValueOnlyStyleClass Style class used when displayValueOnly is true. String
enabledClass The CSS class assigned to the label element for enabled choices. String
enabledOnUserRole If user is in given role, this component will be rendered normally. If not, no hyperlink is rendered but all nested tags (=body) are rendered. String
escape Indicates whether rendered markup should be escaped. Default: true String
forceId If true, this component will force the use of the specified id when rendering. String
forceIdIndex If false, this component will not append a '[n]' suffix (where 'n' is the row index) to components that are contained within a "list." This value will be true by default and the value will be ignored if the value of forceId is false (or not specified.) 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
layoutWidth A integer representing the number of checkbox rows if the layout is lineDirection and checkbox columns if the layout is pageDirection. 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
visibleOnUserRole If user is in given role, this component will be rendered normally. If not, nothing is rendered and the body of this tag will be skipped. String

<t:selectManyListbox>

Extends standard selectManyListbox with user role support. Unless otherwise specified, all attributes accept static values or EL expressions.

Can contain: JSP

Attributes

Name Description Type
accesskey HTML: Sets the access key for this element. String
binding Identifies a backing bean property (of type UIComponent or appropriate subclass) to bind to this component instance. This value must be an EL expression. String
converter An expression that specifies the Converter for this component. <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
datafld Reserved for future use. String
dataformatas Reserved for future use. String
datasrc Reserved for future use. String
dir HTML: The direction of text display, either 'ltr' (left-to-right) or 'rtl' (right-to-left). String
disabled HTML: When true, this element cannot receive focus. String
disabledClass The CSS class assigned to the label element for enabled choices. String
displayValueOnly If true, renders only the value of the component, but no input widget. Default is false. String
displayValueOnlyStyle Style used when displayValueOnly is true. String
displayValueOnlyStyleClass Style class used when displayValueOnly is true. String
enabledClass The CSS class assigned to the label element for enabled choices. String
enabledOnUserRole If user is in given role, this component will be rendered normally. If not, no hyperlink is rendered but all nested tags (=body) are rendered. String
escape Indicates whether rendered markup should be escaped. Default: true String
forceId If true, this component will force the use of the specified id when rendering. String
forceIdIndex If false, this component will not append a '[n]' suffix (where 'n' is the row index) to components that are contained within a "list." This value will be true by default and the value will be ignored if the value of forceId is false (or not specified.) 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
visibleOnUserRole If user is in given role, this component will be rendered normally. If not, nothing is rendered and the body of this tag will be skipped. String

<t:selectManyMenu>

Extends standard selectManyMenu with user role support. Unless otherwise specified, all attributes accept static values or EL expressions.

Can contain: JSP

Attributes

Name Description Type
accesskey HTML: Sets the access key for this element. String
binding Identifies a backing bean property (of type UIComponent or appropriate subclass) to bind to this component instance. This value must be an EL expression. String
converter An expression that specifies the Converter for this component. <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
datafld Reserved for future use. String
dataformatas Reserved for future use. String
datasrc Reserved for future use. String
dir HTML: The direction of text display, either 'ltr' (left-to-right) or 'rtl' (right-to-left). String
disabled HTML: When true, this element cannot receive focus. String
disabledClass The CSS class assigned to the label element for enabled choices. String
displayValueOnly If true, renders only the value of the component, but no input widget. Default is false. String
displayValueOnlyStyle Style used when displayValueOnly is true. String
displayValueOnlyStyleClass Style class used when displayValueOnly is true. String
enabledClass The CSS class assigned to the label element for enabled choices. String
enabledOnUserRole If user is in given role, this component will be rendered normally. If not, no hyperlink is rendered but all nested tags (=body) are rendered. String
escape Indicates whether rendered markup should be escaped. Default: true String
forceId If true, this component will force the use of the specified id when rendering. String
forceIdIndex If false, this component will not append a '[n]' suffix (where 'n' is the row index) to components that are contained within a "list." This value will be true by default and the value will be ignored if the value of forceId is false (or not specified.) 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
visibleOnUserRole If user is in given role, this component will be rendered normally. If not, nothing is rendered and the body of this tag will be skipped. String

<t:selectManyPicklist>

A picklist component that allows to select items from one list to another <p> In other words, is a selection component where a set of items can be selected from a list that contains all the available items to a list that contains the selected items. </p> <p> The component is based on the t:selectManyListbox component, so it contains the same attributes. Soon, more specific attributes will be added. </p>

Can contain: JSP

Attributes

Name Description Type
accesskey HTML: Sets the access key for this element. String
addAllButtonStyle CSS style to be applied to the add all button String
addAllButtonStyleClass CSS styleClass to be applied to the add all button String
addAllButtonText Define the text that goes inside the add all button String
addButtonStyle CSS style to be applied to the add button String
addButtonStyleClass CSS styleClass to be applied to the add button String
addButtonText Define the text that goes inside the add button 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
datafld Reserved for future use. String
dataformatas Reserved for future use. String
datasrc Reserved for future use. String
dir HTML: The direction of text display, either 'ltr' (left-to-right) or 'rtl' (right-to-left). String
disabled HTML: When true, this element cannot receive focus. String
disabledClass The CSS class assigned to the label element for enabled choices. String
displayValueOnly If true, renders only the value of the component, but no input widget. Default is false. String
displayValueOnlyStyle Style used when displayValueOnly is true. String
displayValueOnlyStyleClass Style class used when displayValueOnly is true. String
enabledClass The CSS class assigned to the label element for enabled choices. String
enabledOnUserRole If user is in given role, this component will be rendered normally. If not, no hyperlink is rendered but all nested tags (=body) are rendered. String
escape Indicates whether rendered markup should be escaped. Default: true String
forceId If true, this component will force the use of the specified id when rendering. String
forceIdIndex If false, this component will not append a '[n]' suffix (where 'n' is the row index) to components that are contained within a "list." This value will be true by default and the value will be ignored if the value of forceId is false (or not specified.) 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
removeAllButtonStyle CSS style to be applied to the remove all button String
removeAllButtonStyleClass CSS styleClass to be applied to the remove all button String
removeAllButtonText Define the text that goes inside the remove all button String
removeButtonStyle CSS style to be applied to the remove button String
removeButtonStyleClass CSS styleClass to be applied to the remove button String
removeButtonText Define the text that goes inside the remove button 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
visibleOnUserRole If user is in given role, this component will be rendered normally. If not, nothing is rendered and the body of this tag will be skipped. String

<t:selectOneCountry>

A localized list of countries choose box. The value binds to the country ISO 3166 code. This is the same code as for java.util.Locale.getCountry(). The official codes list is available here : http://www.iso.ch/iso/en/prods-services/iso3166ma/02iso-3166-code-lists/list-en1.html Unless otherwise specified, all attributes accept static values or EL expressions.

Can contain: JSP

Attributes

Name Description Type
accesskey HTML: Sets the access key for this element. String
binding Identifies a backing bean property (of type UIComponent or appropriate subclass) to bind to this component instance. This value must be an EL expression. String
converter An expression that specifies the Converter for this component. <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
datafld Reserved for future use. String
dataformatas Reserved for future use. String
datasrc Reserved for future use. String
dir HTML: The direction of text display, either 'ltr' (left-to-right) or 'rtl' (right-to-left). String
disabled HTML: When true, this element cannot receive focus. String
disabledClass The CSS class assigned to the label element for enabled choices. String
displayValueOnly If true, renders only the value of the component, but no input widget. Default is false. String
displayValueOnlyStyle Style used when displayValueOnly is true. String
displayValueOnlyStyleClass Style class used when displayValueOnly is true. String
emptySelection Integer equals to the maximum number of characters in the country name. String
enabledClass The CSS class assigned to the label element for enabled choices. String
enabledOnUserRole If user is in given role, this component will be rendered normally. If not, no hyperlink is rendered but all nested tags (=body) are rendered. String
escape Indicates whether rendered markup should be escaped. Default: true String
forceId If true, this component will force the use of the specified id when rendering. String
forceIdIndex If false, this component will not append a '[n]' suffix (where 'n' is the row index) to components that are contained within a "list." This value will be true by default and the value will be ignored if the value of forceId is false (or not specified.) 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 Integer equals to the maximum number of characters in the country name. 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
visibleOnUserRole If user is in given role, this component will be rendered normally. If not, nothing is rendered and the body of this tag will be skipped. String

<t:selectOneLanguage>

A localized list of languages choose box. The value binds to the language ISO 639 code (lowercase). This is the same code as for java.util.Locale.getLanguage(). The official codes list is available here : http://www.loc.gov/standards/iso639-2/englangn.html Unless otherwise specified, all attributes accept static values or EL expressions.

Can contain: JSP

Attributes

Name Description Type
accesskey HTML: Sets the access key for this element. String
binding Identifies a backing bean property (of type UIComponent or appropriate subclass) to bind to this component instance. This value must be an EL expression. String
converter An expression that specifies the Converter for this component. <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
datafld Reserved for future use. String
dataformatas Reserved for future use. String
datasrc Reserved for future use. String
dir HTML: The direction of text display, either 'ltr' (left-to-right) or 'rtl' (right-to-left). String
disabled HTML: When true, this element cannot receive focus. String
disabledClass The CSS class assigned to the label element for enabled choices. String
displayValueOnly If true, renders only the value of the component, but no input widget. Default is false. String
displayValueOnlyStyle Style used when displayValueOnly is true. String
displayValueOnlyStyleClass Style class used when displayValueOnly is true. String
emptySelection Label and value to be used when displaying an empty selection String
enabledClass The CSS class assigned to the label element for enabled choices. String
enabledOnUserRole If user is in given role, this component will be rendered normally. If not, no hyperlink is rendered but all nested tags (=body) are rendered. String
escape Indicates whether rendered markup should be escaped. Default: true String
forceId If true, this component will force the use of the specified id when rendering. String
forceIdIndex If false, this component will not append a '[n]' suffix (where 'n' is the row index) to components that are contained within a "list." This value will be true by default and the value will be ignored if the value of forceId is false (or not specified.) 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 Integer equals to the maximum number of characters in the language name. 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
visibleOnUserRole If user is in given role, this component will be rendered normally. If not, nothing is rendered and the body of this tag will be skipped. String

<t:selectOneListbox>

Extends standard selectOneListbox with user role support. Unless otherwise specified, all attributes accept static values or EL expressions.

Can contain: JSP

Attributes

Name Description Type
accesskey HTML: Sets the access key for this element. String
binding Identifies a backing bean property (of type UIComponent or appropriate subclass) to bind to this component instance. This value must be an EL expression. String
converter An expression that specifies the Converter for this component. <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
datafld Reserved for future use. String
dataformatas Reserved for future use. String
datasrc Reserved for future use. String
dir HTML: The direction of text display, either 'ltr' (left-to-right) or 'rtl' (right-to-left). String
disabled HTML: When true, this element cannot receive focus. String
disabledClass The CSS class assigned to the label element for enabled choices. String
displayValueOnly If true, renders only the value of the component, but no input widget. Default is false. String
displayValueOnlyStyle Style used when displayValueOnly is true. String
displayValueOnlyStyleClass Style class used when displayValueOnly is true. String
enabledClass The CSS class assigned to the label element for enabled choices. String
enabledOnUserRole If user is in given role, this component will be rendered normally. If not, no hyperlink is rendered but all nested tags (=body) are rendered. String
escape Indicates whether rendered markup should be escaped. Default: true String
forceId If true, this component will force the use of the specified id when rendering. String
forceIdIndex If false, this component will not append a '[n]' suffix (where 'n' is the row index) to components that are contained within a "list." This value will be true by default and the value will be ignored if the value of forceId is false (or not specified.) 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
visibleOnUserRole If user is in given role, this component will be rendered normally. If not, nothing is rendered and the body of this tag will be skipped. String

<t:selectOneMenu>

Extends standard selectOneMenu with user role support. Unless otherwise specified, all attributes accept static values or EL expressions.

Can contain: JSP

Attributes

Name Description Type
accesskey HTML: Sets the access key for this element. String
binding Identifies a backing bean property (of type UIComponent or appropriate subclass) to bind to this component instance. This value must be an EL expression. String
converter An expression that specifies the Converter for this component. <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
datafld Reserved for future use. String
dataformatas Reserved for future use. String
datasrc Reserved for future use. String
dir HTML: The direction of text display, either 'ltr' (left-to-right) or 'rtl' (right-to-left). String
disabled HTML: When true, this element cannot receive focus. String
disabledClass The CSS class assigned to the label element for enabled choices. String
displayValueOnly If true, renders only the value of the component, but no input widget. Default is false. String
displayValueOnlyStyle Style used when displayValueOnly is true. String
displayValueOnlyStyleClass Style class used when displayValueOnly is true. String
enabledClass The CSS class assigned to the label element for enabled choices. String
enabledOnUserRole If user is in given role, this component will be rendered normally. If not, no hyperlink is rendered but all nested tags (=body) are rendered. String
escape Indicates whether rendered markup should be escaped. Default: true String
forceId If true, this component will force the use of the specified id when rendering. String
forceIdIndex If false, this component will not append a '[n]' suffix (where 'n' is the row index) to components that are contained within a "list." This value will be true by default and the value will be ignored if the value of forceId is false (or not specified.) 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
visibleOnUserRole If user is in given role, this component will be rendered normally. If not, nothing is rendered and the body of this tag will be skipped. String

<t:selectOneRadio>

Implements the standard html selectOneRadio tag, with additional features. Supports user roles. Supports the "spread" layout value, which gives developer control over radio button positioning. See the "layout" attribute and the "radio" tag for further information. Unless otherwise specified, all attributes accept static values or EL expressions.

Can contain: JSP

Attributes

Name Description Type
accesskey HTML: Sets the access key for this element. String
alt HTML: Specifies alternative text that can be used by a browser that can't show this element. String
binding Identifies a backing bean property (of type UIComponent or appropriate subclass) to bind to this component instance. This value must be an EL expression. String
border Width in pixels of the border to be drawn around the table containing the options list. String
converter An expression that specifies the Converter for this component. <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
datafld Reserved for future use. String
dataformatas Reserved for future use. String
datasrc Reserved for future use. String
dir HTML: The direction of text display, either 'ltr' (left-to-right) or 'rtl' (right-to-left). String
disabled HTML: When true, this element cannot receive focus. String
disabledClass The CSS class assigned to the label element for enabled choices. String
displayValueOnly If true, renders only the value of the component, but no input widget. Default is false. String
displayValueOnlyStyle Style used when displayValueOnly is true. String
displayValueOnlyStyleClass Style class used when displayValueOnly is true. String
enabledClass The CSS class assigned to the label element for enabled choices. String
enabledOnUserRole If user is in given role, this component will be rendered normally. If not, no hyperlink is rendered but all nested tags (=body) are rendered. String
escape Indicates whether rendered markup should be escaped. Default: true String
forceId If true, this component will force the use of the specified id when rendering. String
forceIdIndex If false, this component will not append a '[n]' suffix (where 'n' is the row index) to components that are contained within a "list." This value will be true by default and the value will be ignored if the value of forceId is false (or not specified.) 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
visibleOnUserRole If user is in given role, this component will be rendered normally. If not, nothing is rendered and the body of this tag will be skipped. String

<t:selectOneRow>

Enhancement for a data-table to select one Row with a radio button. The row-index is stored in the vealu-binding

Can contain: JSP

Attributes

Name Description Type
align HTML: Specifies the horizontal alignment of this element. Deprecated in HTML 4.01. 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
disabled HTML: When true, this element cannot receive focus. String
groupName The Name of the radio-button-group to use 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
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
onfocus HTML: Specifies a script to be invoked when the element receives focus. 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
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

<t:stylesheet>

Renders the path to a common CSS-file

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
enabledOnUserRole If user is in given role, this component will be rendered normally. If not, no hyperlink is rendered but all nested tags (=body) are rendered. String
filtered Cause EL expressions in the stylesheet to be evaluated. <p> When true, any EL expression in the stylesheet will be evaluated and replaced by its string representation on the first access. The stylesheet will be processed only once. Every subsequent request will get a cached view. </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
inline Inline the stylesheet file content as in contrast to referencing it as a link. <p> The file referenced by the path attribute is loaded, and its content is written to the page wrapped in an &lt;script&gt; tag. </p> <p> When this option is enabled, the path property must contain an absolute path within the current webapp. External urls ("http://*") and paths relative to the current page are not supported. </p> String
media Define the target media of the styles: <dl> <dt>screen</dt> <dd>Intended for non-paged computer screens.</dd> <dt>tty</dt> <dd>Intended for media using a fixed-pitch character grid, such as teletypes, terminals, or portable devices with limited display capabilities.</dd> <dt>tv</dt> <dd>Intended for television-type devices (low resolution, color, limited scrollability).</dd> <dt>projection</dt> <dd>Intended for projectors.</dd> <dt>handheld</dt> <dd>Intended for handheld devices (small screen, monochrome, bitmapped graphics, limited bandwidth).</dd> <dt>print</dt> <dd>Intended for paged, opaque material and for documents viewed on screen in print preview mode.</dd> <dt>braille</dt> <dd>Intended for braille tactile feedback devices.</dd> <dt>aural</dt> <dd>Intended for speech synthesizers.</dd> <dt>all</dt> <dd>Suitable for all devices.</dd> </dl> Could be a comma separated list. See also http://www.w3.org/TR/REC-html40/types.html#type-media-descriptors String
path* URL for CSS-file. <p> If this path starts with a slash, then the webapp context path will be prepended to it. This makes it simple to reference stylesheets at an absolute path within the webapp. A value like "/styles/style.css" becomes "/webappname/styles/style.css". </p> <p> If this path does not start with a slash, then it is output unaltered. This supports absolute urls ("http://host/path/style.css"). It also supports having css files relative to the current page ("style.css" or "styles/style.css") but this needs to be used with care as the standard JSF postback/internal-forward navigation style can cause browsers to use an inappropriate base url when resolving relative references. </p> String
rendered A boolean value that indicates whether this component should be rendered. Default value: true. String
visibleOnUserRole If user is in given role, this component will be rendered normally. If not, nothing is rendered and the body of this tag will be skipped. String

<t:subform>

A SubForm which will allow for partial validation and model update. <p> A subform to an existing form. Inputs in this form will only be validated and updated, if a t:commandButton or t:commandLink has been clicked with an actionFor attribute which references the client-id of this subform. Optionally, the validation will trigger if a commandButton or commandLink embedded in this subform has been clicked, except if this command is a t:commandButton or t:commandLink with an actionFor attribute which doesn't reference the client-id of this subform. </p> <p> Components will be validated and updated only if either a child-component of this form caused the submit of the form, or an extended commandLink or commandButton with the actionFor attribute set to the client-id of this component was used. </p> <p> You can have several comma-separated entries in the actionFor-attribute - with this it's possible to validate and update more than one subForm at once. </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
preserveSubmittedValues true|false - set to false if you submit other subforms and would like to have your subform reflecting any model update. Default: true String
rendered A boolean value that indicates whether this component should be rendered. Default value: true. String

<t:swapImage>

Unless otherwise specified, all attributes accept static values or EL expressions.

Can contain: JSP

Attributes

Name Description Type
activeImageUrl activeImage will be rendered if: swapImage is a direct child of commandNavigation and the commandNavigation.isActive String
align HTML: Specifies the horizontal alignment of this element. Deprecated in HTML 4.01. String
alt HTML: Specifies alternative text that can be used by a browser that can't show this element. String
binding Identifies a backing bean property (of type UIComponent or appropriate subclass) to bind to this component instance. This value must be an EL expression. String
border HTML: Specifies the width of the border of this element, in pixels. Deprecated in HTML 4.01. 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
hspace HTML: The amount of white space to be inserted to the left and right of this element, in undefined units. Deprecated in HTML 4.01. 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
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
swapImageUrl* the url of the image displayed onmouseover 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
vspace HTML: The amount of white space to be inserted above and below this element, in undefined units. Deprecated in HTML 4.01. String
width HTML: Overrides the natural width of this image, by specifying width in pixels. String

<t:tabChangeListener>

Tag to add a tab change listeners to a {@link org.apache.myfaces.custom.tabbedpane.HtmlPanelTabbedPane}

Can contain: empty

Attributes

Name Description Type
type* String

<t:toggleGroup>

Container class allows user to toggle between view/edit mode. Extends PanelGroup. Allows user to have several toggleLink in a group. When the togglePanel is toggled, the toggleGroup will be hidden.

Can contain: JSP

Attributes

Name Description Type
binding Identifies a backing bean property (of type UIComponent or appropriate subclass) to bind to this component instance. This value must be an EL expression. String
dir HTML: The direction of text display, either 'ltr' (left-to-right) or 'rtl' (right-to-left). String
id 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
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
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
toggled HTML: Flag to define the toggle status. String

<t:toggleLink>

Extends standard outputLink but links to a dynamically rendered resource (image, file, ...). Should be nested within an HtmlToggleGroup component. Controls nested within this component will be displayed in 'view' mode, controls outside this component (within the parent HtmlToggleGroup) will be displayed in 'edit' mode.

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 HTML: When true, this element cannot receive focus. String
enabledOnUserRole If user is in given role, this component will be rendered normally. If not, no hyperlink is rendered but all nested tags (=body) are rendered. String
for* The class which implements org.apache.myfaces.custom.dynamicResources.ResourceRenderer. The resource renderer is responsible for resource the image. The class must have a default constructor. Any request scoped attribute or managed bean is not available when this resource renderer is instantiated and used. The resource renderer must render the binary data for the resource by using the parameters passed by nested f:param elements and/or using session or application scoped beans. String
forceId If true, this component will force the use of the specified id when rendering. String
forceIdIndex If false, this component will not append a '[n]' suffix (where 'n' is the row index) to components that are contained within a "list." This value will be true by default and the value will be ignored if the value of forceId is false (or not specified.) 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
onClickFocusId Id of the component that will be focused when toggleLink is clicked 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
visibleOnUserRole If user is in given role, this component will be rendered normally. If not, nothing is rendered and the body of this tag will be skipped. String

<t:togglePanel>

Container class allows user to toggle between view/edit mode. Extends PanelGroup. Allows user to toggle between 'view' mode and 'edit' mode. In the togglePanel, include a toggleLink. When the toggleLink is clicked, the rest of the group is shown, and the link is hidden.

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
disabled 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
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
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
toggled You can set toggled to true to force the toggleGroup to always be in toggle mode. Default is false. String

<t:tree>

A tree data component. Unless otherwise specified, all attributes accept static values or EL expressions. <p> Tree implementation based on javax.swing.JTree. </p> <p> The tree model is assigned by using a value binding named <code>model</code> and is not stored in view state. </p> <p> A hierarchy of {@link HtmlTreeNode}objects is used to represent the current expanded state of the tree. The root node is held as a faces named * <code>rootNode</code>. </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
columnClasses String
expandRoot String
expireListeners Time interval the tree will remain registered as a TreeModelListener without being accessed String
footerClass String
headerClass String
iconChildFirst String
iconChildLast String
iconChildMiddle String
iconClass String
iconLine String
iconNodeClose String
iconNodeCloseFirst String
iconNodeCloseLast String
iconNodeCloseMiddle String
iconNodeOpen String
iconNodeOpenFirst String
iconNodeOpenLast String
iconNodeOpenMiddle String
iconNoline 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
nodeClass String
rendered A boolean value that indicates whether this component should be rendered. Default value: true. String
rowClasses String
selectedNodeClass String
styleClass The CSS class for this element. Corresponds to the HTML 'class' attribute. String
value* String
var String

<t:tree2>

Represents "tree data" in an HTML format. Also provides a mechanism for maintaining expand/collapse state of the nodes in the tree. A component that provides an HTML-based tree from data supplied by a backing bean. The tree is highly customizable and allows for fine-grained control over the appearance of each of the nodes depending on their type. Almost any type of JSF component (text, image, checkbox, etc.) can be rendered inside the nodes and there is an option for client-side or server-side toggling of the expand/collapse state. 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
clientSideToggle Perform client-side toggling of expand/collapse state via javascript (default is 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
imageLocation An alternate location to find image resources. If no values is specified, images will be loaded from the resources directory using AddResource and ExtensionsFilter. String
javascriptLocation An alternate location to find javascript resources. If no values is specified, javascript will be loaded from the resources directory using AddResource and ExtensionsFilter. String
preserveToggle Preserve changes in client-side toggle information between requests (default is true.) String
rendered A boolean value that indicates whether this component should be rendered. Default value: true. String
showLines Show the connecting lines (default is true.) String
showNav Show the "plus" and "minus" navigation icons (default is true.) Value is ignored if clientSideToggle is true. String
showRootNode Include the root node when rendering the tree (default is true.) String
styleLocation An alternate location to find stylesheet resources. If no values is specified, stylesheets will be loaded from the resources directory using AddResource and ExtensionsFilter. String
value* Gets the value of the TreeData. String
var Return the request-scope attribute under which the data object for the current node will be exposed when iterating. This property is not enabled for value binding expressions. String
varNodeToggler Gets String

<t:treeCheckbox>

Renders a HTML input of type "treeCheckbox". The associated comes from the treeCheckbox itemLabel and itemValue. The selected items come from an extended selectManyCheckbox component with layout "spread". The selectManyCheckbox is referenced by the "for" attribute. All HTML pass-through attributes for this input are taken from the associated selectManyCheckbox. Unless otherwise specified, all attributes accept static values or EL expressions.

Can contain: empty

Attributes

Name Description Type
binding Identifies a backing bean property (of type UIComponent or appropriate subclass) to bind to this component instance. This value must be an EL expression. String
escape The escape setting for the label of this selection item. String
for id of the referenced extended selectManyCheckbox component 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

<t:treeColumn>

Renders a HTML input of type "treeColumn". <p> This tag outlines the column where the tree structure will be render as part of the tree table. Unless otherwise specified, all attributes accept static values or EL expressions. </p> <p> Tree column model. This column is used to provide the place holder for the tree. This is used in conjunction with the table format display. </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

<t:treeSelectionListener>

Tag to add a tree selection listeners to a {@link HtmlTree}

Can contain: empty

Attributes

Name Description Type
type* String

<t:updateActionListener>

Registers an org.apache.myfaces.custom.updateactionlistener.UpdateActionListener at the parent component (which must be an ActionSource). When the parent's action fires the specified value is evaluated, then written into the specified property. Unless otherwise specified, all attributes accept static values or EL expressions. JSF 1.2 introduces a "setPropertyActionListener" with the same functionality like this.

Can contain: JSP

Attributes

Name Description Type
converter String
property* String
value* String

<t:validateCreditCard>

A custom validator for creditCards, based upon Jakarta Commons. Unless otherwise specified, all attributes accept static values or EL expressions

Can contain: empty

Attributes

Name Description Type
amex american express cards String
detailMessage String
discover validation for discover String
mastercard validation for mastercard String
message String
none none of the given cardtypes is allowed. String
summaryMessage String
visa validation for visa String

<t:validateEmail>

A custom validator for email address format, based upons Jakarta Commons. Unless otherwise specified, all attributes accept static values or EL expressions.

Can contain: empty

Attributes

Name Description Type
detailMessage String
message String
summaryMessage String

<t:validateEqual>

A custom validator for validations against foreign component values. Unless otherwise specified, all attributes accept static values or EL expressions.

Can contain: empty

Attributes

Name Description Type
detailMessage String
for the id of the foreign component, which is needed for the validation String
message String
summaryMessage String

<t:validateRegExpr>

A custom validator for reg. expr., based upons Jakarta Commons. Unless otherwise specified, all attributes accept static values or EL expressions.

Can contain: empty

Attributes

Name Description Type
detailMessage String
message String
pattern the pattern, which is the base of the validation String
summaryMessage String

<t:xmlTransform>

Transforms XML using and XSL stylesheet. Used to transform XML (from either a String or URL) using either XSLT or Velocity.

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
content String containing the XML content to be transformed. String
contentLocation String containing the location of the XML content to be transformed. String
contentStream Value binding expression referencing an InputStream from which the XML content is to be read. 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
styleStream Value binding expression referencing an InputStream from which the XSL stylesheet is to be read. String
stylesheet String containing the XSL information to use in the transformation. String
stylesheetLocation String containing the location of the XSL stylesheet to use in the transformation. String