Tag reference sheet
Tag library reference for the following tag libraries:
- Tomahawk tag library. (tomahawk.tld) - uri:http://myfaces.apache.org/tomahawk
Tomahawk tag library. - version 1.0
MyFaces subproject that contains components and other goodies to be used with any JSF implementation.
Namespace definition: xmlns:t="http://myfaces.apache.org/tomahawk"
Tags
- 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 Adds a tab-change-listener to the enclosing t:panelTabbedPane component
- 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 | An identifier for this particular component instance within a component view. <p> The id must be unique within the scope of the tag's enclosing NamingContainer (eg h:form or f:subview). The id is not necessarily unique across all components in the current view </p> <p> This value must be a static value, ie not change over the lifetime of a component. It cannot be defined via an EL expression; only a string is permitted. </p> | 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 | An identifier for this particular component instance within a component view. <p> The id must be unique within the scope of the tag's enclosing NamingContainer (eg h:form or f:subview). The id is not necessarily unique across all components in the current view </p> <p> This value must be a static value, ie not change over the lifetime of a component. It cannot be defined via an EL expression; only a string is permitted. </p> | 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
<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 | An identifier for this particular component instance within a component view. <p> The id must be unique within the scope of the tag's enclosing NamingContainer (eg h:form or f:subview). The id is not necessarily unique across all components in the current view </p> <p> This value must be a static value, ie not change over the lifetime of a component. It cannot be defined via an EL expression; only a string is permitted. </p> | 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 | An identifier for this particular component instance within a component view. <p> The id must be unique within the scope of the tag's enclosing NamingContainer (eg h:form or f:subview). The id is not necessarily unique across all components in the current view </p> <p> This value must be a static value, ie not change over the lifetime of a component. It cannot be defined via an EL expression; only a string is permitted. </p> | 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 |
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 | An identifier for this particular component instance within a component view. <p> The id must be unique within the scope of the tag's enclosing NamingContainer (eg h:form or f:subview). The id is not necessarily unique across all components in the current view </p> <p> This value must be a static value, ie not change over the lifetime of a component. It cannot be defined via an EL expression; only a string is permitted. </p> | String |
indicatorStyle | HTML: CSS styling instructions for the generated indicator. This attribute is ignored if a custom "header" facet is provided for the collapsible panel | String |
indicatorStyleClass | The CSS class for this element. Corresponds to the HTML 'class' attribute for the generated indicator span. This attribute is ignored if a custom "header" facet is provided for the collapsible panel | 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 |
titleStyle | HTML: CSS styling instructions for the generated title. This attribute is ignored if a custom "header" facet is provided for the collapsible panel | String |
titleStyleClass | The CSS class for this element. Corresponds to the HTML 'class' attribute for the generated title. This attribute is ignored if a custom "header" facet is provided for the collapsible panel | 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 |
value | The initial value of this component. This value is generally set as a value-binding in the form #{myBean.myProperty}, where myProperty can be any data-type of Java (also user-defined data-types), if a converter for this data-type exists. Special cases: 1) f:selectItems - value needs to bind to a list (or an array) of javax.faces.model.SelectItem-instances 2) components implementing UISelectMany (e.g. h:selectManyCheckbox) - value needs to bind to a list (or an array) of values, where the values need to be of the same data-type as the choices of the associated f:selectItems-component 3) components implementing UIData (e.g. h:dataTable) - value needs to bind to a list (or an array) of values, which will be iterated over when the data-table is processed | String |
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 | An identifier for this particular component instance within a component view. <p> The id must be unique within the scope of the tag's enclosing NamingContainer (eg h:form or f:subview). The id is not necessarily unique across all components in the current view </p> <p> This value must be a static value, ie not change over the lifetime of a component. It cannot be defined via an EL expression; only a string is permitted. </p> | 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 | The index of the first row to be displayed, where 0 is the first row. | 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 | An identifier for this particular component instance within a component view. <p> The id must be unique within the scope of the tag's enclosing NamingContainer (eg h:form or f:subview). The id is not necessarily unique across all components in the current view </p> <p> This value must be a static value, ie not change over the lifetime of a component. It cannot be defined via an EL expression; only a string is permitted. </p> | 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 | The number of rows to be displayed. Specify zero for all remaining rows in the table. | 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. The value can be of any type. A value of type DataModel is used directly. Array-like parameters of type java.util.List, array of Object, java.sql.ResultSet, or javax.servlet.jsp.jstl.sql.Result are wrapped in a DataModel. Other values are wrapped in a DataModel as a single row. | String |
var* | Defines the name of the request-scope variable that will hold the current row during iteration. This value must be a static value. | String |
width | 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 | 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 |
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 | A method binding EL expression that identifies an action listener method to be invoked if this component is activated by the user. An action listener method accepts a parameter of type javax.faces.event.ActionEvent and returns void. The phase that this event is fired in can be controlled via the immediate attribute. | String |
alt | HTML: Specifies alternative text that can be used by a browser that can't show this element. | String |
binding | Identifies a backing bean property (of type UIComponent or appropriate subclass) to bind to this component instance. This value must be an EL expression. | String |
dir | HTML: The direction of text display, either 'ltr' (left-to-right) or 'rtl' (right-to-left). | String |
disabled | HTML: When true, this element cannot receive focus. | String |
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 | An identifier for this particular component instance within a component view. <p> The id must be unique within the scope of the tag's enclosing NamingContainer (eg h:form or f:subview). The id is not necessarily unique across all components in the current view </p> <p> This value must be a static value, ie not change over the lifetime of a component. It cannot be defined via an EL expression; only a string is permitted. </p> | String |
image | HTML: The URL of an image that renders in place of the button. | String |
immediate | A boolean value that identifies the phase during which action events should fire. During normal event processing, action methods and action listener methods are fired during the "invoke application" phase of request processing. If this attribute is set to "true", these methods are fired instead at the end of the "apply request values" phase. | String |
lang | HTML: The base language of this document. | String |
onblur | HTML: Specifies a script to be invoked when the element loses focus. | String |
onchange | HTML: Specifies a script to be invoked when the element is modified. | String |
onclick | HTML: Script to be invoked when the element is clicked. | String |
ondblclick | HTML: Script to be invoked when the element is double-clicked. | String |
onfocus | HTML: Specifies a script to be invoked when the element receives focus. | String |
onkeydown | HTML: Script to be invoked when a key is pressed down over this element. | String |
onkeypress | HTML: Script to be invoked when a key is pressed over this element. | String |
onkeyup | HTML: Script to be invoked when a key is released over this element. | String |
onmousedown | HTML: Script to be invoked when the pointing device is pressed over this element. | String |
onmousemove | HTML: Script to be invoked when the pointing device is moved while it is in this element. | String |
onmouseout | HTML: Script to be invoked when the pointing device is moves out of this element. | String |
onmouseover | HTML: Script to be invoked when the pointing device is moved into this element. | String |
onmouseup | HTML: Script to be invoked when the pointing device is released over this element. | String |
onselect | HTML: Specifies a script to be invoked when the element is selected. | String |
readonly | HTML: When true, indicates that this component cannot be modified by the user. The element may receive focus unless it has also been disabled. | String |
rendered | A boolean value that indicates whether this component should be rendered. Default value: true. | String |
style | HTML: CSS styling instructions. | String |
styleClass | The CSS class for this element. Corresponds to the HTML 'class' attribute. | String |
tabindex | HTML: Specifies the position of this element within the tab order of the document. | String |
title | HTML: An advisory title for this element. Often used by the user agent as a tooltip. | String |
type | HTML: A hint to the user agent about the content type of the linked resource. | String |
value | The initial value of this component. | String |
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 | 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 |
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 | A method binding EL expression that identifies an action listener method to be invoked if this component is activated by the user. An action listener method accepts a parameter of type javax.faces.event.ActionEvent and returns void. The phase that this event is fired in can be controlled via the immediate attribute. | String |
binding | Identifies a backing bean property (of type UIComponent or appropriate subclass) to bind to this component instance. This value must be an EL expression. | String |
charset | HTML: Specifies the character encoding of the linked resource. | String |
coords | HTML: The coordinates of regions within a client side image map. | String |
dir | HTML: The direction of text display, either 'ltr' (left-to-right) or 'rtl' (right-to-left). | String |
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 | An identifier for this particular component instance within a component view. <p> The id must be unique within the scope of the tag's enclosing NamingContainer (eg h:form or f:subview). The id is not necessarily unique across all components in the current view </p> <p> This value must be a static value, ie not change over the lifetime of a component. It cannot be defined via an EL expression; only a string is permitted. </p> | String |
immediate | A boolean value that identifies the phase during which action events should fire. During normal event processing, action methods and action listener methods are fired during the "invoke application" phase of request processing. If this attribute is set to "true", these methods are fired instead at the end of the "apply request values" phase. | String |
lang | HTML: The base language of this document. | String |
onblur | HTML: Specifies a script to be invoked when the element loses focus. | String |
onclick | HTML: Script to be invoked when the element is clicked. | String |
ondblclick | HTML: Script to be invoked when the element is double-clicked. | String |
onfocus | HTML: Specifies a script to be invoked when the element receives focus. | String |
onkeydown | HTML: Script to be invoked when a key is pressed down over this element. | String |
onkeypress | HTML: Script to be invoked when a key is pressed over this element. | String |
onkeyup | HTML: Script to be invoked when a key is released over this element. | String |
onmousedown | HTML: Script to be invoked when the pointing device is pressed over this element. | String |
onmousemove | HTML: Script to be invoked when the pointing device is moved while it is in this element. | String |
onmouseout | HTML: Script to be invoked when the pointing device is moves out of this element. | String |
onmouseover | HTML: Script to be invoked when the pointing device is moved into this element. | String |
onmouseup | HTML: Script to be invoked when the pointing device is released over this element. | String |
rel | HTML: The relationship between the current document and the linked resource. | String |
rendered | A boolean value that indicates whether this component should be rendered. Default value: true. | String |
rev | HTML: The type(s) describing the reverse link for the linked resource. | String |
shape | HTML: The shape of a region in a client side image map. | String |
style | HTML: CSS styling instructions. | String |
styleClass | The CSS class for this element. Corresponds to the HTML 'class' attribute. | String |
tabindex | HTML: Specifies the position of this element within the tab order of the document. | String |
target | HTML: Names the frame that should display content generated by invoking this action. | String |
title | HTML: An advisory title for this element. Often used by the user agent as a tooltip. | String |
type | HTML: A hint to the user agent about the content type of the linked resource. | String |
value | The initial value of this component. | String |
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 | 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 |
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 | A method binding EL expression that identifies an action listener method to be invoked if this component is activated by the user. An action listener method accepts a parameter of type javax.faces.event.ActionEvent and returns void. The phase that this event is fired in can be controlled via the immediate attribute. | String |
binding | Identifies a backing bean property (of type UIComponent or appropriate subclass) to bind to this component instance. This value must be an EL expression. | String |
charset | HTML: Specifies the character encoding of the linked resource. | String |
coords | HTML: The coordinates of regions within a client side image map. | String |
dir | HTML: The direction of text display, either 'ltr' (left-to-right) or 'rtl' (right-to-left). | String |
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 | An identifier for this particular component instance within a component view. <p> The id must be unique within the scope of the tag's enclosing NamingContainer (eg h:form or f:subview). The id is not necessarily unique across all components in the current view </p> <p> This value must be a static value, ie not change over the lifetime of a component. It cannot be defined via an EL expression; only a string is permitted. </p> | String |
immediate | A boolean value that identifies the phase during which action events should fire. During normal event processing, action methods and action listener methods are fired during the "invoke application" phase of request processing. If this attribute is set to "true", these methods are fired instead at the end of the "apply request values" phase. | String |
lang | HTML: The base language of this document. | String |
onblur | HTML: Specifies a script to be invoked when the element loses focus. | String |
onclick | HTML: Script to be invoked when the element is clicked. | String |
ondblclick | HTML: Script to be invoked when the element is double-clicked. | String |
onfocus | HTML: Specifies a script to be invoked when the element receives focus. | String |
onkeydown | HTML: Script to be invoked when a key is pressed down over this element. | String |
onkeypress | HTML: Script to be invoked when a key is pressed over this element. | String |
onkeyup | HTML: Script to be invoked when a key is released over this element. | String |
onmousedown | HTML: Script to be invoked when the pointing device is pressed over this element. | String |
onmousemove | HTML: Script to be invoked when the pointing device is moved while it is in this element. | String |
onmouseout | HTML: Script to be invoked when the pointing device is moves out of this element. | String |
onmouseover | HTML: Script to be invoked when the pointing device is moved into this element. | String |
onmouseup | HTML: Script to be invoked when the pointing device is released over this element. | String |
rel | HTML: The relationship between the current document and the linked resource. | String |
rendered | A boolean value that indicates whether this component should be rendered. Default value: true. | String |
rev | HTML: The type(s) describing the reverse link for the linked resource. | String |
shape | HTML: The shape of a region in a client side image map. | String |
style | HTML: CSS styling instructions. | String |
styleClass | The CSS class for this element. Corresponds to the HTML 'class' attribute. | String |
tabindex | HTML: Specifies the position of this element within the tab order of the document. | String |
target | HTML: Names the frame that should display content generated by invoking this action. | String |
title | HTML: An advisory title for this element. Often used by the user agent as a tooltip. | String |
type | HTML: A hint to the user agent about the content type of the linked resource. | String |
value | The initial value of this component. | String |
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 | 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 |
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 | 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 |
active | Menu node is active. | String |
activeOnViewIds | A comma 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 | An identifier for this particular component instance within a component view. <p> The id must be unique within the scope of the tag's enclosing NamingContainer (eg h:form or f:subview). The id is not necessarily unique across all components in the current view </p> <p> This value must be a static value, ie not change over the lifetime of a component. It cannot be defined via an EL expression; only a string is permitted. </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 |
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 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: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 | 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 |
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 | 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 |
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 | An identifier for this particular component instance within a component view. <p> The id must be unique within the scope of the tag's enclosing NamingContainer (eg h:form or f:subview). The id is not necessarily unique across all components in the current view </p> <p> This value must be a static value, ie not change over the lifetime of a component. It cannot be defined via an EL expression; only a string is permitted. </p> | String |
immediate | A boolean value that identifies the phase during which action events should fire. During normal event processing, action methods and action listener methods are fired during the "invoke application" phase of request processing. If this attribute is set to "true", these methods are fired instead at the end of the "apply request values" phase. | String |
lang | HTML: The base language of this document. | String |
onblur | HTML: Specifies a script to be invoked when the element loses focus. | String |
onclick | HTML: Script to be invoked when the element is clicked. | String |
ondblclick | HTML: Script to be invoked when the element is double-clicked. | String |
onfocus | HTML: Specifies a script to be invoked when the element receives focus. | String |
onkeydown | HTML: Script to be invoked when a key is pressed down over this element. | String |
onkeypress | HTML: Script to be invoked when a key is pressed over this element. | String |
onkeyup | HTML: Script to be invoked when a key is released over this element. | String |
onmousedown | HTML: Script to be invoked when the pointing device is pressed over this element. | String |
onmousemove | HTML: Script to be invoked when the pointing device is moved while it is in this element. | String |
onmouseout | HTML: Script to be invoked when the pointing device is moves out of this element. | String |
onmouseover | HTML: Script to be invoked when the pointing device is moved into this element. | String |
onmouseup | HTML: Script to be invoked when the pointing device is released over this element. | String |
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 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: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 |
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 |
derivedRowKeyPrefix | This attribute is used to append an unique prefix when rowKey is not used, to prevent a key match a existing component id (note two different components can't have the same unique id). | 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 | 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 |
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 | An identifier for this particular component instance within a component view. <p> The id must be unique within the scope of the tag's enclosing NamingContainer (eg h:form or f:subview). The id is not necessarily unique across all components in the current view </p> <p> This value must be a static value, ie not change over the lifetime of a component. It cannot be defined via an EL expression; only a string is permitted. </p> | String |
itemOnClick | OnClick handler to be applied to individual items in the list | 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 |
rowKey | Used to assign a value expression that identify in a unique way a row. This value will be used later instead of rowIndex as a key to be appended to the container client id using getDerivedSubClientId() method. | String |
rows | The number of rows to be displayed. Specify zero for all remaining rows in the table. | String |
rules | HTML: Controls how rules are rendered between cells. Values include: none, groups, rows, cols, and all. | String |
style | HTML: CSS styling instructions. | String |
styleClass | The CSS class for this element. Corresponds to the HTML 'class' attribute. | String |
summary | HTML: Provides a summary of the contents of the table, for accessibility purposes. | String |
title | HTML: An advisory title for this element. Often used by the user agent as a tooltip. | String |
value | An EL expression that specifies the data model that backs this table. The value can be of any type. A value of type DataModel is used directly. Array-like parameters of type java.util.List, array of Object, java.sql.ResultSet, or javax.servlet.jsp.jstl.sql.Result are wrapped in a DataModel. Other values are wrapped in a DataModel as a single row. | String |
var* | Defines the name of the request-scope variable that will hold the current row during iteration. This value must be a static value. | String |
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 |
disableFacetLinksIfFirstPage | If the dataScroller is on the first page (index is at 1), links for first, prev and fastprev are disabled. Default is false. | String |
disableFacetLinksIfLastPage | If the dataScroller is on the last page (index is at pagecount), links for last, next and fastnext are disabled. Default is false. | 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 | An identifier for this particular component instance within a component view. <p> The id must be unique within the scope of the tag's enclosing NamingContainer (eg h:form or f:subview). The id is not necessarily unique across all components in the current view </p> <p> This value must be a static value, ie not change over the lifetime of a component. It cannot be defined via an EL expression; only a string is permitted. </p> | 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 |
renderFacetLinksIfFirstPage | If the dataScroller is on the first page (index is at 1), links for first, prev and fastprev are rendered. Default is true. | String |
renderFacetLinksIfLastPage | If the dataScroller is on the last page (index is at pagecount), links for last, next and fastnext are rendered. Default is true. | 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 |
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 |
derivedRowKeyPrefix | This attribute is used to append an unique prefix when rowKey is not used, to prevent a key match a existing component id (note two different components can't have the same unique id). | 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 | An identifier for this particular component instance within a component view. <p> The id must be unique within the scope of the tag's enclosing NamingContainer (eg h:form or f:subview). The id is not necessarily unique across all components in the current view </p> <p> This value must be a static value, ie not change over the lifetime of a component. It cannot be defined via an EL expression; only a string is permitted. </p> | 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 |
rowKey | Used to assign a value expression that identify in a unique way a row. This value will be used later instead of rowIndex as a key to be appended to the container client id using getDerivedSubClientId() method. | 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. The value can be of any type. A value of type DataModel is used directly. Array-like parameters of type java.util.List, array of Object, java.sql.ResultSet, or javax.servlet.jsp.jstl.sql.Result are wrapped in a DataModel. Other values are wrapped in a DataModel as a single row. | String |
valueType | Indicate the expected type of the EL expression pointed by value property. It is useful when vb.getType() cannot found the type, like when a map value is resolved on the expression. | String |
var* | Defines the name of the request-scope variable that will hold the current row during iteration. This value must be a static value. | String |
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 | An identifier for this particular component instance within a component view. <p> The id must be unique within the scope of the tag's enclosing NamingContainer (eg h:form or f:subview). The id is not necessarily unique across all components in the current view </p> <p> This value must be a static value, ie not change over the lifetime of a component. It cannot be defined via an EL expression; only a string is permitted. </p> | 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 | An identifier for this particular component instance within a component view. <p> The id must be unique within the scope of the tag's enclosing NamingContainer (eg h:form or f:subview). The id is not necessarily unique across all components in the current view </p> <p> This value must be a static value, ie not change over the lifetime of a component. It cannot be defined via an EL expression; only a string is permitted. </p> | 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 | An identifier for this particular component instance within a component view. <p> The id must be unique within the scope of the tag's enclosing NamingContainer (eg h:form or f:subview). The id is not necessarily unique across all components in the current view </p> <p> This value must be a static value, ie not change over the lifetime of a component. It cannot be defined via an EL expression; only a string is permitted. </p> | 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 | An identifier for this particular component instance within a component view. <p> The id must be unique within the scope of the tag's enclosing NamingContainer (eg h:form or f:subview). The id is not necessarily unique across all components in the current view </p> <p> This value must be a static value, ie not change over the lifetime of a component. It cannot be defined via an EL expression; only a string is permitted. </p> | 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 | An identifier for this particular component instance within a component view. <p> The id must be unique within the scope of the tag's enclosing NamingContainer (eg h:form or f:subview). The id is not necessarily unique across all components in the current view </p> <p> This value must be a static value, ie not change over the lifetime of a component. It cannot be defined via an EL expression; only a string is permitted. </p> | 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 | An identifier for this particular component instance within a component view. <p> The id must be unique within the scope of the tag's enclosing NamingContainer (eg h:form or f:subview). The id is not necessarily unique across all components in the current view </p> <p> This value must be a static value, ie not change over the lifetime of a component. It cannot be defined via an EL expression; only a string is permitted. </p> | 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 | An identifier for this particular component instance within a component view. <p> The id must be unique within the scope of the tag's enclosing NamingContainer (eg h:form or f:subview). The id is not necessarily unique across all components in the current view </p> <p> This value must be a static value, ie not change over the lifetime of a component. It cannot be defined via an EL expression; only a string is permitted. </p> | String |
ismap | HTML: Specifies server-side image map handling for this image. | String |
lang | HTML: The base language of this document. | String |
longdesc | HTML: A link to a long description of the image. | String |
onclick | HTML: Script to be invoked when the element is clicked. | String |
ondblclick | HTML: Script to be invoked when the element is double-clicked. | String |
onkeydown | HTML: Script to be invoked when a key is pressed down over this element. | String |
onkeypress | HTML: Script to be invoked when a key is pressed over this element. | String |
onkeyup | HTML: Script to be invoked when a key is released over this element. | String |
onmousedown | HTML: Script to be invoked when the pointing device is pressed over this element. | String |
onmousemove | HTML: Script to be invoked when the pointing device is moved while it is in this element. | String |
onmouseout | HTML: Script to be invoked when the pointing device is moves out of this element. | String |
onmouseover | HTML: Script to be invoked when the pointing device is moved into this element. | String |
onmouseup | HTML: Script to be invoked when the pointing device is released over this element. | String |
rendered | A boolean value that indicates whether this component should be rendered. Default value: true. | String |
style | HTML: CSS styling instructions. | String |
styleClass | The CSS class for this element. Corresponds to the HTML 'class' attribute. | String |
title | HTML: An advisory title for this element. Often used by the user agent as a tooltip. | String |
url | An alias for the "value" attribute. | String |
usemap | HTML: Specifies an image map to use with this image. | String |
value | The URL of the image. If the URL starts with a '/', it is relative to the context path of the web application. | String |
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 | 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 |
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 | A method binding EL expression that identifies an action listener method to be invoked if this component is activated by the user. An action listener method accepts a parameter of type javax.faces.event.ActionEvent and returns void. The phase that this event is fired in can be controlled via the immediate attribute. | String |
binding | Identifies a backing bean property (of type UIComponent or appropriate subclass) to bind to this component instance. This value must be an EL expression. | String |
charset | HTML: Specifies the character encoding of the linked resource. | String |
coords | HTML: The coordinates of regions within a client side image map. | String |
dir | HTML: The direction of text display, either 'ltr' (left-to-right) or 'rtl' (right-to-left). | String |
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 | An identifier for this particular component instance within a component view. <p> The id must be unique within the scope of the tag's enclosing NamingContainer (eg h:form or f:subview). The id is not necessarily unique across all components in the current view </p> <p> This value must be a static value, ie not change over the lifetime of a component. It cannot be defined via an EL expression; only a string is permitted. </p> | String |
immediate | A boolean value that identifies the phase during which action events should fire. During normal event processing, action methods and action listener methods are fired during the "invoke application" phase of request processing. If this attribute is set to "true", these methods are fired instead at the end of the "apply request values" phase. | String |
lang | HTML: The base language of this document. | String |
onblur | HTML: Specifies a script to be invoked when the element loses focus. | String |
onclick | HTML: Script to be invoked when the element is clicked. | String |
ondblclick | HTML: Script to be invoked when the element is double-clicked. | String |
onfocus | HTML: Specifies a script to be invoked when the element receives focus. | String |
onkeydown | HTML: Script to be invoked when a key is pressed down over this element. | String |
onkeypress | HTML: Script to be invoked when a key is pressed over this element. | String |
onkeyup | HTML: Script to be invoked when a key is released over this element. | String |
onmousedown | HTML: Script to be invoked when the pointing device is pressed over this element. | String |
onmousemove | HTML: Script to be invoked when the pointing device is moved while it is in this element. | String |
onmouseout | HTML: Script to be invoked when the pointing device is moves out of this element. | String |
onmouseover | HTML: Script to be invoked when the pointing device is moved into this element. | String |
onmouseup | HTML: Script to be invoked when the pointing device is released over this element. | String |
rel | HTML: The relationship between the current document and the linked resource. | String |
rendered | A boolean value that indicates whether this component should be rendered. Default value: true. | String |
rev | HTML: The type(s) describing the reverse link for the linked resource. | String |
shape | HTML: The shape of a region in a client side image map. | String |
style | HTML: CSS styling instructions. | String |
styleClass | The CSS class for this element. Corresponds to the HTML 'class' attribute. | String |
tabindex | HTML: Specifies the position of this element within the tab order of the document. | String |
target | HTML: Names the frame that should display content generated by invoking this action. | String |
title | HTML: An advisory title for this element. Often used by the user agent as a tooltip. | String |
type | HTML: A hint to the user agent about the content type of the linked resource. | String |
value | The initial value of this component. | String |
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. 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. There is currently no facility for adding attributes to the generated html tag other than those explicitly supported by the attributes on this JSF 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 |
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 | An identifier for this particular component instance within a component view. <p> The id must be unique within the scope of the tag's enclosing NamingContainer (eg h:form or f:subview). The id is not necessarily unique across all components in the current view </p> <p> This value must be a static value, ie not change over the lifetime of a component. It cannot be defined via an EL expression; only a string is permitted. </p> | 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 | The initial value of this component. This value is generally set as a value-binding in the form #{myBean.myProperty}, where myProperty can be any data-type of Java (also user-defined data-types), if a converter for this data-type exists. Special cases: 1) f:selectItems - value needs to bind to a list (or an array) of javax.faces.model.SelectItem-instances 2) components implementing UISelectMany (e.g. h:selectManyCheckbox) - value needs to bind to a list (or an array) of values, where the values need to be of the same data-type as the choices of the associated f:selectItems-component 3) components implementing UIData (e.g. h:dataTable) - value needs to bind to a list (or an array) of values, which will be iterated over when the data-table is processed | String |
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: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 | The value can either be a static value (ID) or an EL expression. When a static id is specified, an instance of the converter type registered with that id is used. When this is an EL expression, the result of evaluating the expression must be an object that implements the Converter interface. | String |
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 |
dateBusinessConverter | Indicate an object used as a bridge between the java.util.Date instance used by this component internally and the value object used on the bean, referred as a "business" value. <ul> <li>If the value is literal, look for the mentioned class instance, create a new instance and assign to the component property.</li> <li>If it the value a EL Expression, set the expression to the component property.</li> </ul> | 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 | An identifier for this particular component instance within a component view. <p> The id must be unique within the scope of the tag's enclosing NamingContainer (eg h:form or f:subview). The id is not necessarily unique across all components in the current view </p> <p> This value must be a static value, ie not change over the lifetime of a component. It cannot be defined via an EL expression; only a string is permitted. </p> | 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 value change events should fire. During normal event processing, value change events are fired during the "process validations" phase of request processing. If this attribute is set to "true", these methods are fired instead at the end of the "apply request values" phase. | String |
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 |
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. If this value is true, and no input value is provided, the error message javax.faces.component.UIInput.REQUIRED is posted. | String |
size | HTML: The initial width of this control, in characters. | String |
style | HTML: CSS styling instructions. | String |
styleClass | The CSS class for this element. Corresponds to the HTML 'class' attribute. | String |
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, accepting FacesContext, UIComponent, and Object parameters, and returning void, that validates the component's local value. | String |
value | The initial value of this component. This value is generally set as a value-binding in the form #{myBean.myProperty}, where myProperty can be any data-type of Java (also user-defined data-types), if a converter for this data-type exists. Special cases: 1) f:selectItems - value needs to bind to a list (or an array) of javax.faces.model.SelectItem-instances 2) components implementing UISelectMany (e.g. h:selectManyCheckbox) - value needs to bind to a list (or an array) of values, where the values need to be of the same data-type as the choices of the associated f:selectItems-component 3) components implementing UIData (e.g. h:dataTable) - value needs to bind to a list (or an array) of values, which will be iterated over when the data-table is processed | String |
valueChangeListener | A method binding EL expression, accepting a ValueChangeEvent parameter and returning void. The specified method is invoked if this component is modified. The phase that this handler is fired in can be controlled via the immediate attribute. | String |
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 |
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 |
dateBusinessConverter | Indicate an object used as a bridge between the java.util.Date instance used by this component internally and the value object used on the bean, referred as a "business" value. <ul> <li>If the value is literal, look for the mentioned class instance, create a new instance and assign to the component property.</li> <li>If it the value a EL Expression, set the expression to the component property.</li> </ul> | 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 | An identifier for this particular component instance within a component view. <p> The id must be unique within the scope of the tag's enclosing NamingContainer (eg h:form or f:subview). The id is not necessarily unique across all components in the current view </p> <p> This value must be a static value, ie not change over the lifetime of a component. It cannot be defined via an EL expression; only a string is permitted. </p> | String |
immediate | A boolean value that identifies the phase during which value change events should fire. During normal event processing, value change events are fired during the "process validations" phase of request processing. If this attribute is set to "true", these methods are fired instead at the end of the "apply request values" phase. | String |
lang | HTML: The base language of this document. | String |
maxlength | HTML: The maximum number of characters allowed to be entered. | String |
onblur | HTML: Specifies a script to be invoked when the element loses focus. | String |
onchange | HTML: Specifies a script to be invoked when the element is modified. | String |
onclick | HTML: Script to be invoked when the element is clicked. | String |
ondblclick | HTML: Script to be invoked when the element is double-clicked. | String |
onfocus | HTML: Specifies a script to be invoked when the element receives focus. | String |
onkeydown | HTML: Script to be invoked when a key is pressed down over this element. | String |
onkeypress | HTML: Script to be invoked when a key is pressed over this element. | String |
onkeyup | HTML: Script to be invoked when a key is released over this element. | String |
onmousedown | HTML: Script to be invoked when the pointing device is pressed over this element. | String |
onmousemove | HTML: Script to be invoked when the pointing device is moved while it is in this element. | String |
onmouseout | HTML: Script to be invoked when the pointing device is moves out of this element. | String |
onmouseover | HTML: Script to be invoked when the pointing device is moved into this element. | String |
onmouseup | HTML: Script to be invoked when the pointing device is released over this element. | String |
onselect | HTML: Specifies a script to be invoked when the element is selected. | String |
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. If this value is true, and no input value is provided, the error message javax.faces.component.UIInput.REQUIRED is posted. | String |
size | HTML: The initial width of this control, in characters. | String |
style | HTML: CSS styling instructions. | String |
styleClass | The CSS class for this element. Corresponds to the HTML 'class' attribute. | String |
tabindex | HTML: Specifies the position of this element within the tab order of the document. | String |
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, accepting FacesContext, UIComponent, and Object parameters, and returning void, that validates the component's local value. | String |
value | The initial value of this component. This value is generally set as a value-binding in the form #{myBean.myProperty}, where myProperty can be any data-type of Java (also user-defined data-types), if a converter for this data-type exists. Special cases: 1) f:selectItems - value needs to bind to a list (or an array) of javax.faces.model.SelectItem-instances 2) components implementing UISelectMany (e.g. h:selectManyCheckbox) - value needs to bind to a list (or an array) of values, where the values need to be of the same data-type as the choices of the associated f:selectItems-component 3) components implementing UIData (e.g. h:dataTable) - value needs to bind to a list (or an array) of values, which will be iterated over when the data-table is processed | String |
valueChangeListener | A method binding EL expression, accepting a ValueChangeEvent parameter and returning void. The specified method is invoked if this component is modified. The phase that this handler is fired in can be controlled via the immediate attribute. | String |
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 attribute specifies a comma-separated list of content types that a server processing this form will handle correctly. User agents may use this information to filter out non-conforming files when prompting a user to select files to be sent to the server (cf. the INPUT element when type="file")." | 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 |
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 | The value can either be a static value (ID) or an EL expression. When a static id is specified, an instance of the converter type registered with that id is used. When this is an EL expression, the result of evaluating the expression must be an object that implements the Converter interface. | String |
dir | 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 | An identifier for this particular component instance within a component view. <p> The id must be unique within the scope of the tag's enclosing NamingContainer (eg h:form or f:subview). The id is not necessarily unique across all components in the current view </p> <p> This value must be a static value, ie not change over the lifetime of a component. It cannot be defined via an EL expression; only a string is permitted. </p> | String |
immediate | A boolean value that identifies the phase during which value change events should fire. During normal event processing, value change events are fired during the "process validations" phase of request processing. If this attribute is set to "true", these methods are fired instead at the end of the "apply request values" phase. | String |
lang | HTML: The base language of this document. | String |
maxlength | HTML: The maximum number of characters allowed to be entered. | String |
onblur | HTML: Specifies a script to be invoked when the element loses focus. | String |
onchange | HTML: Specifies a script to be invoked when the element is modified. | String |
onclick | HTML: Script to be invoked when the element is clicked. | String |
ondblclick | HTML: Script to be invoked when the element is double-clicked. | String |
onfocus | HTML: Specifies a script to be invoked when the element receives focus. | String |
onkeydown | HTML: Script to be invoked when a key is pressed down over this element. | String |
onkeypress | HTML: Script to be invoked when a key is pressed over this element. | String |
onkeyup | HTML: Script to be invoked when a key is released over this element. | String |
onmousedown | HTML: Script to be invoked when the pointing device is pressed over this element. | String |
onmousemove | HTML: Script to be invoked when the pointing device is moved while it is in this element. | String |
onmouseout | HTML: Script to be invoked when the pointing device is moves out of this element. | String |
onmouseover | HTML: Script to be invoked when the pointing device is moved into this element. | String |
onmouseup | HTML: Script to be invoked when the pointing device is released over this element. | String |
onselect | HTML: Specifies a script to be invoked when the element is selected. | String |
readonly | HTML: When true, indicates that this component cannot be modified by the user. The element may receive focus unless it has also been disabled. | String |
rendered | A boolean value that indicates whether this component should be rendered. Default value: true. | String |
required | A boolean value that indicates whether an input value is required. If this value is true, and no input value is provided, the error message javax.faces.component.UIInput.REQUIRED is posted. | String |
size | HTML: The initial width of this control, in characters. | String |
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, accepting FacesContext, UIComponent, and Object parameters, and returning void, that validates the component's local value. | 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 binding EL expression, accepting a ValueChangeEvent parameter and returning void. The specified method is invoked if this component is modified. The phase that this handler is fired in can be controlled via the immediate attribute. | String |
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 | The value can either be a static value (ID) or an EL expression. When a static id is specified, an instance of the converter type registered with that id is used. When this is an EL expression, the result of evaluating the expression must be an object that implements the Converter interface. | String |
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 | An identifier for this particular component instance within a component view. <p> The id must be unique within the scope of the tag's enclosing NamingContainer (eg h:form or f:subview). The id is not necessarily unique across all components in the current view </p> <p> This value must be a static value, ie not change over the lifetime of a component. It cannot be defined via an EL expression; only a string is permitted. </p> | String |
immediate | A boolean value that identifies the phase during which value change events should fire. During normal event processing, value change events are fired during the "process validations" phase of request processing. If this attribute is set to "true", these methods are fired instead at the end of the "apply request values" phase. | String |
rendered | A boolean value that indicates whether this component should be rendered. Default value: true. | String |
required | A boolean value that indicates whether an input value is required. If this value is true, and no input value is provided, the error message javax.faces.component.UIInput.REQUIRED is posted. | String |
validator | A method binding EL expression, accepting FacesContext, UIComponent, and Object parameters, and returning void, that validates the component's local value. | String |
value | The initial value of this component. This value is generally set as a value-binding in the form #{myBean.myProperty}, where myProperty can be any data-type of Java (also user-defined data-types), if a converter for this data-type exists. Special cases: 1) f:selectItems - value needs to bind to a list (or an array) of javax.faces.model.SelectItem-instances 2) components implementing UISelectMany (e.g. h:selectManyCheckbox) - value needs to bind to a list (or an array) of values, where the values need to be of the same data-type as the choices of the associated f:selectItems-component 3) components implementing UIData (e.g. h:dataTable) - value needs to bind to a list (or an array) of values, which will be iterated over when the data-table is processed | String |
valueChangeListener | A method binding EL expression, accepting a ValueChangeEvent parameter and returning void. The specified method is invoked if this component is modified. The phase that this handler is fired in can be controlled via the immediate attribute. | String |
<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 | The value can either be a static value (ID) or an EL expression. When a static id is specified, an instance of the converter type registered with that id is used. When this is an EL expression, the result of evaluating the expression must be an object that implements the Converter interface. | String |
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 | An identifier for this particular component instance within a component view. <p> The id must be unique within the scope of the tag's enclosing NamingContainer (eg h:form or f:subview). The id is not necessarily unique across all components in the current view </p> <p> This value must be a static value, ie not change over the lifetime of a component. It cannot be defined via an EL expression; only a string is permitted. </p> | String |
immediate | A boolean value that identifies the phase during which value change events should fire. During normal event processing, value change events are fired during the "process validations" phase of request processing. If this attribute is set to "true", these methods are fired instead at the end of the "apply request values" phase. | String |
lang | HTML: The base language of this document. | String |
maxlength | HTML: The maximum number of characters allowed to be entered. | String |
onblur | HTML: Specifies a script to be invoked when the element loses focus. | String |
onchange | HTML: Specifies a script to be invoked when the element is modified. | String |
onclick | HTML: Script to be invoked when the element is clicked. | String |
ondblclick | HTML: Script to be invoked when the element is double-clicked. | String |
onfocus | HTML: Specifies a script to be invoked when the element receives focus. | String |
onkeydown | HTML: Script to be invoked when a key is pressed down over this element. | String |
onkeypress | HTML: Script to be invoked when a key is pressed over this element. | String |
onkeyup | HTML: Script to be invoked when a key is released over this element. | String |
onmousedown | HTML: Script to be invoked when the pointing device is pressed over this element. | String |
onmousemove | HTML: Script to be invoked when the pointing device is moved while it is in this element. | String |
onmouseout | HTML: Script to be invoked when the pointing device is moves out of this element. | String |
onmouseover | HTML: Script to be invoked when the pointing device is moved into this element. | String |
onmouseup | HTML: Script to be invoked when the pointing device is released over this element. | String |
onselect | HTML: Specifies a script to be invoked when the element is selected. | String |
readonly | HTML: When true, indicates that this component cannot be modified by the user. The element may receive focus unless it has also been disabled. | String |
rendered | A boolean value that indicates whether this component should be rendered. Default value: true. | String |
required | A boolean value that indicates whether an input value is required. If this value is true, and no input value is provided, the error message javax.faces.component.UIInput.REQUIRED is posted. | String |
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, accepting FacesContext, UIComponent, and Object parameters, and returning void, that validates the component's local value. | String |
value | The initial value of this component. This value is generally set as a value-binding in the form #{myBean.myProperty}, where myProperty can be any data-type of Java (also user-defined data-types), if a converter for this data-type exists. Special cases: 1) f:selectItems - value needs to bind to a list (or an array) of javax.faces.model.SelectItem-instances 2) components implementing UISelectMany (e.g. h:selectManyCheckbox) - value needs to bind to a list (or an array) of values, where the values need to be of the same data-type as the choices of the associated f:selectItems-component 3) components implementing UIData (e.g. h:dataTable) - value needs to bind to a list (or an array) of values, which will be iterated over when the data-table is processed | String |
valueChangeListener | A method binding EL expression, accepting a ValueChangeEvent parameter and returning void. The specified method is invoked if this component is modified. The phase that this handler is fired in can be controlled via the immediate attribute. | String |
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 |
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 | The value can either be a static value (ID) or an EL expression. When a static id is specified, an instance of the converter type registered with that id is used. When this is an EL expression, the result of evaluating the expression must be an object that implements the Converter interface. | String |
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 | An identifier for this particular component instance within a component view. <p> The id must be unique within the scope of the tag's enclosing NamingContainer (eg h:form or f:subview). The id is not necessarily unique across all components in the current view </p> <p> This value must be a static value, ie not change over the lifetime of a component. It cannot be defined via an EL expression; only a string is permitted. </p> | String |
immediate | A boolean value that identifies the phase during which value change events should fire. During normal event processing, value change events are fired during the "process validations" phase of request processing. If this attribute is set to "true", these methods are fired instead at the end of the "apply request values" phase. | String |
lang | HTML: The base language of this document. | String |
maxlength | HTML: The maximum number of characters allowed to be entered. | String |
onblur | HTML: Specifies a script to be invoked when the element loses focus. | String |
onchange | HTML: Specifies a script to be invoked when the element is modified. | String |
onclick | HTML: Script to be invoked when the element is clicked. | String |
ondblclick | HTML: Script to be invoked when the element is double-clicked. | String |
onfocus | HTML: Specifies a script to be invoked when the element receives focus. | String |
onkeydown | HTML: Script to be invoked when a key is pressed down over this element. | String |
onkeypress | HTML: Script to be invoked when a key is pressed over this element. | String |
onkeyup | HTML: Script to be invoked when a key is released over this element. | String |
onmousedown | HTML: Script to be invoked when the pointing device is pressed over this element. | String |
onmousemove | HTML: Script to be invoked when the pointing device is moved while it is in this element. | String |
onmouseout | HTML: Script to be invoked when the pointing device is moves out of this element. | String |
onmouseover | HTML: Script to be invoked when the pointing device is moved into this element. | String |
onmouseup | HTML: Script to be invoked when the pointing device is released over this element. | String |
onselect | HTML: Specifies a script to be invoked when the element is selected. | String |
readonly | HTML: When true, indicates that this component cannot be modified by the user. The element may receive focus unless it has also been disabled. | String |
redisplay | If true, the value will be re-sent (in plaintext) when the form is rerendered (see JSF.7.4.4). Default is false. | String |
rendered | A boolean value that indicates whether this component should be rendered. Default value: true. | String |
required | A boolean value that indicates whether an input value is required. If this value is true, and no input value is provided, the error message javax.faces.component.UIInput.REQUIRED is posted. | String |
size | HTML: The initial width of this control, in characters. | String |
style | HTML: CSS styling instructions. | String |
styleClass | The CSS class for this element. Corresponds to the HTML 'class' attribute. | String |
tabindex | HTML: Specifies the position of this element within the tab order of the document. | String |
title | HTML: An advisory title for this element. Often used by the user agent as a tooltip. | String |
validator | A method binding EL expression, accepting FacesContext, UIComponent, and Object parameters, and returning void, that validates the component's local value. | String |
value | The initial value of this component. This value is generally set as a value-binding in the form #{myBean.myProperty}, where myProperty can be any data-type of Java (also user-defined data-types), if a converter for this data-type exists. Special cases: 1) f:selectItems - value needs to bind to a list (or an array) of javax.faces.model.SelectItem-instances 2) components implementing UISelectMany (e.g. h:selectManyCheckbox) - value needs to bind to a list (or an array) of values, where the values need to be of the same data-type as the choices of the associated f:selectItems-component 3) components implementing UIData (e.g. h:dataTable) - value needs to bind to a list (or an array) of values, which will be iterated over when the data-table is processed | String |
valueChangeListener | A method binding EL expression, accepting a ValueChangeEvent parameter and returning void. The specified method is invoked if this component is modified. The phase that this handler is fired in can be controlled via the immediate attribute. | String |
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 | The value can either be a static value (ID) or an EL expression. When a static id is specified, an instance of the converter type registered with that id is used. When this is an EL expression, the result of evaluating the expression must be an object that implements the Converter interface. | String |
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 | An identifier for this particular component instance within a component view. <p> The id must be unique within the scope of the tag's enclosing NamingContainer (eg h:form or f:subview). The id is not necessarily unique across all components in the current view </p> <p> This value must be a static value, ie not change over the lifetime of a component. It cannot be defined via an EL expression; only a string is permitted. </p> | String |
immediate | A boolean value that identifies the phase during which value change events should fire. During normal event processing, value change events are fired during the "process validations" phase of request processing. If this attribute is set to "true", these methods are fired instead at the end of the "apply request values" phase. | String |
lang | HTML: The base language of this document. | String |
maxlength | HTML: The maximum number of characters allowed to be entered. | String |
onblur | HTML: Specifies a script to be invoked when the element loses focus. | String |
onchange | HTML: Specifies a script to be invoked when the element is modified. | String |
onclick | HTML: Script to be invoked when the element is clicked. | String |
ondblclick | HTML: Script to be invoked when the element is double-clicked. | String |
onfocus | HTML: Specifies a script to be invoked when the element receives focus. | String |
onkeydown | HTML: Script to be invoked when a key is pressed down over this element. | String |
onkeypress | HTML: Script to be invoked when a key is pressed over this element. | String |
onkeyup | HTML: Script to be invoked when a key is released over this element. | String |
onmousedown | HTML: Script to be invoked when the pointing device is pressed over this element. | String |
onmousemove | HTML: Script to be invoked when the pointing device is moved while it is in this element. | String |
onmouseout | HTML: Script to be invoked when the pointing device is moves out of this element. | String |
onmouseover | HTML: Script to be invoked when the pointing device is moved into this element. | String |
onmouseup | HTML: Script to be invoked when the pointing device is released over this element. | String |
onselect | HTML: Specifies a script to be invoked when the element is selected. | String |
readonly | HTML: When true, indicates that this component cannot be modified by the user. The element may receive focus unless it has also been disabled. | String |
rendered | A boolean value that indicates whether this component should be rendered. Default value: true. | String |
required | A boolean value that indicates whether an input value is required. If this value is true, and no input value is provided, the error message javax.faces.component.UIInput.REQUIRED is posted. | String |
size | HTML: The initial width of this control, in characters. | String |
style | HTML: CSS styling instructions. | String |
styleClass | The CSS class for this element. Corresponds to the HTML 'class' attribute. | String |
tabindex | HTML: Specifies the position of this element within the tab order of the document. | String |
title | HTML: An advisory title for this element. Often used by the user agent as a tooltip. | String |
validator | A method binding EL expression, accepting FacesContext, UIComponent, and Object parameters, and returning void, that validates the component's local value. | String |
value | The initial value of this component. This value is generally set as a value-binding in the form #{myBean.myProperty}, where myProperty can be any data-type of Java (also user-defined data-types), if a converter for this data-type exists. Special cases: 1) f:selectItems - value needs to bind to a list (or an array) of javax.faces.model.SelectItem-instances 2) components implementing UISelectMany (e.g. h:selectManyCheckbox) - value needs to bind to a list (or an array) of values, where the values need to be of the same data-type as the choices of the associated f:selectItems-component 3) components implementing UIData (e.g. h:dataTable) - value needs to bind to a list (or an array) of values, which will be iterated over when the data-table is processed | String |
valueChangeListener | A method binding EL expression, accepting a ValueChangeEvent parameter and returning void. The specified method is invoked if this component is modified. The phase that this handler is fired in can be controlled via the immediate attribute. | String |
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 | The value can either be a static value (ID) or an EL expression. When a static id is specified, an instance of the converter type registered with that id is used. When this is an EL expression, the result of evaluating the expression must be an object that implements the Converter interface. | String |
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 | An identifier for this particular component instance within a component view. <p> The id must be unique within the scope of the tag's enclosing NamingContainer (eg h:form or f:subview). The id is not necessarily unique across all components in the current view </p> <p> This value must be a static value, ie not change over the lifetime of a component. It cannot be defined via an EL expression; only a string is permitted. </p> | String |
immediate | A boolean value that identifies the phase during which value change events should fire. During normal event processing, value change events are fired during the "process validations" phase of request processing. If this attribute is set to "true", these methods are fired instead at the end of the "apply request values" phase. | String |
lang | HTML: The base language of this document. | String |
maxlength | HTML: The maximum number of characters allowed to be entered. | String |
onblur | HTML: Specifies a script to be invoked when the element loses focus. | String |
onchange | HTML: Specifies a script to be invoked when the element is modified. | String |
onclick | HTML: Script to be invoked when the element is clicked. | String |
ondblclick | HTML: Script to be invoked when the element is double-clicked. | String |
onfocus | HTML: Specifies a script to be invoked when the element receives focus. | String |
onkeydown | HTML: Script to be invoked when a key is pressed down over this element. | String |
onkeypress | HTML: Script to be invoked when a key is pressed over this element. | String |
onkeyup | HTML: Script to be invoked when a key is released over this element. | String |
onmousedown | HTML: Script to be invoked when the pointing device is pressed over this element. | String |
onmousemove | HTML: Script to be invoked when the pointing device is moved while it is in this element. | String |
onmouseout | HTML: Script to be invoked when the pointing device is moves out of this element. | String |
onmouseover | HTML: Script to be invoked when the pointing device is moved into this element. | String |
onmouseup | HTML: Script to be invoked when the pointing device is released over this element. | String |
onselect | HTML: Specifies a script to be invoked when the element is selected. | String |
readonly | HTML: When true, indicates that this component cannot be modified by the user. The element may receive focus unless it has also been disabled. | String |
rendered | A boolean value that indicates whether this component should be rendered. Default value: true. | String |
required | A boolean value that indicates whether an input value is required. If this value is true, and no input value is provided, the error message javax.faces.component.UIInput.REQUIRED is posted. | String |
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, accepting FacesContext, UIComponent, and Object parameters, and returning void, that validates the component's local value. | String |
value | The initial value of this component. This value is generally set as a value-binding in the form #{myBean.myProperty}, where myProperty can be any data-type of Java (also user-defined data-types), if a converter for this data-type exists. Special cases: 1) f:selectItems - value needs to bind to a list (or an array) of javax.faces.model.SelectItem-instances 2) components implementing UISelectMany (e.g. h:selectManyCheckbox) - value needs to bind to a list (or an array) of values, where the values need to be of the same data-type as the choices of the associated f:selectItems-component 3) components implementing UIData (e.g. h:dataTable) - value needs to bind to a list (or an array) of values, which will be iterated over when the data-table is processed | String |
valueChangeListener | A method binding EL expression, accepting a ValueChangeEvent parameter and returning void. The specified method is invoked if this component is modified. The phase that this handler is fired in can be controlled via the immediate attribute. | String |
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 | The value can either be a static value (ID) or an EL expression. When a static id is specified, an instance of the converter type registered with that id is used. When this is an EL expression, the result of evaluating the expression must be an object that implements the Converter interface. | String |
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 | An identifier for this particular component instance within a component view. <p> The id must be unique within the scope of the tag's enclosing NamingContainer (eg h:form or f:subview). The id is not necessarily unique across all components in the current view </p> <p> This value must be a static value, ie not change over the lifetime of a component. It cannot be defined via an EL expression; only a string is permitted. </p> | String |
immediate | A boolean value that identifies the phase during which value change events should fire. During normal event processing, value change events are fired during the "process validations" phase of request processing. If this attribute is set to "true", these methods are fired instead at the end of the "apply request values" phase. | String |
lang | HTML: The base language of this document. | String |
onblur | HTML: Specifies a script to be invoked when the element loses focus. | String |
onchange | HTML: Specifies a script to be invoked when the element is modified. | String |
onclick | HTML: Script to be invoked when the element is clicked. | String |
ondblclick | HTML: Script to be invoked when the element is double-clicked. | String |
onfocus | HTML: Specifies a script to be invoked when the element receives focus. | String |
onkeydown | HTML: Script to be invoked when a key is pressed down over this element. | String |
onkeypress | HTML: Script to be invoked when a key is pressed over this element. | String |
onkeyup | HTML: Script to be invoked when a key is released over this element. | String |
onmousedown | HTML: Script to be invoked when the pointing device is pressed over this element. | String |
onmousemove | HTML: Script to be invoked when the pointing device is moved while it is in this element. | String |
onmouseout | HTML: Script to be invoked when the pointing device is moves out of this element. | String |
onmouseover | HTML: Script to be invoked when the pointing device is moved into this element. | String |
onmouseup | HTML: Script to be invoked when the pointing device is released over this element. | String |
onselect | HTML: Specifies a script to be invoked when the element is selected. | String |
readonly | HTML: When true, indicates that this component cannot be modified by the user. The element may receive focus unless it has also been disabled. | String |
rendered | A boolean value that indicates whether this component should be rendered. Default value: true. | String |
required | A boolean value that indicates whether an input value is required. If this value is true, and no input value is provided, the error message javax.faces.component.UIInput.REQUIRED is posted. | String |
rows | HTML: The height of this element, in characters. | String |
style | HTML: CSS styling instructions. | String |
styleClass | The CSS class for this element. Corresponds to the HTML 'class' attribute. | String |
tabindex | HTML: Specifies the position of this element within the tab order of the document. | String |
title | HTML: An advisory title for this element. Often used by the user agent as a tooltip. | String |
validator | A method binding EL expression, accepting FacesContext, UIComponent, and Object parameters, and returning void, that validates the component's local value. | String |
value | The initial value of this component. This value is generally set as a value-binding in the form #{myBean.myProperty}, where myProperty can be any data-type of Java (also user-defined data-types), if a converter for this data-type exists. Special cases: 1) f:selectItems - value needs to bind to a list (or an array) of javax.faces.model.SelectItem-instances 2) components implementing UISelectMany (e.g. h:selectManyCheckbox) - value needs to bind to a list (or an array) of values, where the values need to be of the same data-type as the choices of the associated f:selectItems-component 3) components implementing UIData (e.g. h:dataTable) - value needs to bind to a list (or an array) of values, which will be iterated over when the data-table is processed | String |
valueChangeListener | A method binding EL expression, accepting a ValueChangeEvent parameter and returning void. The specified method is invoked if this component is modified. The phase that this handler is fired in can be controlled via the immediate attribute. | String |
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
<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 |
---|---|---|
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 | An identifier for this particular component instance within a component view. <p> The id must be unique within the scope of the tag's enclosing NamingContainer (eg h:form or f:subview). The id is not necessarily unique across all components in the current view </p> <p> This value must be a static value, ie not change over the lifetime of a component. It cannot be defined via an EL expression; only a string is permitted. </p> | 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. During normal event processing, action methods and action listener methods are fired during the "invoke application" phase of request processing. If this attribute is set to "true", these methods are fired instead at the end of the "apply request values" phase. | String |
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* | An EL expression, returning a String, with the unique ID of the component for which messages should be displayed. This string has the same format as that accepted by the UIComponent.findComponent() method. | String |
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 | An identifier for this particular component instance within a component view. <p> The id must be unique within the scope of the tag's enclosing NamingContainer (eg h:form or f:subview). The id is not necessarily unique across all components in the current view </p> <p> This value must be a static value, ie not change over the lifetime of a component. It cannot be defined via an EL expression; only a string is permitted. </p> | 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 | An EL expression, returning a boolean, that controls whether the detail text of the associated messages is displayed. Default: false. | String |
showSummary | An EL expression, returning a boolean, that controls whether the summary text of the associated messages is displayed. Default: true. | String |
style | HTML: CSS styling instructions. | String |
styleClass | The CSS class for this element. Corresponds to the HTML 'class' attribute. | String |
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 | A boolean value that controls whether global messages (those without IDs) should be displayed. Default: 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 | An identifier for this particular component instance within a component view. <p> The id must be unique within the scope of the tag's enclosing NamingContainer (eg h:form or f:subview). The id is not necessarily unique across all components in the current view </p> <p> This value must be a static value, ie not change over the lifetime of a component. It cannot be defined via an EL expression; only a string is permitted. </p> | 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 | An EL expression, returning a boolean, that controls whether the detail text of the associated messages is displayed. Default: false. | String |
showSummary | An EL expression, returning a boolean, that controls whether the summary text of the associated messages is displayed. Default: true. | String |
style | HTML: CSS styling instructions. | String |
styleClass | The CSS class for this element. Corresponds to the HTML 'class' attribute. | String |
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 |
icon | * | String |
id | An identifier for this particular component instance within a component view. <p> The id must be unique within the scope of the tag's enclosing NamingContainer (eg h:form or f:subview). The id is not necessarily unique across all components in the current view </p> <p> This value must be a static value, ie not change over the lifetime of a component. It cannot be defined via an EL expression; only a string is permitted. </p> | String |
itemDescription | An optional description for this item. For use in development tools. | String |
itemDisabled | Determine whether this item can be chosen by the user. | String |
itemLabel | Get the string which will be presented to the user for this option. | String |
itemValue | The value of this item, of the same type as the parent component's value. | String |
rendered | A boolean value that indicates whether this component should be rendered. Default value: true. | String |
split | * | String |
target | * | String |
value | An EL expression that refers to a javax.faces.model.SelectItem instance. | 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 | An identifier for this particular component instance within a component view. <p> The id must be unique within the scope of the tag's enclosing NamingContainer (eg h:form or f:subview). The id is not necessarily unique across all components in the current view </p> <p> This value must be a static value, ie not change over the lifetime of a component. It cannot be defined via an EL expression; only a string is permitted. </p> | String |
value | An EL expression that specifies the contents of the selection list. The expression can refer to one of the following: <ol> <li>A single SelectItem</li> <li>An array or Collection of SelectItem instances</li> <li>A Map. The contents of the Map are used to create SelectItem instances, where the SelectItem's label is the map's key value, and the SelectItem's value is the map's value. When using a map, it is recommended that an ordered implementation such as java.util.TreeMap is used.</li> </ol> The value properties of each of the SelectItems must be of the same basic type as the parent component's value. | String |
<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 |
cellpadding | HTML: Specifies the amount of empty space between the cell border and its contents. It can be either a pixel length or a percentage. | String |
cellspacing | HTML: Specifies the amount of space between the cells of the table. It can be either a pixel length or a percentage of available space. | String |
columnClasses | A comma separated list of CSS class names to apply to td elements in each column. | String |
datafld | Reserved for future use. | String |
dataformatas | Reserved for future use. | String |
datasrc | Reserved for future use. | String |
dir | HTML: The direction of text display, either 'ltr' (left-to-right) or 'rtl' (right-to-left). | String |
first | The index of the first row to be displayed, where 0 is the first row. | String |
footerClass | The CSS class to be applied to footer cells. | String |
frame | HTML: Controls what part of the frame that surrounds a table is visible. Values include: void, above, below, hsides, lhs, rhs, vsides, box, and border. | String |
headerClass | The CSS class to be applied to header cells. | String |
id | An identifier for this particular component instance within a component view. <p> The id must be unique within the scope of the tag's enclosing NamingContainer (eg h:form or f:subview). The id is not necessarily unique across all components in the current view </p> <p> This value must be a static value, ie not change over the lifetime of a component. It cannot be defined via an EL expression; only a string is permitted. </p> | 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 | The number of rows to be displayed. Specify zero for all remaining rows in the table. | String |
rules | HTML: Controls how rules are rendered between cells. Values include: none, groups, rows, cols, and all. | String |
style | HTML: CSS styling instructions. | String |
styleClass | The CSS class for this element. Corresponds to the HTML 'class' attribute. | String |
summary | HTML: Provides a summary of the contents of the table, for accessibility purposes. | String |
title | HTML: An advisory title for this element. Often used by the user agent as a tooltip. | String |
value | An EL expression that specifies the data model that backs this table. The value can be of any type. A value of type DataModel is used directly. Array-like parameters of type java.util.List, array of Object, java.sql.ResultSet, or javax.servlet.jsp.jstl.sql.Result are wrapped in a DataModel. Other values are wrapped in a DataModel as a single row. | String |
var* | Defines the name of the request-scope variable that will hold the current row during iteration. This value must be a static value. | String |
width | HTML: Specifies the desired width of the table, as a pixel length or a percentage of available space. | String |
<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 | The value can either be a static value (ID) or an EL expression. When a static id is specified, an instance of the converter type registered with that id is used. When this is an EL expression, the result of evaluating the expression must be an object that implements the Converter interface. | String |
dir | 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 |
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 | An identifier for this particular component instance within a component view. <p> The id must be unique within the scope of the tag's enclosing NamingContainer (eg h:form or f:subview). The id is not necessarily unique across all components in the current view </p> <p> This value must be a static value, ie not change over the lifetime of a component. It cannot be defined via an EL expression; only a string is permitted. </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 |
rendered | A boolean value that indicates whether this component should be rendered. Default value: true. | String |
style | HTML: CSS styling instructions. | String |
styleClass | The CSS class for this element. Corresponds to the HTML 'class' attribute. | String |
tabindex | HTML: Specifies the position of this element within the tab order of the document. | String |
title | HTML: An advisory title for this element. Often used by the user agent as a tooltip. | String |
value | The initial value of this component. This value is generally set as a value-binding in the form #{myBean.myProperty}, where myProperty can be any data-type of Java (also user-defined data-types), if a converter for this data-type exists. Special cases: 1) f:selectItems - value needs to bind to a list (or an array) of javax.faces.model.SelectItem-instances 2) components implementing UISelectMany (e.g. h:selectManyCheckbox) - value needs to bind to a list (or an array) of values, where the values need to be of the same data-type as the choices of the associated f:selectItems-component 3) components implementing UIData (e.g. h:dataTable) - value needs to bind to a list (or an array) of values, which will be iterated over when the data-table is processed | String |
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 | The value can either be a static value (ID) or an EL expression. When a static id is specified, an instance of the converter type registered with that id is used. When this is an EL expression, the result of evaluating the expression must be an object that implements the Converter interface. | String |
dir | 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 | An identifier for this particular component instance within a component view. <p> The id must be unique within the scope of the tag's enclosing NamingContainer (eg h:form or f:subview). The id is not necessarily unique across all components in the current view </p> <p> This value must be a static value, ie not change over the lifetime of a component. It cannot be defined via an EL expression; only a string is permitted. </p> | String |
lang | HTML: The base language of this document. | String |
onclick | HTML: Script to be invoked when the element is clicked. | String |
ondblclick | HTML: Script to be invoked when the element is double-clicked. | String |
onkeydown | HTML: Script to be invoked when a key is pressed down over this element. | String |
onkeypress | HTML: Script to be invoked when a key is pressed over this element. | String |
onkeyup | HTML: Script to be invoked when a key is released over this element. | String |
onmousedown | HTML: Script to be invoked when the pointing device is pressed over this element. | String |
onmousemove | HTML: Script to be invoked when the pointing device is moved while it is in this element. | String |
onmouseout | HTML: Script to be invoked when the pointing device is moves out of this element. | String |
onmouseover | HTML: Script to be invoked when the pointing device is moved into this element. | String |
onmouseup | HTML: Script to be invoked when the pointing device is released over this element. | String |
rendered | A boolean value that indicates whether this component should be rendered. Default value: true. | String |
style | HTML: CSS styling instructions. | String |
styleClass | The CSS class for this element. Corresponds to the HTML 'class' attribute. | String |
title | HTML: An advisory title for this element. Often used by the user agent as a tooltip. | String |
value | The initial value of this component. This value is generally set as a value-binding in the form #{myBean.myProperty}, where myProperty can be any data-type of Java (also user-defined data-types), if a converter for this data-type exists. Special cases: 1) f:selectItems - value needs to bind to a list (or an array) of javax.faces.model.SelectItem-instances 2) components implementing UISelectMany (e.g. h:selectManyCheckbox) - value needs to bind to a list (or an array) of values, where the values need to be of the same data-type as the choices of the associated f:selectItems-component 3) components implementing UIData (e.g. h:dataTable) - value needs to bind to a list (or an array) of values, which will be iterated over when the data-table is processed | String |
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 |
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 | An identifier for this particular component instance within a component view. <p> The id must be unique within the scope of the tag's enclosing NamingContainer (eg h:form or f:subview). The id is not necessarily unique across all components in the current view </p> <p> This value must be a static value, ie not change over the lifetime of a component. It cannot be defined via an EL expression; only a string is permitted. </p> | 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 | An identifier for this particular component instance within a component view. <p> The id must be unique within the scope of the tag's enclosing NamingContainer (eg h:form or f:subview). The id is not necessarily unique across all components in the current view </p> <p> This value must be a static value, ie not change over the lifetime of a component. It cannot be defined via an EL expression; only a string is permitted. </p> | 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 | An identifier for this particular component instance within a component view. <p> The id must be unique within the scope of the tag's enclosing NamingContainer (eg h:form or f:subview). The id is not necessarily unique across all components in the current view </p> <p> This value must be a static value, ie not change over the lifetime of a component. It cannot be defined via an EL expression; only a string is permitted. </p> | 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 |
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 |
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 |
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 | An identifier for this particular component instance within a component view. <p> The id must be unique within the scope of the tag's enclosing NamingContainer (eg h:form or f:subview). The id is not necessarily unique across all components in the current view </p> <p> This value must be a static value, ie not change over the lifetime of a component. It cannot be defined via an EL expression; only a string is permitted. </p> | 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 | 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 |
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 |
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: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 | An identifier for this particular component instance within a component view. <p> The id must be unique within the scope of the tag's enclosing NamingContainer (eg h:form or f:subview). The id is not necessarily unique across all components in the current view </p> <p> This value must be a static value, ie not change over the lifetime of a component. It cannot be defined via an EL expression; only a string is permitted. </p> | 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 | An identifier for this particular component instance within a component view. <p> The id must be unique within the scope of the tag's enclosing NamingContainer (eg h:form or f:subview). The id is not necessarily unique across all components in the current view </p> <p> This value must be a static value, ie not change over the lifetime of a component. It cannot be defined via an EL expression; only a string is permitted. </p> | 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 | An identifier for this particular component instance within a component view. <p> The id must be unique within the scope of the tag's enclosing NamingContainer (eg h:form or f:subview). The id is not necessarily unique across all components in the current view </p> <p> This value must be a static value, ie not change over the lifetime of a component. It cannot be defined via an EL expression; only a string is permitted. </p> | String |
label | Label of this tab. | 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: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 | An identifier for this particular component instance within a component view. <p> The id must be unique within the scope of the tag's enclosing NamingContainer (eg h:form or f:subview). The id is not necessarily unique across all components in the current view </p> <p> This value must be a static value, ie not change over the lifetime of a component. It cannot be defined via an EL expression; only a string is permitted. </p> | 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 |
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 | An identifier for this particular component instance within a component view. <p> The id must be unique within the scope of the tag's enclosing NamingContainer (eg h:form or f:subview). The id is not necessarily unique across all components in the current view </p> <p> This value must be a static value, ie not change over the lifetime of a component. It cannot be defined via an EL expression; only a string is permitted. </p> | 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. If the value is "none", no tag is rendered on the output and instead, onmouseover and onmouseout properties are modified for children components. 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: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 |
---|---|---|
accesskey | HTML: Sets the access key for this element. | String |
align | HTML: Specifies the horizontal alignment of this element. Deprecated in HTML 4.01. | String |
alt | HTML: Specifies alternative text that can be used by a browser that can't show this element. | String |
binding | Identifies a backing bean property (of type UIComponent or appropriate subclass) to bind to this component instance. This value must be an EL expression. | String |
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 |
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 | An identifier for this particular component instance within a component view. <p> The id must be unique within the scope of the tag's enclosing NamingContainer (eg h:form or f:subview). The id is not necessarily unique across all components in the current view </p> <p> This value must be a static value, ie not change over the lifetime of a component. It cannot be defined via an EL expression; only a string is permitted. </p> | String |
index* | The index of the corresponding SelectItem, where 0 represents the first SelectItem. | 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 |
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 |
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: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 | An identifier for this particular component instance within a component view. <p> The id must be unique within the scope of the tag's enclosing NamingContainer (eg h:form or f:subview). The id is not necessarily unique across all components in the current view </p> <p> This value must be a static value, ie not change over the lifetime of a component. It cannot be defined via an EL expression; only a string is permitted. </p> | String |
value* | The value of this parameter. | 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 | * | 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 | An identifier for this particular component instance within a component view. <p> The id must be unique within the scope of the tag's enclosing NamingContainer (eg h:form or f:subview). The id is not necessarily unique across all components in the current view </p> <p> This value must be a static value, ie not change over the lifetime of a component. It cannot be defined via an EL expression; only a string is permitted. </p> | 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 | The value can either be a static value (ID) or an EL expression. When a static id is specified, an instance of the converter type registered with that id is used. When this is an EL expression, the result of evaluating the expression must be an object that implements the Converter interface. | String |
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 | An identifier for this particular component instance within a component view. <p> The id must be unique within the scope of the tag's enclosing NamingContainer (eg h:form or f:subview). The id is not necessarily unique across all components in the current view </p> <p> This value must be a static value, ie not change over the lifetime of a component. It cannot be defined via an EL expression; only a string is permitted. </p> | String |
immediate | A boolean value that identifies the phase during which value change events should fire. During normal event processing, value change events are fired during the "process validations" phase of request processing. If this attribute is set to "true", these methods are fired instead at the end of the "apply request values" phase. | String |
lang | HTML: The base language of this document. | String |
onblur | HTML: Specifies a script to be invoked when the element loses focus. | String |
onchange | HTML: Specifies a script to be invoked when the element is modified. | String |
onclick | HTML: Script to be invoked when the element is clicked. | String |
ondblclick | HTML: Script to be invoked when the element is double-clicked. | String |
onfocus | HTML: Specifies a script to be invoked when the element receives focus. | String |
onkeydown | HTML: Script to be invoked when a key is pressed down over this element. | String |
onkeypress | HTML: Script to be invoked when a key is pressed over this element. | String |
onkeyup | HTML: Script to be invoked when a key is released over this element. | String |
onmousedown | HTML: Script to be invoked when the pointing device is pressed over this element. | String |
onmousemove | HTML: Script to be invoked when the pointing device is moved while it is in this element. | String |
onmouseout | HTML: Script to be invoked when the pointing device is moves out of this element. | String |
onmouseover | HTML: Script to be invoked when the pointing device is moved into this element. | String |
onmouseup | HTML: Script to be invoked when the pointing device is released over this element. | String |
onselect | HTML: Specifies a script to be invoked when the element is selected. | String |
readonly | HTML: When true, indicates that this component cannot be modified by the user. The element may receive focus unless it has also been disabled. | String |
rendered | A boolean value that indicates whether this component should be rendered. Default value: true. | String |
required | A boolean value that indicates whether an input value is required. If this value is true, and no input value is provided, the error message javax.faces.component.UIInput.REQUIRED is posted. | String |
style | HTML: CSS styling instructions. | String |
styleClass | The CSS class for this element. Corresponds to the HTML 'class' attribute. | String |
tabindex | HTML: Specifies the position of this element within the tab order of the document. | String |
title | HTML: An advisory title for this element. Often used by the user agent as a tooltip. | String |
validator | A method binding EL expression, accepting FacesContext, UIComponent, and Object parameters, and returning void, that validates the component's local value. | String |
value | The initial value of this component. This value is generally set as a value-binding in the form #{myBean.myProperty}, where myProperty can be any data-type of Java (also user-defined data-types), if a converter for this data-type exists. Special cases: 1) f:selectItems - value needs to bind to a list (or an array) of javax.faces.model.SelectItem-instances 2) components implementing UISelectMany (e.g. h:selectManyCheckbox) - value needs to bind to a list (or an array) of values, where the values need to be of the same data-type as the choices of the associated f:selectItems-component 3) components implementing UIData (e.g. h:dataTable) - value needs to bind to a list (or an array) of values, which will be iterated over when the data-table is processed | String |
valueChangeListener | A method binding EL expression, accepting a ValueChangeEvent parameter and returning void. The specified method is invoked if this component is modified. The phase that this handler is fired in can be controlled via the immediate attribute. | String |
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 | An identifier for this particular component instance within a component view. <p> The id must be unique within the scope of the tag's enclosing NamingContainer (eg h:form or f:subview). The id is not necessarily unique across all components in the current view </p> <p> This value must be a static value, ie not change over the lifetime of a component. It cannot be defined via an EL expression; only a string is permitted. </p> | String |
itemLabel | name of the selectitem | String |
itemValue | value of the selectitem | String |
useEntryAsItem | Only applies when value points to a map. Use the Entry instance instead the value for resolve EL Expressions | String |
value | An EL expression that specifies the contents of the selection list. The expression can refer to one of the following: <ol> <li>A single SelectItem</li> <li>An array or Collection of SelectItem instances</li> <li>A Map. The contents of the Map are used to create SelectItem instances, where the SelectItem's label is the map's key value, and the SelectItem's value is the map's value. When using a map, it is recommended that an ordered implementation such as java.util.TreeMap is used.</li> </ol> The value properties of each of the SelectItems must be of the same basic type as the parent component's value. | String |
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 | The value can either be a static value (ID) or an EL expression. When a static id is specified, an instance of the converter type registered with that id is used. When this is an EL expression, the result of evaluating the expression must be an object that implements the Converter interface. | String |
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 | An identifier for this particular component instance within a component view. <p> The id must be unique within the scope of the tag's enclosing NamingContainer (eg h:form or f:subview). The id is not necessarily unique across all components in the current view </p> <p> This value must be a static value, ie not change over the lifetime of a component. It cannot be defined via an EL expression; only a string is permitted. </p> | String |
immediate | A boolean value that identifies the phase during which value change events should fire. During normal event processing, value change events are fired during the "process validations" phase of request processing. If this attribute is set to "true", these methods are fired instead at the end of the "apply request values" phase. | String |
lang | HTML: The base language of this document. | String |
layout | Controls the layout direction of the child elements. Values include: lineDirection (vertical) and pageDirection (horzontal). | String |
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. If this value is true, and no input value is provided, the error message javax.faces.component.UIInput.REQUIRED is posted. | String |
style | HTML: CSS styling instructions. | String |
styleClass | The CSS class for this element. Corresponds to the HTML 'class' attribute. | String |
tabindex | HTML: Specifies the position of this element within the tab order of the document. | String |
title | HTML: An advisory title for this element. Often used by the user agent as a tooltip. | String |
validator | A method binding EL expression, accepting FacesContext, UIComponent, and Object parameters, and returning void, that validates the component's local value. | String |
value | The initial value of this component. This value is generally set as a value-binding in the form #{myBean.myProperty}, where myProperty can be any data-type of Java (also user-defined data-types), if a converter for this data-type exists. Special cases: 1) f:selectItems - value needs to bind to a list (or an array) of javax.faces.model.SelectItem-instances 2) components implementing UISelectMany (e.g. h:selectManyCheckbox) - value needs to bind to a list (or an array) of values, where the values need to be of the same data-type as the choices of the associated f:selectItems-component 3) components implementing UIData (e.g. h:dataTable) - value needs to bind to a list (or an array) of values, which will be iterated over when the data-table is processed | String |
valueChangeListener | A method binding EL expression, accepting a ValueChangeEvent parameter and returning void. The specified method is invoked if this component is modified. The phase that this handler is fired in can be controlled via the immediate attribute. | String |
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 | The value can either be a static value (ID) or an EL expression. When a static id is specified, an instance of the converter type registered with that id is used. When this is an EL expression, the result of evaluating the expression must be an object that implements the Converter interface. | String |
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 | An identifier for this particular component instance within a component view. <p> The id must be unique within the scope of the tag's enclosing NamingContainer (eg h:form or f:subview). The id is not necessarily unique across all components in the current view </p> <p> This value must be a static value, ie not change over the lifetime of a component. It cannot be defined via an EL expression; only a string is permitted. </p> | String |
immediate | A boolean value that identifies the phase during which value change events should fire. During normal event processing, value change events are fired during the "process validations" phase of request processing. If this attribute is set to "true", these methods are fired instead at the end of the "apply request values" phase. | String |
lang | HTML: The base language of this document. | String |
onblur | HTML: Specifies a script to be invoked when the element loses focus. | String |
onchange | HTML: Specifies a script to be invoked when the element is modified. | String |
onclick | HTML: Script to be invoked when the element is clicked. | String |
ondblclick | HTML: Script to be invoked when the element is double-clicked. | String |
onfocus | HTML: Specifies a script to be invoked when the element receives focus. | String |
onkeydown | HTML: Script to be invoked when a key is pressed down over this element. | String |
onkeypress | HTML: Script to be invoked when a key is pressed over this element. | String |
onkeyup | HTML: Script to be invoked when a key is released over this element. | String |
onmousedown | HTML: Script to be invoked when the pointing device is pressed over this element. | String |
onmousemove | HTML: Script to be invoked when the pointing device is moved while it is in this element. | String |
onmouseout | HTML: Script to be invoked when the pointing device is moves out of this element. | String |
onmouseover | HTML: Script to be invoked when the pointing device is moved into this element. | String |
onmouseup | HTML: Script to be invoked when the pointing device is released over this element. | String |
onselect | HTML: Specifies a script to be invoked when the element is selected. | String |
readonly | HTML: When true, indicates that this component cannot be modified by the user. The element may receive focus unless it has also been disabled. | String |
rendered | A boolean value that indicates whether this component should be rendered. Default value: true. | String |
required | A boolean value that indicates whether an input value is required. If this value is true, and no input value is provided, the error message javax.faces.component.UIInput.REQUIRED is posted. | String |
size | see JSF Spec. | String |
style | HTML: CSS styling instructions. | String |
styleClass | The CSS class for this element. Corresponds to the HTML 'class' attribute. | String |
tabindex | HTML: Specifies the position of this element within the tab order of the document. | String |
title | HTML: An advisory title for this element. Often used by the user agent as a tooltip. | String |
validator | A method binding EL expression, accepting FacesContext, UIComponent, and Object parameters, and returning void, that validates the component's local value. | String |
value | The initial value of this component. This value is generally set as a value-binding in the form #{myBean.myProperty}, where myProperty can be any data-type of Java (also user-defined data-types), if a converter for this data-type exists. Special cases: 1) f:selectItems - value needs to bind to a list (or an array) of javax.faces.model.SelectItem-instances 2) components implementing UISelectMany (e.g. h:selectManyCheckbox) - value needs to bind to a list (or an array) of values, where the values need to be of the same data-type as the choices of the associated f:selectItems-component 3) components implementing UIData (e.g. h:dataTable) - value needs to bind to a list (or an array) of values, which will be iterated over when the data-table is processed | String |
valueChangeListener | A method binding EL expression, accepting a ValueChangeEvent parameter and returning void. The specified method is invoked if this component is modified. The phase that this handler is fired in can be controlled via the immediate attribute. | String |
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 | The value can either be a static value (ID) or an EL expression. When a static id is specified, an instance of the converter type registered with that id is used. When this is an EL expression, the result of evaluating the expression must be an object that implements the Converter interface. | String |
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 | An identifier for this particular component instance within a component view. <p> The id must be unique within the scope of the tag's enclosing NamingContainer (eg h:form or f:subview). The id is not necessarily unique across all components in the current view </p> <p> This value must be a static value, ie not change over the lifetime of a component. It cannot be defined via an EL expression; only a string is permitted. </p> | String |
immediate | A boolean value that identifies the phase during which value change events should fire. During normal event processing, value change events are fired during the "process validations" phase of request processing. If this attribute is set to "true", these methods are fired instead at the end of the "apply request values" phase. | String |
lang | HTML: The base language of this document. | String |
onblur | HTML: Specifies a script to be invoked when the element loses focus. | String |
onchange | HTML: Specifies a script to be invoked when the element is modified. | String |
onclick | HTML: Script to be invoked when the element is clicked. | String |
ondblclick | HTML: Script to be invoked when the element is double-clicked. | String |
onfocus | HTML: Specifies a script to be invoked when the element receives focus. | String |
onkeydown | HTML: Script to be invoked when a key is pressed down over this element. | String |
onkeypress | HTML: Script to be invoked when a key is pressed over this element. | String |
onkeyup | HTML: Script to be invoked when a key is released over this element. | String |
onmousedown | HTML: Script to be invoked when the pointing device is pressed over this element. | String |
onmousemove | HTML: Script to be invoked when the pointing device is moved while it is in this element. | String |
onmouseout | HTML: Script to be invoked when the pointing device is moves out of this element. | String |
onmouseover | HTML: Script to be invoked when the pointing device is moved into this element. | String |
onmouseup | HTML: Script to be invoked when the pointing device is released over this element. | String |
onselect | HTML: Specifies a script to be invoked when the element is selected. | String |
readonly | HTML: When true, indicates that this component cannot be modified by the user. The element may receive focus unless it has also been disabled. | String |
rendered | A boolean value that indicates whether this component should be rendered. Default value: true. | String |
required | A boolean value that indicates whether an input value is required. If this value is true, and no input value is provided, the error message javax.faces.component.UIInput.REQUIRED is posted. | String |
style | HTML: CSS styling instructions. | String |
styleClass | The CSS class for this element. Corresponds to the HTML 'class' attribute. | String |
tabindex | HTML: Specifies the position of this element within the tab order of the document. | String |
title | HTML: An advisory title for this element. Often used by the user agent as a tooltip. | String |
validator | A method binding EL expression, accepting FacesContext, UIComponent, and Object parameters, and returning void, that validates the component's local value. | String |
value | The initial value of this component. This value is generally set as a value-binding in the form #{myBean.myProperty}, where myProperty can be any data-type of Java (also user-defined data-types), if a converter for this data-type exists. Special cases: 1) f:selectItems - value needs to bind to a list (or an array) of javax.faces.model.SelectItem-instances 2) components implementing UISelectMany (e.g. h:selectManyCheckbox) - value needs to bind to a list (or an array) of values, where the values need to be of the same data-type as the choices of the associated f:selectItems-component 3) components implementing UIData (e.g. h:dataTable) - value needs to bind to a list (or an array) of values, which will be iterated over when the data-table is processed | String |
valueChangeListener | A method binding EL expression, accepting a ValueChangeEvent parameter and returning void. The specified method is invoked if this component is modified. The phase that this handler is fired in can be controlled via the immediate attribute. | String |
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 | The value can either be a static value (ID) or an EL expression. When a static id is specified, an instance of the converter type registered with that id is used. When this is an EL expression, the result of evaluating the expression must be an object that implements the Converter interface. | String |
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 | An identifier for this particular component instance within a component view. <p> The id must be unique within the scope of the tag's enclosing NamingContainer (eg h:form or f:subview). The id is not necessarily unique across all components in the current view </p> <p> This value must be a static value, ie not change over the lifetime of a component. It cannot be defined via an EL expression; only a string is permitted. </p> | String |
immediate | A boolean value that identifies the phase during which value change events should fire. During normal event processing, value change events are fired during the "process validations" phase of request processing. If this attribute is set to "true", these methods are fired instead at the end of the "apply request values" phase. | String |
lang | HTML: The base language of this document. | String |
onblur | HTML: Specifies a script to be invoked when the element loses focus. | String |
onchange | HTML: Specifies a script to be invoked when the element is modified. | String |
onclick | HTML: Script to be invoked when the element is clicked. | String |
ondblclick | HTML: Script to be invoked when the element is double-clicked. | String |
onfocus | HTML: Specifies a script to be invoked when the element receives focus. | String |
onkeydown | HTML: Script to be invoked when a key is pressed down over this element. | String |
onkeypress | HTML: Script to be invoked when a key is pressed over this element. | String |
onkeyup | HTML: Script to be invoked when a key is released over this element. | String |
onmousedown | HTML: Script to be invoked when the pointing device is pressed over this element. | String |
onmousemove | HTML: Script to be invoked when the pointing device is moved while it is in this element. | String |
onmouseout | HTML: Script to be invoked when the pointing device is moves out of this element. | String |
onmouseover | HTML: Script to be invoked when the pointing device is moved into this element. | String |
onmouseup | HTML: Script to be invoked when the pointing device is released over this element. | String |
onselect | HTML: Specifies a script to be invoked when the element is selected. | String |
readonly | HTML: When true, indicates that this component cannot be modified by the user. The element may receive focus unless it has also been disabled. | String |
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. If this value is true, and no input value is provided, the error message javax.faces.component.UIInput.REQUIRED is posted. | String |
size | see JSF Spec. | String |
style | HTML: CSS styling instructions. | String |
styleClass | The CSS class for this element. Corresponds to the HTML 'class' attribute. | String |
tabindex | HTML: Specifies the position of this element within the tab order of the document. | String |
title | HTML: An advisory title for this element. Often used by the user agent as a tooltip. | String |
validator | A method binding EL expression, accepting FacesContext, UIComponent, and Object parameters, and returning void, that validates the component's local value. | String |
value | The initial value of this component. This value is generally set as a value-binding in the form #{myBean.myProperty}, where myProperty can be any data-type of Java (also user-defined data-types), if a converter for this data-type exists. Special cases: 1) f:selectItems - value needs to bind to a list (or an array) of javax.faces.model.SelectItem-instances 2) components implementing UISelectMany (e.g. h:selectManyCheckbox) - value needs to bind to a list (or an array) of values, where the values need to be of the same data-type as the choices of the associated f:selectItems-component 3) components implementing UIData (e.g. h:dataTable) - value needs to bind to a list (or an array) of values, which will be iterated over when the data-table is processed | String |
valueChangeListener | A method binding EL expression, accepting a ValueChangeEvent parameter and returning void. The specified method is invoked if this component is modified. The phase that this handler is fired in can be controlled via the immediate attribute. | String |
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 | The value can either be a static value (ID) or an EL expression. When a static id is specified, an instance of the converter type registered with that id is used. When this is an EL expression, the result of evaluating the expression must be an object that implements the Converter interface. | String |
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 | An identifier for this particular component instance within a component view. <p> The id must be unique within the scope of the tag's enclosing NamingContainer (eg h:form or f:subview). The id is not necessarily unique across all components in the current view </p> <p> This value must be a static value, ie not change over the lifetime of a component. It cannot be defined via an EL expression; only a string is permitted. </p> | String |
immediate | A boolean value that identifies the phase during which value change events should fire. During normal event processing, value change events are fired during the "process validations" phase of request processing. If this attribute is set to "true", these methods are fired instead at the end of the "apply request values" phase. | String |
lang | HTML: The base language of this document. | String |
maxLength | 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. If this value is true, and no input value is provided, the error message javax.faces.component.UIInput.REQUIRED is posted. | String |
style | HTML: CSS styling instructions. | String |
styleClass | The CSS class for this element. Corresponds to the HTML 'class' attribute. | String |
tabindex | HTML: Specifies the position of this element within the tab order of the document. | String |
title | HTML: An advisory title for this element. Often used by the user agent as a tooltip. | String |
validator | A method binding EL expression, accepting FacesContext, UIComponent, and Object parameters, and returning void, that validates the component's local value. | String |
value | The initial value of this component. This value is generally set as a value-binding in the form #{myBean.myProperty}, where myProperty can be any data-type of Java (also user-defined data-types), if a converter for this data-type exists. Special cases: 1) f:selectItems - value needs to bind to a list (or an array) of javax.faces.model.SelectItem-instances 2) components implementing UISelectMany (e.g. h:selectManyCheckbox) - value needs to bind to a list (or an array) of values, where the values need to be of the same data-type as the choices of the associated f:selectItems-component 3) components implementing UIData (e.g. h:dataTable) - value needs to bind to a list (or an array) of values, which will be iterated over when the data-table is processed | String |
valueChangeListener | A method binding EL expression, accepting a ValueChangeEvent parameter and returning void. The specified method is invoked if this component is modified. The phase that this handler is fired in can be controlled via the immediate attribute. | String |
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 | The value can either be a static value (ID) or an EL expression. When a static id is specified, an instance of the converter type registered with that id is used. When this is an EL expression, the result of evaluating the expression must be an object that implements the Converter interface. | String |
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 | An identifier for this particular component instance within a component view. <p> The id must be unique within the scope of the tag's enclosing NamingContainer (eg h:form or f:subview). The id is not necessarily unique across all components in the current view </p> <p> This value must be a static value, ie not change over the lifetime of a component. It cannot be defined via an EL expression; only a string is permitted. </p> | String |
immediate | A boolean value that identifies the phase during which value change events should fire. During normal event processing, value change events are fired during the "process validations" phase of request processing. If this attribute is set to "true", these methods are fired instead at the end of the "apply request values" phase. | String |
lang | HTML: The base language of this document. | String |
maxLength | 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. If this value is true, and no input value is provided, the error message javax.faces.component.UIInput.REQUIRED is posted. | String |
style | HTML: CSS styling instructions. | String |
styleClass | The CSS class for this element. Corresponds to the HTML 'class' attribute. | String |
tabindex | HTML: Specifies the position of this element within the tab order of the document. | String |
title | HTML: An advisory title for this element. Often used by the user agent as a tooltip. | String |
validator | A method binding EL expression, accepting FacesContext, UIComponent, and Object parameters, and returning void, that validates the component's local value. | String |
value | The initial value of this component. This value is generally set as a value-binding in the form #{myBean.myProperty}, where myProperty can be any data-type of Java (also user-defined data-types), if a converter for this data-type exists. Special cases: 1) f:selectItems - value needs to bind to a list (or an array) of javax.faces.model.SelectItem-instances 2) components implementing UISelectMany (e.g. h:selectManyCheckbox) - value needs to bind to a list (or an array) of values, where the values need to be of the same data-type as the choices of the associated f:selectItems-component 3) components implementing UIData (e.g. h:dataTable) - value needs to bind to a list (or an array) of values, which will be iterated over when the data-table is processed | String |
valueChangeListener | A method binding EL expression, accepting a ValueChangeEvent parameter and returning void. The specified method is invoked if this component is modified. The phase that this handler is fired in can be controlled via the immediate attribute. | String |
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 | The value can either be a static value (ID) or an EL expression. When a static id is specified, an instance of the converter type registered with that id is used. When this is an EL expression, the result of evaluating the expression must be an object that implements the Converter interface. | String |
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 | An identifier for this particular component instance within a component view. <p> The id must be unique within the scope of the tag's enclosing NamingContainer (eg h:form or f:subview). The id is not necessarily unique across all components in the current view </p> <p> This value must be a static value, ie not change over the lifetime of a component. It cannot be defined via an EL expression; only a string is permitted. </p> | String |
immediate | A boolean value that identifies the phase during which value change events should fire. During normal event processing, value change events are fired during the "process validations" phase of request processing. If this attribute is set to "true", these methods are fired instead at the end of the "apply request values" phase. | String |
lang | HTML: The base language of this document. | String |
onblur | HTML: Specifies a script to be invoked when the element loses focus. | String |
onchange | HTML: Specifies a script to be invoked when the element is modified. | String |
onclick | HTML: Script to be invoked when the element is clicked. | String |
ondblclick | HTML: Script to be invoked when the element is double-clicked. | String |
onfocus | HTML: Specifies a script to be invoked when the element receives focus. | String |
onkeydown | HTML: Script to be invoked when a key is pressed down over this element. | String |
onkeypress | HTML: Script to be invoked when a key is pressed over this element. | String |
onkeyup | HTML: Script to be invoked when a key is released over this element. | String |
onmousedown | HTML: Script to be invoked when the pointing device is pressed over this element. | String |
onmousemove | HTML: Script to be invoked when the pointing device is moved while it is in this element. | String |
onmouseout | HTML: Script to be invoked when the pointing device is moves out of this element. | String |
onmouseover | HTML: Script to be invoked when the pointing device is moved into this element. | String |
onmouseup | HTML: Script to be invoked when the pointing device is released over this element. | String |
onselect | HTML: Specifies a script to be invoked when the element is selected. | String |
readonly | HTML: When true, indicates that this component cannot be modified by the user. The element may receive focus unless it has also been disabled. | String |
rendered | A boolean value that indicates whether this component should be rendered. Default value: true. | String |
required | A boolean value that indicates whether an input value is required. If this value is true, and no input value is provided, the error message javax.faces.component.UIInput.REQUIRED is posted. | String |
size | see JSF Spec. | String |
style | HTML: CSS styling instructions. | String |
styleClass | The CSS class for this element. Corresponds to the HTML 'class' attribute. | String |
tabindex | HTML: Specifies the position of this element within the tab order of the document. | String |
title | HTML: An advisory title for this element. Often used by the user agent as a tooltip. | String |
validator | A method binding EL expression, accepting FacesContext, UIComponent, and Object parameters, and returning void, that validates the component's local value. | String |
value | The initial value of this component. This value is generally set as a value-binding in the form #{myBean.myProperty}, where myProperty can be any data-type of Java (also user-defined data-types), if a converter for this data-type exists. Special cases: 1) f:selectItems - value needs to bind to a list (or an array) of javax.faces.model.SelectItem-instances 2) components implementing UISelectMany (e.g. h:selectManyCheckbox) - value needs to bind to a list (or an array) of values, where the values need to be of the same data-type as the choices of the associated f:selectItems-component 3) components implementing UIData (e.g. h:dataTable) - value needs to bind to a list (or an array) of values, which will be iterated over when the data-table is processed | String |
valueChangeListener | A method binding EL expression, accepting a ValueChangeEvent parameter and returning void. The specified method is invoked if this component is modified. The phase that this handler is fired in can be controlled via the immediate attribute. | String |
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 | The value can either be a static value (ID) or an EL expression. When a static id is specified, an instance of the converter type registered with that id is used. When this is an EL expression, the result of evaluating the expression must be an object that implements the Converter interface. | String |
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 | An identifier for this particular component instance within a component view. <p> The id must be unique within the scope of the tag's enclosing NamingContainer (eg h:form or f:subview). The id is not necessarily unique across all components in the current view </p> <p> This value must be a static value, ie not change over the lifetime of a component. It cannot be defined via an EL expression; only a string is permitted. </p> | String |
immediate | A boolean value that identifies the phase during which value change events should fire. During normal event processing, value change events are fired during the "process validations" phase of request processing. If this attribute is set to "true", these methods are fired instead at the end of the "apply request values" phase. | String |
lang | HTML: The base language of this document. | String |
onblur | HTML: Specifies a script to be invoked when the element loses focus. | String |
onchange | HTML: Specifies a script to be invoked when the element is modified. | String |
onclick | HTML: Script to be invoked when the element is clicked. | String |
ondblclick | HTML: Script to be invoked when the element is double-clicked. | String |
onfocus | HTML: Specifies a script to be invoked when the element receives focus. | String |
onkeydown | HTML: Script to be invoked when a key is pressed down over this element. | String |
onkeypress | HTML: Script to be invoked when a key is pressed over this element. | String |
onkeyup | HTML: Script to be invoked when a key is released over this element. | String |
onmousedown | HTML: Script to be invoked when the pointing device is pressed over this element. | String |
onmousemove | HTML: Script to be invoked when the pointing device is moved while it is in this element. | String |
onmouseout | HTML: Script to be invoked when the pointing device is moves out of this element. | String |
onmouseover | HTML: Script to be invoked when the pointing device is moved into this element. | String |
onmouseup | HTML: Script to be invoked when the pointing device is released over this element. | String |
onselect | HTML: Specifies a script to be invoked when the element is selected. | String |
readonly | HTML: When true, indicates that this component cannot be modified by the user. The element may receive focus unless it has also been disabled. | String |
rendered | A boolean value that indicates whether this component should be rendered. Default value: true. | String |
required | A boolean value that indicates whether an input value is required. If this value is true, and no input value is provided, the error message javax.faces.component.UIInput.REQUIRED is posted. | String |
style | HTML: CSS styling instructions. | String |
styleClass | The CSS class for this element. Corresponds to the HTML 'class' attribute. | String |
tabindex | HTML: Specifies the position of this element within the tab order of the document. | String |
title | HTML: An advisory title for this element. Often used by the user agent as a tooltip. | String |
validator | A method binding EL expression, accepting FacesContext, UIComponent, and Object parameters, and returning void, that validates the component's local value. | String |
value | The initial value of this component. This value is generally set as a value-binding in the form #{myBean.myProperty}, where myProperty can be any data-type of Java (also user-defined data-types), if a converter for this data-type exists. Special cases: 1) f:selectItems - value needs to bind to a list (or an array) of javax.faces.model.SelectItem-instances 2) components implementing UISelectMany (e.g. h:selectManyCheckbox) - value needs to bind to a list (or an array) of values, where the values need to be of the same data-type as the choices of the associated f:selectItems-component 3) components implementing UIData (e.g. h:dataTable) - value needs to bind to a list (or an array) of values, which will be iterated over when the data-table is processed | String |
valueChangeListener | A method binding EL expression, accepting a ValueChangeEvent parameter and returning void. The specified method is invoked if this component is modified. The phase that this handler is fired in can be controlled via the immediate attribute. | String |
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 | The value can either be a static value (ID) or an EL expression. When a static id is specified, an instance of the converter type registered with that id is used. When this is an EL expression, the result of evaluating the expression must be an object that implements the Converter interface. | String |
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 | An identifier for this particular component instance within a component view. <p> The id must be unique within the scope of the tag's enclosing NamingContainer (eg h:form or f:subview). The id is not necessarily unique across all components in the current view </p> <p> This value must be a static value, ie not change over the lifetime of a component. It cannot be defined via an EL expression; only a string is permitted. </p> | String |
immediate | A boolean value that identifies the phase during which value change events should fire. During normal event processing, value change events are fired during the "process validations" phase of request processing. If this attribute is set to "true", these methods are fired instead at the end of the "apply request values" phase. | String |
lang | HTML: The base language of this document. | String |
layout | Orientation of the options list. Valid values are "pageDirection" for a vertical layout, or "lineDirection" for horizontal. The default value is "lineDirection". | String |
onblur | HTML: Specifies a script to be invoked when the element loses focus. | String |
onchange | HTML: Specifies a script to be invoked when the element is modified. | String |
onclick | HTML: Script to be invoked when the element is clicked. | String |
ondblclick | HTML: Script to be invoked when the element is double-clicked. | String |
onfocus | HTML: Specifies a script to be invoked when the element receives focus. | String |
onkeydown | HTML: Script to be invoked when a key is pressed down over this element. | String |
onkeypress | HTML: Script to be invoked when a key is pressed over this element. | String |
onkeyup | HTML: Script to be invoked when a key is released over this element. | String |
onmousedown | HTML: Script to be invoked when the pointing device is pressed over this element. | String |
onmousemove | HTML: Script to be invoked when the pointing device is moved while it is in this element. | String |
onmouseout | HTML: Script to be invoked when the pointing device is moves out of this element. | String |
onmouseover | HTML: Script to be invoked when the pointing device is moved into this element. | String |
onmouseup | HTML: Script to be invoked when the pointing device is released over this element. | String |
onselect | HTML: Specifies a script to be invoked when the element is selected. | String |
readonly | HTML: When true, indicates that this component cannot be modified by the user. The element may receive focus unless it has also been disabled. | String |
rendered | A boolean value that indicates whether this component should be rendered. Default value: true. | String |
required | A boolean value that indicates whether an input value is required. If this value is true, and no input value is provided, the error message javax.faces.component.UIInput.REQUIRED is posted. | String |
style | HTML: CSS styling instructions. | String |
styleClass | The CSS class for this element. Corresponds to the HTML 'class' attribute. | String |
tabindex | HTML: Specifies the position of this element within the tab order of the document. | String |
title | HTML: An advisory title for this element. Often used by the user agent as a tooltip. | String |
validator | A method binding EL expression, accepting FacesContext, UIComponent, and Object parameters, and returning void, that validates the component's local value. | String |
value | The initial value of this component. This value is generally set as a value-binding in the form #{myBean.myProperty}, where myProperty can be any data-type of Java (also user-defined data-types), if a converter for this data-type exists. Special cases: 1) f:selectItems - value needs to bind to a list (or an array) of javax.faces.model.SelectItem-instances 2) components implementing UISelectMany (e.g. h:selectManyCheckbox) - value needs to bind to a list (or an array) of values, where the values need to be of the same data-type as the choices of the associated f:selectItems-component 3) components implementing UIData (e.g. h:dataTable) - value needs to bind to a list (or an array) of values, which will be iterated over when the data-table is processed | String |
valueChangeListener | A method binding EL expression, accepting a ValueChangeEvent parameter and returning void. The specified method is invoked if this component is modified. The phase that this handler is fired in can be controlled via the immediate attribute. | String |
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 | The value can either be a static value (ID) or an EL expression. When a static id is specified, an instance of the converter type registered with that id is used. When this is an EL expression, the result of evaluating the expression must be an object that implements the Converter interface. | String |
disabled | HTML: When true, this element cannot receive focus. | String |
groupName | The Name of the radio-button-group to use. If EL expressions are used, note that every time this is evaluated should lead to the same value in the scope used, that means the UIData instance used, otherwise it could lead to unwanted side effects. | String |
id | An identifier for this particular component instance within a component view. <p> The id must be unique within the scope of the tag's enclosing NamingContainer (eg h:form or f:subview). The id is not necessarily unique across all components in the current view </p> <p> This value must be a static value, ie not change over the lifetime of a component. It cannot be defined via an EL expression; only a string is permitted. </p> | String |
immediate | A boolean value that identifies the phase during which value change events should fire. During normal event processing, value change events are fired during the "process validations" phase of request processing. If this attribute is set to "true", these methods are fired instead at the end of the "apply request values" phase. | String |
onblur | HTML: Specifies a script to be invoked when the element loses focus. | String |
onchange | HTML: Specifies a script to be invoked when the element is modified. | String |
onclick | HTML: Script to be invoked when the element is clicked. | String |
ondblclick | HTML: Script to be invoked when the element is double-clicked. | String |
onfocus | HTML: Specifies a script to be invoked when the element receives focus. | String |
onkeydown | HTML: Script to be invoked when a key is pressed down over this element. | String |
onkeypress | HTML: Script to be invoked when a key is pressed over this element. | String |
onkeyup | HTML: Script to be invoked when a key is released over this element. | String |
onmousedown | HTML: Script to be invoked when the pointing device is pressed over this element. | String |
onmousemove | HTML: Script to be invoked when the pointing device is moved while it is in this element. | String |
onmouseout | HTML: Script to be invoked when the pointing device is moves out of this element. | String |
onmouseover | HTML: Script to be invoked when the pointing device is moved into this element. | String |
onmouseup | HTML: Script to be invoked when the pointing device is released over this element. | String |
onselect | HTML: Specifies a script to be invoked when the element is selected. | String |
readonly | HTML: When true, indicates that this component cannot be modified by the user. The element may receive focus unless it has also been disabled. | String |
rendered | A boolean value that indicates whether this component should be rendered. Default value: true. | String |
required | A boolean value that indicates whether an input value is required. If this value is true, and no input value is provided, the error message javax.faces.component.UIInput.REQUIRED is posted. | String |
validator | A method binding EL expression, accepting FacesContext, UIComponent, and Object parameters, and returning void, that validates the component's local value. | String |
value | The initial value of this component. This value is generally set as a value-binding in the form #{myBean.myProperty}, where myProperty can be any data-type of Java (also user-defined data-types), if a converter for this data-type exists. Special cases: 1) f:selectItems - value needs to bind to a list (or an array) of javax.faces.model.SelectItem-instances 2) components implementing UISelectMany (e.g. h:selectManyCheckbox) - value needs to bind to a list (or an array) of values, where the values need to be of the same data-type as the choices of the associated f:selectItems-component 3) components implementing UIData (e.g. h:dataTable) - value needs to bind to a list (or an array) of values, which will be iterated over when the data-table is processed | String |
valueChangeListener | A method binding EL expression, accepting a ValueChangeEvent parameter and returning void. The specified method is invoked if this component is modified. The phase that this handler is fired in can be controlled via the immediate attribute. | String |
<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 | An identifier for this particular component instance within a component view. <p> The id must be unique within the scope of the tag's enclosing NamingContainer (eg h:form or f:subview). The id is not necessarily unique across all components in the current view </p> <p> This value must be a static value, ie not change over the lifetime of a component. It cannot be defined via an EL expression; only a string is permitted. </p> | 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 <script> 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 | An identifier for this particular component instance within a component view. <p> The id must be unique within the scope of the tag's enclosing NamingContainer (eg h:form or f:subview). The id is not necessarily unique across all components in the current view </p> <p> This value must be a static value, ie not change over the lifetime of a component. It cannot be defined via an EL expression; only a string is permitted. </p> | 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 | An identifier for this particular component instance within a component view. <p> The id must be unique within the scope of the tag's enclosing NamingContainer (eg h:form or f:subview). The id is not necessarily unique across all components in the current view </p> <p> This value must be a static value, ie not change over the lifetime of a component. It cannot be defined via an EL expression; only a string is permitted. </p> | 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. If the URL starts with a '/', it is relative to the context path of the web application. | 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>
Adds a tab-change-listener to the enclosing t:panelTabbedPane component. <p> When the panelTabbedPane changes the displayed tab, the listener is invoked. </p>
Can contain:empty
<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 | An identifier for this particular component instance within a component view. <p> The id must be unique within the scope of the tag's enclosing NamingContainer (eg h:form or f:subview). The id is not necessarily unique across all components in the current view </p> <p> This value must be a static value, ie not change over the lifetime of a component. It cannot be defined via an EL expression; only a string is permitted. </p> | 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 |
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 | The value can either be a static value (ID) or an EL expression. When a static id is specified, an instance of the converter type registered with that id is used. When this is an EL expression, the result of evaluating the expression must be an object that implements the Converter interface. | String |
coords | 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 | An identifier for this particular component instance within a component view. <p> The id must be unique within the scope of the tag's enclosing NamingContainer (eg h:form or f:subview). The id is not necessarily unique across all components in the current view </p> <p> This value must be a static value, ie not change over the lifetime of a component. It cannot be defined via an EL expression; only a string is permitted. </p> | 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 | The initial value of this component. This value is generally set as a value-binding in the form #{myBean.myProperty}, where myProperty can be any data-type of Java (also user-defined data-types), if a converter for this data-type exists. Special cases: 1) f:selectItems - value needs to bind to a list (or an array) of javax.faces.model.SelectItem-instances 2) components implementing UISelectMany (e.g. h:selectManyCheckbox) - value needs to bind to a list (or an array) of values, where the values need to be of the same data-type as the choices of the associated f:selectItems-component 3) components implementing UIData (e.g. h:dataTable) - value needs to bind to a list (or an array) of values, which will be iterated over when the data-table is processed | String |
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 | An identifier for this particular component instance within a component view. <p> The id must be unique within the scope of the tag's enclosing NamingContainer (eg h:form or f:subview). The id is not necessarily unique across all components in the current view </p> <p> This value must be a static value, ie not change over the lifetime of a component. It cannot be defined via an EL expression; only a string is permitted. </p> | 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 |
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 | An identifier for this particular component instance within a component view. <p> The id must be unique within the scope of the tag's enclosing NamingContainer (eg h:form or f:subview). The id is not necessarily unique across all components in the current view </p> <p> This value must be a static value, ie not change over the lifetime of a component. It cannot be defined via an EL expression; only a string is permitted. </p> | 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 | An identifier for this particular component instance within a component view. <p> The id must be unique within the scope of the tag's enclosing NamingContainer (eg h:form or f:subview). The id is not necessarily unique across all components in the current view </p> <p> This value must be a static value, ie not change over the lifetime of a component. It cannot be defined via an EL expression; only a string is permitted. </p> | 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 |
for | id of the referenced extended selectManyCheckbox component | String |
id | An identifier for this particular component instance within a component view. <p> The id must be unique within the scope of the tag's enclosing NamingContainer (eg h:form or f:subview). The id is not necessarily unique across all components in the current view </p> <p> This value must be a static value, ie not change over the lifetime of a component. It cannot be defined via an EL expression; only a string is permitted. </p> | String |
itemDescription | An optional description for this item. For use in development tools. | String |
itemDisabled | Determine whether this item can be chosen by the user. | String |
itemLabel | Get the string which will be presented to the user for this option. | String |
itemValue | The value of this item, of the same type as the parent component's value. | String |
value | An EL expression that refers to a javax.faces.model.SelectItem instance. | String |
<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 | An identifier for this particular component instance within a component view. <p> The id must be unique within the scope of the tag's enclosing NamingContainer (eg h:form or f:subview). The id is not necessarily unique across all components in the current view </p> <p> This value must be a static value, ie not change over the lifetime of a component. It cannot be defined via an EL expression; only a string is permitted. </p> | 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
<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
<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 | alternate validation error detail message format string (use 'message' and 'detailMessage' alternatively) | String |
discover | validation for discover | String |
mastercard | validation for mastercard | String |
message | alternate validation error detail message format string (use 'message' and 'detailMessage' alternatively) | String |
none | none of the given cardtypes is allowed. | String |
summaryMessage | alternate validation error summary message format string | 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 | alternate validation error detail message format string (use 'message' and 'detailMessage' alternatively) | String |
message | alternate validation error detail message format string (use 'message' and 'detailMessage' alternatively) | String |
summaryMessage | alternate validation error summary message format string | 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 | alternate validation error detail message format string (use 'message' and 'detailMessage' alternatively) | String |
for | the id of the foreign component, which is needed for the validation | String |
message | alternate validation error detail message format string (use 'message' and 'detailMessage' alternatively) | String |
summaryMessage | alternate validation error summary message format string | 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 | alternate validation error detail message format string (use 'message' and 'detailMessage' alternatively) | String |
message | alternate validation error detail message format string (use 'message' and 'detailMessage' alternatively) | String |
pattern | the pattern, which is the base of the validation | String |
summaryMessage | alternate validation error summary message format string | 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 | An identifier for this particular component instance within a component view. <p> The id must be unique within the scope of the tag's enclosing NamingContainer (eg h:form or f:subview). The id is not necessarily unique across all components in the current view </p> <p> This value must be a static value, ie not change over the lifetime of a component. It cannot be defined via an EL expression; only a string is permitted. </p> | 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 |