1.0
1.2
h
http://java.sun.com/jsf/html
JSF HTML tag library.
This tag library implements the standard JSF HTML tags.
column
org.apache.myfaces.taglib.html.HtmlColumnTag
JSP
This tag is commonly used as a child of the dataTable tag, to
represent a column of data. It can be decorated with "header" and
"footer" facets to drive the output of header and footer rows.
Row values are specified via its children.
Unless otherwise specified, all attributes accept static values
or EL expressions.
id
false
false
java.lang.String
The developer-assigned ID of this component. The ID must be unique
within the scope of the tag's enclosing naming container (e.g.
h:form or f:subview). This value must be a static value.
binding
false
false
java.lang.String
Identifies a backing bean property (of type UIComponent or appropriate
subclass) to bind to this component instance. This value must be an
EL expression.
rendered
false
false
java.lang.String
A boolean value that indicates whether this component should be rendered.
Default value: true.
commandButton
org.apache.myfaces.taglib.html.HtmlCommandButtonTag
JSP
This tag renders as an HTML input element.
Unless otherwise specified, all attributes accept static values
or EL expressions.
id
false
false
java.lang.String
The developer-assigned ID of this component. The ID must be unique
within the scope of the tag's enclosing naming container (e.g.
h:form or f:subview). This value must be a static value.
binding
false
false
java.lang.String
Identifies a backing bean property (of type UIComponent or appropriate
subclass) to bind to this component instance. This value must be an
EL expression.
rendered
false
false
java.lang.String
A boolean value that indicates whether this component should be rendered.
Default value: true.
action
false
false
java.lang.String
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.
actionListener
false
false
java.lang.String
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.
immediate
false
false
java.lang.String
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.
value
false
false
java.lang.String
The initial value of this component.
dir
false
false
HTML: The direction of text display, either 'ltr' (left-to-right) or 'rtl' (right-to-left).
lang
false
false
HTML: The base language of this document.
style
false
false
HTML: CSS styling instructions.
title
false
false
HTML: An advisory title for this element. Often used by the user agent as a tooltip.
styleClass
false
false
The CSS class for this element. Corresponds to the HTML 'class' attribute.
readonly
false
false
java.lang.String
HTML: When true, indicates that this component cannot be modified by the user.
The element may receive focus unless it has also been disabled.
onclick
false
false
HTML: Script to be invoked when the element is clicked.
ondblclick
false
false
HTML: Script to be invoked when the element is double-clicked.
onmousedown
false
false
HTML: Script to be invoked when the pointing device is pressed over this element.
onmouseup
false
false
HTML: Script to be invoked when the pointing device is released over this element.
onmouseover
false
false
HTML: Script to be invoked when the pointing device is moved into this element.
onmousemove
false
false
HTML: Script to be invoked when the pointing device is moved while it is in this element.
onmouseout
false
false
HTML: Script to be invoked when the pointing device is moves out of this element.
onkeypress
false
false
HTML: Script to be invoked when a key is pressed over this element.
onkeydown
false
false
HTML: Script to be invoked when a key is pressed down over this element.
onkeyup
false
false
HTML: Script to be invoked when a key is released over this element.
accesskey
false
false
java.lang.String
HTML: Sets the access key for this element.
alt
false
false
java.lang.String
HTML: Specifies alternative text that can be used by a browser that can't show this element.
disabled
false
false
java.lang.String
HTML: When true, this element cannot receive focus.
onblur
false
false
java.lang.String
HTML: Specifies a script to be invoked when the element loses focus.
onfocus
false
false
java.lang.String
HTML: Specifies a script to be invoked when the element receives focus.
onselect
false
false
java.lang.String
HTML: Specifies a script to be invoked when the element is selected.
onchange
false
false
java.lang.String
HTML: Specifies a script to be invoked when the element is modified.
tabindex
false
false
java.lang.String
HTML: Specifies the position of this element within the tab order of the document.
type
false
false
java.lang.String
HTML: A hint to the user agent about the content type of the linked resource.
size
false
false
java.lang.String
The initial width of this control.
image
false
false
HTML: The URL of an image that renders in place of the button.
commandLink
org.apache.myfaces.taglib.html.HtmlCommandLinkTag
JSP
This tag renders as an HTML a element.
Unless otherwise specified, all attributes accept static values
or EL expressions.
id
false
false
java.lang.String
The developer-assigned ID of this component. The ID must be unique
within the scope of the tag's enclosing naming container (e.g.
h:form or f:subview). This value must be a static value.
binding
false
false
java.lang.String
Identifies a backing bean property (of type UIComponent or appropriate
subclass) to bind to this component instance. This value must be an
EL expression.
rendered
false
false
java.lang.String
A boolean value that indicates whether this component should be rendered.
Default value: true.
action
false
false
java.lang.String
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.
actionListener
false
false
java.lang.String
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.
immediate
false
false
java.lang.String
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.
value
false
false
java.lang.String
The initial value of this component.
dir
false
false
HTML: The direction of text display, either 'ltr' (left-to-right) or 'rtl' (right-to-left).
lang
false
false
HTML: The base language of this document.
style
false
false
HTML: CSS styling instructions.
title
false
false
HTML: An advisory title for this element. Often used by the user agent as a tooltip.
styleClass
false
false
The CSS class for this element. Corresponds to the HTML 'class' attribute.
onclick
false
false
HTML: Script to be invoked when the element is clicked.
ondblclick
false
false
HTML: Script to be invoked when the element is double-clicked.
onmousedown
false
false
HTML: Script to be invoked when the pointing device is pressed over this element.
onmouseup
false
false
HTML: Script to be invoked when the pointing device is released over this element.
onmouseover
false
false
HTML: Script to be invoked when the pointing device is moved into this element.
onmousemove
false
false
HTML: Script to be invoked when the pointing device is moved while it is in this element.
onmouseout
false
false
HTML: Script to be invoked when the pointing device is moves out of this element.
onkeypress
false
false
HTML: Script to be invoked when a key is pressed over this element.
onkeydown
false
false
HTML: Script to be invoked when a key is pressed down over this element.
onkeyup
false
false
HTML: Script to be invoked when a key is released over this element.
accesskey
false
false
java.lang.String
HTML: Sets the access key for this element.
charset
false
false
java.lang.String
HTML: Specifies the character encoding of the linked resource.
tabindex
false
false
java.lang.String
HTML: Specifies the position of this element within the tab order of the document.
onblur
false
false
java.lang.String
HTML: Specifies a script to be invoked when the element loses focus.
onfocus
false
false
java.lang.String
HTML: Specifies a script to be invoked when the element receives focus.
type
false
false
java.lang.String
HTML: A hint to the user agent about the content type of the linked resource.
target
false
false
HTML: Names the frame that should display content generated by invoking this action.
coords
false
false
java.lang.String
HTML: The coordinates of regions within a client side image map.
hreflang
false
false
java.lang.String
HTML: The language of the linked resource.
rel
false
false
java.lang.String
HTML: The relationship between the current document and
the linked resource.
rev
false
false
java.lang.String
HTML: The type(s) describing the reverse link for the linked
resource.
shape
false
false
java.lang.String
HTML: The shape of a region in a client side image map.
dataTable
org.apache.myfaces.taglib.html.HtmlDataTableTag
JSP
This component renders as an HTML table element. It has as its
children h:column entities, which describe the columns of the table.
It can be decorated with facets named "header" and "footer" to
specify header and footer rows.
Unless otherwise specified, all attributes accept static values
or EL expressions.
id
false
false
java.lang.String
The developer-assigned ID of this component. The ID must be unique
within the scope of the tag's enclosing naming container (e.g.
h:form or f:subview). This value must be a static value.
binding
false
false
java.lang.String
Identifies a backing bean property (of type UIComponent or appropriate
subclass) to bind to this component instance. This value must be an
EL expression.
rendered
false
false
java.lang.String
A boolean value that indicates whether this component should be rendered.
Default value: true.
columnClasses
false
false
A comma separated list of CSS class names to apply to td elements in
each column.
footerClass
false
false
The CSS class to be applied to footer cells.
headerClass
false
false
The CSS class to be applied to header cells.
rowClasses
false
false
A comma separated list of CSS class names to apply to td elements in
each row.
dir
false
false
HTML: The direction of text display, either 'ltr' (left-to-right) or 'rtl' (right-to-left).
lang
false
false
HTML: The base language of this document.
style
false
false
HTML: CSS styling instructions.
title
false
false
HTML: An advisory title for this element. Often used by the user agent as a tooltip.
styleClass
false
false
The CSS class for this element. Corresponds to the HTML 'class' attribute.
onclick
false
false
HTML: Script to be invoked when the element is clicked.
ondblclick
false
false
HTML: Script to be invoked when the element is double-clicked.
onmousedown
false
false
HTML: Script to be invoked when the pointing device is pressed over this element.
onmouseup
false
false
HTML: Script to be invoked when the pointing device is released over this element.
onmouseover
false
false
HTML: Script to be invoked when the pointing device is moved into this element.
onmousemove
false
false
HTML: Script to be invoked when the pointing device is moved while it is in this element.
onmouseout
false
false
HTML: Script to be invoked when the pointing device is moves out of this element.
onkeypress
false
false
HTML: Script to be invoked when a key is pressed over this element.
onkeydown
false
false
HTML: Script to be invoked when a key is pressed down over this element.
onkeyup
false
false
HTML: Script to be invoked when a key is released over this element.
align
false
false
HTML: Specifies the horizontal alignment of this element. Deprecated in HTML 4.01.
border
false
false
java.lang.String
HTML: Specifies the width of the border of this element, in pixels. Deprecated in HTML 4.01.
bgcolor
false
false
HTML: The background color of this element.
datafld
false
false
Reserved for future use.
datasrc
false
false
Reserved for future use.
dataformatas
false
false
Reserved for future use.
cellpadding
false
false
HTML: Specifies the amount of empty space between the cell border and
its contents. It can be either a pixel length or a percentage.
cellspacing
false
false
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.
frame
false
false
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.
rules
false
false
HTML: Controls how rules are rendered between cells. Values include:
none, groups, rows, cols, and all.
summary
false
false
HTML: Provides a summary of the contents of the table, for
accessibility purposes.
width
false
false
HTML: Specifies the desired width of the table, as a pixel length or
a percentage of available space.
value
false
false
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.
var
true
false
Defines the name of the request-scope variable that will hold the current row during iteration. This value must be a static value.
rows
false
false
The number of rows to be displayed. Specify zero for all remaining rows in the table.
first
false
false
The index of the first row to be displayed, where 0 is the first row.
form
org.apache.myfaces.taglib.html.HtmlFormTag
JSP
Renders an HTML form element.
Unless otherwise specified, all attributes accept static values
or EL expressions.
id
false
false
java.lang.String
The developer-assigned ID of this component. The ID must be unique
within the scope of the tag's enclosing naming container (e.g.
h:form or f:subview). This value must be a static value.
binding
false
false
java.lang.String
Identifies a backing bean property (of type UIComponent or appropriate
subclass) to bind to this component instance. This value must be an
EL expression.
rendered
false
false
java.lang.String
A boolean value that indicates whether this component should be rendered.
Default value: true.
dir
false
false
HTML: The direction of text display, either 'ltr' (left-to-right) or 'rtl' (right-to-left).
lang
false
false
HTML: The base language of this document.
style
false
false
HTML: CSS styling instructions.
title
false
false
HTML: An advisory title for this element. Often used by the user agent as a tooltip.
styleClass
false
false
The CSS class for this element. Corresponds to the HTML 'class' attribute.
onclick
false
false
HTML: Script to be invoked when the element is clicked.
ondblclick
false
false
HTML: Script to be invoked when the element is double-clicked.
onmousedown
false
false
HTML: Script to be invoked when the pointing device is pressed over this element.
onmouseup
false
false
HTML: Script to be invoked when the pointing device is released over this element.
onmouseover
false
false
HTML: Script to be invoked when the pointing device is moved into this element.
onmousemove
false
false
HTML: Script to be invoked when the pointing device is moved while it is in this element.
onmouseout
false
false
HTML: Script to be invoked when the pointing device is moves out of this element.
onkeypress
false
false
HTML: Script to be invoked when a key is pressed over this element.
onkeydown
false
false
HTML: Script to be invoked when a key is pressed down over this element.
onkeyup
false
false
HTML: Script to be invoked when a key is released over this element.
target
false
false
HTML: Names the frame that should display content generated by invoking this action.
accept
false
false
HTML: Provides a comma-separated list of content types that the
server processing this form can handle.
acceptcharset
false
false
HTML: The list of character encodings accepted by the server for this
form.
enctype
false
false
HTML: The content type used to submit this form to the server.
onreset
false
false
HTML: Script to be invoked when this form is reset.
onsubmit
false
false
HTML: Script to be invoked when this form is submitted.
graphicImage
org.apache.myfaces.taglib.html.HtmlGraphicImageTag
JSP
Renders an HTML img element.
Unless otherwise specified, all attributes accept static values
or EL expressions.
id
false
false
java.lang.String
The developer-assigned ID of this component. The ID must be unique
within the scope of the tag's enclosing naming container (e.g.
h:form or f:subview). This value must be a static value.
binding
false
false
java.lang.String
Identifies a backing bean property (of type UIComponent or appropriate
subclass) to bind to this component instance. This value must be an
EL expression.
rendered
false
false
java.lang.String
A boolean value that indicates whether this component should be rendered.
Default value: true.
url
false
false
java.lang.String
An alias for the "value" attribute.
value
false
false
java.lang.String
The URL of the image. If the URL starts with a '/', it is relative
to the context path of the web application.
dir
false
false
HTML: The direction of text display, either 'ltr' (left-to-right) or 'rtl' (right-to-left).
lang
false
false
HTML: The base language of this document.
style
false
false
HTML: CSS styling instructions.
title
false
false
HTML: An advisory title for this element. Often used by the user agent as a tooltip.
styleClass
false
false
The CSS class for this element. Corresponds to the HTML 'class' attribute.
onclick
false
false
HTML: Script to be invoked when the element is clicked.
ondblclick
false
false
HTML: Script to be invoked when the element is double-clicked.
onmousedown
false
false
HTML: Script to be invoked when the pointing device is pressed over this element.
onmouseup
false
false
HTML: Script to be invoked when the pointing device is released over this element.
onmouseover
false
false
HTML: Script to be invoked when the pointing device is moved into this element.
onmousemove
false
false
HTML: Script to be invoked when the pointing device is moved while it is in this element.
onmouseout
false
false
HTML: Script to be invoked when the pointing device is moves out of this element.
onkeypress
false
false
HTML: Script to be invoked when a key is pressed over this element.
onkeydown
false
false
HTML: Script to be invoked when a key is pressed down over this element.
onkeyup
false
false
HTML: Script to be invoked when a key is released over this element.
alt
false
false
java.lang.String
HTML: Specifies alternative text that can be used by a browser that can't show this element.
height
false
false
java.lang.String
HTML: Overrides the natural height of this image, by specifying height in pixels.
ismap
false
false
java.lang.String
HTML: Specifies server-side image map handling for this image.
longdesc
false
false
java.lang.String
HTML: A link to a long description of the image.
usemap
false
false
java.lang.String
HTML: Specifies an image map to use with this image.
width
false
false
java.lang.String
HTML: Overrides the natural width of this image, by specifying width in pixels.
inputHidden
org.apache.myfaces.taglib.html.HtmlInputHiddenTag
JSP
Renders as an HTML input tag with its type set to "hidden".
Unless otherwise specified, all attributes accept static values
or EL expressions.
id
false
false
java.lang.String
The developer-assigned ID of this component. The ID must be unique
within the scope of the tag's enclosing naming container (e.g.
h:form or f:subview). This value must be a static value.
binding
false
false
java.lang.String
Identifies a backing bean property (of type UIComponent or appropriate
subclass) to bind to this component instance. This value must be an
EL expression.
rendered
false
false
java.lang.String
A boolean value that indicates whether this component should be rendered.
Default value: true.
value
false
false
java.lang.String
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
converter
false
false
java.lang.String
An expression that specifies the Converter for this component.
If the value binding expression is a String, the String is used
as an ID to look up a Converter. If the value binding expression
is a Converter, uses that instance as the converter.
The value can either be a static value (ID case only) or an EL expression.
immediate
false
false
java.lang.String
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.
required
false
false
java.lang.String
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.
validator
false
false
java.lang.String
A method binding EL expression, accepting FacesContext, UIComponent,
and Object parameters, and returning void, that validates the
component's local value.
valueChangeListener
false
false
java.lang.String
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.
inputSecret
org.apache.myfaces.taglib.html.HtmlInputSecretTag
JSP
Renders as an HTML input tag with its type set to "password".
Unless otherwise specified, all attributes accept static values
or EL expressions.
id
false
false
java.lang.String
The developer-assigned ID of this component. The ID must be unique
within the scope of the tag's enclosing naming container (e.g.
h:form or f:subview). This value must be a static value.
binding
false
false
java.lang.String
Identifies a backing bean property (of type UIComponent or appropriate
subclass) to bind to this component instance. This value must be an
EL expression.
rendered
false
false
java.lang.String
A boolean value that indicates whether this component should be rendered.
Default value: true.
value
false
false
java.lang.String
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
converter
false
false
java.lang.String
An expression that specifies the Converter for this component.
If the value binding expression is a String, the String is used
as an ID to look up a Converter. If the value binding expression
is a Converter, uses that instance as the converter.
The value can either be a static value (ID case only) or an EL expression.
immediate
false
false
java.lang.String
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.
required
false
false
java.lang.String
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.
validator
false
false
java.lang.String
A method binding EL expression, accepting FacesContext, UIComponent,
and Object parameters, and returning void, that validates the
component's local value.
valueChangeListener
false
false
java.lang.String
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.
accesskey
false
false
java.lang.String
HTML: Sets the access key for this element.
align
false
false
HTML: Specifies the horizontal alignment of this element. Deprecated in HTML 4.01.
alt
false
false
java.lang.String
HTML: Specifies alternative text that can be used by a browser that can't show this element.
disabled
false
false
java.lang.String
HTML: When true, this element cannot receive focus.
onblur
false
false
java.lang.String
HTML: Specifies a script to be invoked when the element loses focus.
onfocus
false
false
java.lang.String
HTML: Specifies a script to be invoked when the element receives focus.
onchange
false
false
java.lang.String
HTML: Specifies a script to be invoked when the element is modified.
onselect
false
false
java.lang.String
HTML: Specifies a script to be invoked when the element is selected.
readonly
false
false
java.lang.String
HTML: When true, indicates that this component cannot be modified by the user.
The element may receive focus unless it has also been disabled.
tabindex
false
false
java.lang.String
HTML: Specifies the position of this element within the tab order of the document.
maxlength
false
false
java.lang.String
HTML: The maximum number of characters allowed to be entered.
size
false
false
java.lang.String
HTML: The initial width of this control, in characters.
dir
false
false
HTML: The direction of text display, either 'ltr' (left-to-right) or 'rtl' (right-to-left).
lang
false
false
HTML: The base language of this document.
style
false
false
HTML: CSS styling instructions.
title
false
false
HTML: An advisory title for this element. Often used by the user agent as a tooltip.
styleClass
false
false
The CSS class for this element. Corresponds to the HTML 'class' attribute.
onclick
false
false
HTML: Script to be invoked when the element is clicked.
ondblclick
false
false
HTML: Script to be invoked when the element is double-clicked.
onmousedown
false
false
HTML: Script to be invoked when the pointing device is pressed over this element.
onmouseup
false
false
HTML: Script to be invoked when the pointing device is released over this element.
onmouseover
false
false
HTML: Script to be invoked when the pointing device is moved into this element.
onmousemove
false
false
HTML: Script to be invoked when the pointing device is moved while it is in this element.
onmouseout
false
false
HTML: Script to be invoked when the pointing device is moves out of this element.
onkeypress
false
false
HTML: Script to be invoked when a key is pressed over this element.
onkeydown
false
false
HTML: Script to be invoked when a key is pressed down over this element.
onkeyup
false
false
HTML: Script to be invoked when a key is released over this element.
redisplay
false
false
If true, the value will be re-sent (in plaintext) when the form
is rerendered (see JSF.7.4.4). Default is false.
inputText
org.apache.myfaces.taglib.html.HtmlInputTextTag
JSP
Renders a HTML input element.
Unless otherwise specified, all attributes accept static values
or EL expressions.
id
false
false
java.lang.String
The developer-assigned ID of this component. The ID must be unique
within the scope of the tag's enclosing naming container (e.g.
h:form or f:subview). This value must be a static value.
binding
false
false
java.lang.String
Identifies a backing bean property (of type UIComponent or appropriate
subclass) to bind to this component instance. This value must be an
EL expression.
rendered
false
false
java.lang.String
A boolean value that indicates whether this component should be rendered.
Default value: true.
value
false
false
java.lang.String
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
converter
false
false
java.lang.String
An expression that specifies the Converter for this component.
If the value binding expression is a String, the String is used
as an ID to look up a Converter. If the value binding expression
is a Converter, uses that instance as the converter.
The value can either be a static value (ID case only) or an EL expression.
immediate
false
false
java.lang.String
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.
required
false
false
java.lang.String
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.
validator
false
false
java.lang.String
A method binding EL expression, accepting FacesContext, UIComponent,
and Object parameters, and returning void, that validates the
component's local value.
valueChangeListener
false
false
java.lang.String
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.
dir
false
false
HTML: The direction of text display, either 'ltr' (left-to-right) or 'rtl' (right-to-left).
lang
false
false
HTML: The base language of this document.
style
false
false
HTML: CSS styling instructions.
title
false
false
HTML: An advisory title for this element. Often used by the user agent as a tooltip.
styleClass
false
false
The CSS class for this element. Corresponds to the HTML 'class' attribute.
onclick
false
false
HTML: Script to be invoked when the element is clicked.
ondblclick
false
false
HTML: Script to be invoked when the element is double-clicked.
onmousedown
false
false
HTML: Script to be invoked when the pointing device is pressed over this element.
onmouseup
false
false
HTML: Script to be invoked when the pointing device is released over this element.
onmouseover
false
false
HTML: Script to be invoked when the pointing device is moved into this element.
onmousemove
false
false
HTML: Script to be invoked when the pointing device is moved while it is in this element.
onmouseout
false
false
HTML: Script to be invoked when the pointing device is moves out of this element.
onkeypress
false
false
HTML: Script to be invoked when a key is pressed over this element.
onkeydown
false
false
HTML: Script to be invoked when a key is pressed down over this element.
onkeyup
false
false
HTML: Script to be invoked when a key is released over this element.
accesskey
false
false
java.lang.String
HTML: Sets the access key for this element.
align
false
false
HTML: Specifies the horizontal alignment of this element. Deprecated in HTML 4.01.
alt
false
false
java.lang.String
HTML: Specifies alternative text that can be used by a browser that can't show this element.
disabled
false
false
java.lang.String
HTML: When true, this element cannot receive focus.
onblur
false
false
java.lang.String
HTML: Specifies a script to be invoked when the element loses focus.
onfocus
false
false
java.lang.String
HTML: Specifies a script to be invoked when the element receives focus.
onchange
false
false
java.lang.String
HTML: Specifies a script to be invoked when the element is modified.
onselect
false
false
java.lang.String
HTML: Specifies a script to be invoked when the element is selected.
readonly
false
false
java.lang.String
HTML: When true, indicates that this component cannot be modified by the user.
The element may receive focus unless it has also been disabled.
tabindex
false
false
java.lang.String
HTML: Specifies the position of this element within the tab order of the document.
maxlength
false
false
java.lang.String
HTML: The maximum number of characters allowed to be entered.
size
false
false
java.lang.String
HTML: The initial width of this control, in characters.
inputTextarea
org.apache.myfaces.taglib.html.HtmlInputTextareaTag
JSP
Renders a HTML textarea element.
Unless otherwise specified, all attributes accept static values
or EL expressions.
id
false
false
java.lang.String
The developer-assigned ID of this component. The ID must be unique
within the scope of the tag's enclosing naming container (e.g.
h:form or f:subview). This value must be a static value.
binding
false
false
java.lang.String
Identifies a backing bean property (of type UIComponent or appropriate
subclass) to bind to this component instance. This value must be an
EL expression.
rendered
false
false
java.lang.String
A boolean value that indicates whether this component should be rendered.
Default value: true.
value
false
false
java.lang.String
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
converter
false
false
java.lang.String
An expression that specifies the Converter for this component.
If the value binding expression is a String, the String is used
as an ID to look up a Converter. If the value binding expression
is a Converter, uses that instance as the converter.
The value can either be a static value (ID case only) or an EL expression.
immediate
false
false
java.lang.String
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.
required
false
false
java.lang.String
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.
validator
false
false
java.lang.String
A method binding EL expression, accepting FacesContext, UIComponent,
and Object parameters, and returning void, that validates the
component's local value.
valueChangeListener
false
false
java.lang.String
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.
datafld
false
false
Reserved for future use.
datasrc
false
false
Reserved for future use.
dataformatas
false
false
Reserved for future use.
accesskey
false
false
java.lang.String
HTML: Sets the access key for this element.
disabled
false
false
java.lang.String
HTML: When true, this element cannot receive focus.
onblur
false
false
java.lang.String
HTML: Specifies a script to be invoked when the element loses focus.
onfocus
false
false
java.lang.String
HTML: Specifies a script to be invoked when the element receives focus.
onchange
false
false
java.lang.String
HTML: Specifies a script to be invoked when the element is modified.
onselect
false
false
java.lang.String
HTML: Specifies a script to be invoked when the element is selected.
tabindex
false
false
java.lang.String
HTML: Specifies the position of this element within the tab order of the document.
readonly
false
false
java.lang.String
HTML: When true, indicates that this component cannot be modified by the user.
The element may receive focus unless it has also been disabled.
cols
false
false
java.lang.String
HTML: The width of this element, in characters.
rows
false
false
java.lang.String
HTML: The height of this element, in characters.
dir
false
false
HTML: The direction of text display, either 'ltr' (left-to-right) or 'rtl' (right-to-left).
lang
false
false
HTML: The base language of this document.
style
false
false
HTML: CSS styling instructions.
title
false
false
HTML: An advisory title for this element. Often used by the user agent as a tooltip.
styleClass
false
false
The CSS class for this element. Corresponds to the HTML 'class' attribute.
onclick
false
false
HTML: Script to be invoked when the element is clicked.
ondblclick
false
false
HTML: Script to be invoked when the element is double-clicked.
onmousedown
false
false
HTML: Script to be invoked when the pointing device is pressed over this element.
onmouseup
false
false
HTML: Script to be invoked when the pointing device is released over this element.
onmouseover
false
false
HTML: Script to be invoked when the pointing device is moved into this element.
onmousemove
false
false
HTML: Script to be invoked when the pointing device is moved while it is in this element.
onmouseout
false
false
HTML: Script to be invoked when the pointing device is moves out of this element.
onkeypress
false
false
HTML: Script to be invoked when a key is pressed over this element.
onkeydown
false
false
HTML: Script to be invoked when a key is pressed down over this element.
onkeyup
false
false
HTML: Script to be invoked when a key is released over this element.
message
org.apache.myfaces.taglib.html.HtmlMessageTag
JSP
Renders the first FacesMessage that is assigned to the component
referenced by the "for" attribute.
Unless otherwise specified, all attributes accept static values
or EL expressions.
id
false
false
java.lang.String
The developer-assigned ID of this component. The ID must be unique
within the scope of the tag's enclosing naming container (e.g.
h:form or f:subview). This value must be a static value.
binding
false
false
java.lang.String
Identifies a backing bean property (of type UIComponent or appropriate
subclass) to bind to this component instance. This value must be an
EL expression.
rendered
false
false
java.lang.String
A boolean value that indicates whether this component should be rendered.
Default value: true.
for
true
false
java.lang.String
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.
showSummary
false
false
java.lang.String
An EL expression, returning a boolean, that controls whether the
summary text of the associated messages is displayed. Default: true.
showDetail
false
false
java.lang.String
An EL expression, returning a boolean, that controls whether the
detail text of the associated messages is displayed. Default: false.
dir
false
false
HTML: The direction of text display, either 'ltr' (left-to-right) or 'rtl' (right-to-left).
lang
false
false
HTML: The base language of this document.
style
false
false
HTML: CSS styling instructions.
title
false
false
HTML: An advisory title for this element. Often used by the user agent as a tooltip.
styleClass
false
false
The CSS class for this element. Corresponds to the HTML 'class' attribute.
onclick
false
false
HTML: Script to be invoked when the element is clicked.
ondblclick
false
false
HTML: Script to be invoked when the element is double-clicked.
onmousedown
false
false
HTML: Script to be invoked when the pointing device is pressed over this element.
onmouseup
false
false
HTML: Script to be invoked when the pointing device is released over this element.
onmouseover
false
false
HTML: Script to be invoked when the pointing device is moved into this element.
onmousemove
false
false
HTML: Script to be invoked when the pointing device is moved while it is in this element.
onmouseout
false
false
HTML: Script to be invoked when the pointing device is moves out of this element.
onkeypress
false
false
HTML: Script to be invoked when a key is pressed over this element.
onkeydown
false
false
HTML: Script to be invoked when a key is pressed down over this element.
onkeyup
false
false
HTML: Script to be invoked when a key is released over this element.
infoClass
false
false
CSS class to be used for messages with severity "INFO".
infoStyle
false
false
CSS style to be used for messages with severity "INFO".
warnClass
false
false
CSS class to be used for messages with severity "WARN".
warnStyle
false
false
CSS style to be used for messages with severity "WARN".
errorClass
false
false
CSS class to be used for messages with severity "ERROR".
errorStyle
false
false
CSS style to be used for messages with severity "ERROR".
fatalClass
false
false
CSS class to be used for messages with severity "FATAL".
fatalStyle
false
false
CSS style to be used for messages with severity "FATAL".
tooltip
false
false
If true, the message summary will be rendered as a tooltip (i.e. HTML title attribute).
messages
org.apache.myfaces.taglib.html.HtmlMessagesTag
JSP
Renders all or some FacesMessages depending on the "for" and
"globalOnly" attributes:<br>
<ul>
<li>If globalOnly = true, only global messages, that have no
associated clientId, will be displayed.</li>
<li>else if there is a "for" attribute, only messages that are
assigned to the component referenced by the "for" attribute
are displayed.</li>
<li>else all messages are displayed.</li>
</ul>
Unless otherwise specified, all attributes accept static values
or EL expressions.
id
false
false
java.lang.String
The developer-assigned ID of this component. The ID must be unique
within the scope of the tag's enclosing naming container (e.g.
h:form or f:subview). This value must be a static value.
binding
false
false
java.lang.String
Identifies a backing bean property (of type UIComponent or appropriate
subclass) to bind to this component instance. This value must be an
EL expression.
rendered
false
false
java.lang.String
A boolean value that indicates whether this component should be rendered.
Default value: true.
showSummary
false
false
java.lang.String
A boolean value that controls whether the summary text of the
associated messages is displayed. Default: true.
showDetail
false
false
java.lang.String
A boolean value that controls whether the detail text of the
associated messages is displayed. Default: false.
globalOnly
false
false
java.lang.String
A boolean value that controls whether global messages (those without
IDs) should be displayed. Default: true.
dir
false
false
HTML: The direction of text display, either 'ltr' (left-to-right) or 'rtl' (right-to-left).
lang
false
false
HTML: The base language of this document.
style
false
false
HTML: CSS styling instructions.
title
false
false
HTML: An advisory title for this element. Often used by the user agent as a tooltip.
styleClass
false
false
The CSS class for this element. Corresponds to the HTML 'class' attribute.
onclick
false
false
HTML: Script to be invoked when the element is clicked.
ondblclick
false
false
HTML: Script to be invoked when the element is double-clicked.
onmousedown
false
false
HTML: Script to be invoked when the pointing device is pressed over this element.
onmouseup
false
false
HTML: Script to be invoked when the pointing device is released over this element.
onmouseover
false
false
HTML: Script to be invoked when the pointing device is moved into this element.
onmousemove
false
false
HTML: Script to be invoked when the pointing device is moved while it is in this element.
onmouseout
false
false
HTML: Script to be invoked when the pointing device is moves out of this element.
onkeypress
false
false
HTML: Script to be invoked when a key is pressed over this element.
onkeydown
false
false
HTML: Script to be invoked when a key is pressed down over this element.
onkeyup
false
false
HTML: Script to be invoked when a key is released over this element.
infoClass
false
false
CSS class to be used for messages with severity "INFO".
infoStyle
false
false
CSS style to be used for messages with severity "INFO".
warnClass
false
false
CSS class to be used for messages with severity "WARN".
warnStyle
false
false
CSS style to be used for messages with severity "WARN".
errorClass
false
false
CSS class to be used for messages with severity "ERROR".
errorStyle
false
false
CSS style to be used for messages with severity "ERROR".
fatalClass
false
false
CSS class to be used for messages with severity "FATAL".
fatalStyle
false
false
CSS style to be used for messages with severity "FATAL".
layout
false
false
The layout: "table" or "list". Default: list
tooltip
false
false
If true, the message summary will be rendered as a tooltip (i.e. HTML title attribute).
outputLabel
org.apache.myfaces.taglib.html.HtmlOutputLabelTag
JSP
Renders a HTML label element.
In addition to the JSF specification, MyFaces allows it to directly
give an output text via the "value" attribute.
Unless otherwise specified, all attributes accept static values
or EL expressions.
id
false
false
java.lang.String
The developer-assigned ID of this component. The ID must be unique
within the scope of the tag's enclosing naming container (e.g.
h:form or f:subview). This value must be a static value.
binding
false
false
java.lang.String
Identifies a backing bean property (of type UIComponent or appropriate
subclass) to bind to this component instance. This value must be an
EL expression.
rendered
false
false
java.lang.String
A boolean value that indicates whether this component should be rendered.
Default value: true.
value
false
false
java.lang.String
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
converter
false
false
java.lang.String
An expression that specifies the Converter for this component.
If the value binding expression is a String, the String is used
as an ID to look up a Converter. If the value binding expression
is a Converter, uses that instance as the converter.
The value can either be a static value (ID case only) or an EL expression.
dir
false
false
HTML: The direction of text display, either 'ltr' (left-to-right) or 'rtl' (right-to-left).
lang
false
false
HTML: The base language of this document.
style
false
false
HTML: CSS styling instructions.
title
false
false
HTML: An advisory title for this element. Often used by the user agent as a tooltip.
styleClass
false
false
The CSS class for this element. Corresponds to the HTML 'class' attribute.
tabindex
false
false
java.lang.String
HTML: Specifies the position of this element within the tab order of the document.
onclick
false
false
HTML: Script to be invoked when the element is clicked.
ondblclick
false
false
HTML: Script to be invoked when the element is double-clicked.
onmousedown
false
false
HTML: Script to be invoked when the pointing device is pressed over this element.
onmouseup
false
false
HTML: Script to be invoked when the pointing device is released over this element.
onmouseover
false
false
HTML: Script to be invoked when the pointing device is moved into this element.
onmousemove
false
false
HTML: Script to be invoked when the pointing device is moved while it is in this element.
onmouseout
false
false
HTML: Script to be invoked when the pointing device is moves out of this element.
onkeypress
false
false
HTML: Script to be invoked when a key is pressed over this element.
onkeydown
false
false
HTML: Script to be invoked when a key is pressed down over this element.
onkeyup
false
false
HTML: Script to be invoked when a key is released over this element.
accesskey
false
false
java.lang.String
HTML: Sets the access key for this element.
onblur
false
false
java.lang.String
HTML: Specifies a script to be invoked when the element loses focus.
onfocus
false
false
java.lang.String
HTML: Specifies a script to be invoked when the element receives focus.
for
false
false
The client ID of the target input element of this label.
outputLink
org.apache.myfaces.taglib.html.HtmlOutputLinkTag
JSP
Renders a HTML a element. Child f:param elements are added to the href
attribute as query parameters. Other children are rendered as the link text or image.
Unless otherwise specified, all attributes accept static values
or EL expressions.
id
false
false
java.lang.String
The developer-assigned ID of this component. The ID must be unique
within the scope of the tag's enclosing naming container (e.g.
h:form or f:subview). This value must be a static value.
binding
false
false
java.lang.String
Identifies a backing bean property (of type UIComponent or appropriate
subclass) to bind to this component instance. This value must be an
EL expression.
rendered
false
false
java.lang.String
A boolean value that indicates whether this component should be rendered.
Default value: true.
value
false
false
java.lang.String
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
converter
false
false
java.lang.String
An expression that specifies the Converter for this component.
If the value binding expression is a String, the String is used
as an ID to look up a Converter. If the value binding expression
is a Converter, uses that instance as the converter.
The value can either be a static value (ID case only) or an EL expression.
dir
false
false
HTML: The direction of text display, either 'ltr' (left-to-right) or 'rtl' (right-to-left).
lang
false
false
HTML: The base language of this document.
style
false
false
HTML: CSS styling instructions.
title
false
false
HTML: An advisory title for this element. Often used by the user agent as a tooltip.
styleClass
false
false
The CSS class for this element. Corresponds to the HTML 'class' attribute.
onclick
false
false
HTML: Script to be invoked when the element is clicked.
ondblclick
false
false
HTML: Script to be invoked when the element is double-clicked.
onmousedown
false
false
HTML: Script to be invoked when the pointing device is pressed over this element.
onmouseup
false
false
HTML: Script to be invoked when the pointing device is released over this element.
onmouseover
false
false
HTML: Script to be invoked when the pointing device is moved into this element.
onmousemove
false
false
HTML: Script to be invoked when the pointing device is moved while it is in this element.
onmouseout
false
false
HTML: Script to be invoked when the pointing device is moves out of this element.
onkeypress
false
false
HTML: Script to be invoked when a key is pressed over this element.
onkeydown
false
false
HTML: Script to be invoked when a key is pressed down over this element.
onkeyup
false
false
HTML: Script to be invoked when a key is released over this element.
accesskey
false
false
java.lang.String
HTML: Sets the access key for this element.
charset
false
false
java.lang.String
HTML: Specifies the character encoding of the linked resource.
tabindex
false
false
java.lang.String
HTML: Specifies the position of this element within the tab order of the document.
onblur
false
false
java.lang.String
HTML: Specifies a script to be invoked when the element loses focus.
onfocus
false
false
java.lang.String
HTML: Specifies a script to be invoked when the element receives focus.
type
false
false
java.lang.String
HTML: A hint to the user agent about the content type of the linked resource.
target
false
false
HTML: Names the frame that should display content generated by invoking this action.
coords
false
false
java.lang.String
HTML: The coordinates of regions within a client side image map.
hreflang
false
false
java.lang.String
HTML: The language of the linked resource.
rel
false
false
java.lang.String
HTML: The relationship between the current document and
the linked resource.
rev
false
false
java.lang.String
HTML: The type(s) describing the reverse link for the linked
resource.
shape
false
false
java.lang.String
HTML: The shape of a region in a client side image map.
outputFormat
org.apache.myfaces.taglib.html.HtmlOutputFormatTag
JSP
Renders as text, applying the child f:param values to the value
attribute as a MessageFormat string. If this element has an ID
or CSS style properties, the text is wrapped in a span element.
Unless otherwise specified, all attributes accept static values
or EL expressions.
id
false
false
java.lang.String
The developer-assigned ID of this component. The ID must be unique
within the scope of the tag's enclosing naming container (e.g.
h:form or f:subview). This value must be a static value.
binding
false
false
java.lang.String
Identifies a backing bean property (of type UIComponent or appropriate
subclass) to bind to this component instance. This value must be an
EL expression.
rendered
false
false
java.lang.String
A boolean value that indicates whether this component should be rendered.
Default value: true.
value
false
false
java.lang.String
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
converter
false
false
java.lang.String
An expression that specifies the Converter for this component.
If the value binding expression is a String, the String is used
as an ID to look up a Converter. If the value binding expression
is a Converter, uses that instance as the converter.
The value can either be a static value (ID case only) or an EL expression.
dir
false
false
HTML: The direction of text display, either 'ltr' (left-to-right) or 'rtl' (right-to-left).
lang
false
false
HTML: The base language of this document.
style
false
false
HTML: CSS styling instructions.
title
false
false
HTML: An advisory title for this element. Often used by the user agent as a tooltip.
styleClass
false
false
The CSS class for this element. Corresponds to the HTML 'class' attribute.
onclick
false
false
HTML: Script to be invoked when the element is clicked.
ondblclick
false
false
HTML: Script to be invoked when the element is double-clicked.
onmousedown
false
false
HTML: Script to be invoked when the pointing device is pressed over this element.
onmouseup
false
false
HTML: Script to be invoked when the pointing device is released over this element.
onmouseover
false
false
HTML: Script to be invoked when the pointing device is moved into this element.
onmousemove
false
false
HTML: Script to be invoked when the pointing device is moved while it is in this element.
onmouseout
false
false
HTML: Script to be invoked when the pointing device is moves out of this element.
onkeypress
false
false
HTML: Script to be invoked when a key is pressed over this element.
onkeydown
false
false
HTML: Script to be invoked when a key is pressed down over this element.
onkeyup
false
false
HTML: Script to be invoked when a key is released over this element.
escape
false
false
Indicates whether rendered markup should be escaped.
Default: true
outputText
org.apache.myfaces.taglib.html.HtmlOutputTextTag
JSP
Renders the value of the associated UIOutput component. If this
element has an ID or CSS style properties, the text is wrapped in
a span element.
Unless otherwise specified, all attributes accept static values
or EL expressions.
id
false
false
java.lang.String
The developer-assigned ID of this component. The ID must be unique
within the scope of the tag's enclosing naming container (e.g.
h:form or f:subview). This value must be a static value.
binding
false
false
java.lang.String
Identifies a backing bean property (of type UIComponent or appropriate
subclass) to bind to this component instance. This value must be an
EL expression.
rendered
false
false
java.lang.String
A boolean value that indicates whether this component should be rendered.
Default value: true.
value
false
false
java.lang.String
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
converter
false
false
java.lang.String
An expression that specifies the Converter for this component.
If the value binding expression is a String, the String is used
as an ID to look up a Converter. If the value binding expression
is a Converter, uses that instance as the converter.
The value can either be a static value (ID case only) or an EL expression.
dir
false
false
HTML: The direction of text display, either 'ltr' (left-to-right) or 'rtl' (right-to-left).
lang
false
false
HTML: The base language of this document.
style
false
false
HTML: CSS styling instructions.
title
false
false
HTML: An advisory title for this element. Often used by the user agent as a tooltip.
styleClass
false
false
The CSS class for this element. Corresponds to the HTML 'class' attribute.
onclick
false
false
HTML: Script to be invoked when the element is clicked.
ondblclick
false
false
HTML: Script to be invoked when the element is double-clicked.
onmousedown
false
false
HTML: Script to be invoked when the pointing device is pressed over this element.
onmouseup
false
false
HTML: Script to be invoked when the pointing device is released over this element.
onmouseover
false
false
HTML: Script to be invoked when the pointing device is moved into this element.
onmousemove
false
false
HTML: Script to be invoked when the pointing device is moved while it is in this element.
onmouseout
false
false
HTML: Script to be invoked when the pointing device is moves out of this element.
onkeypress
false
false
HTML: Script to be invoked when a key is pressed over this element.
onkeydown
false
false
HTML: Script to be invoked when a key is pressed down over this element.
onkeyup
false
false
HTML: Script to be invoked when a key is released over this element.
escape
false
false
Indicates whether rendered markup should be escaped.
Default: true
panelGrid
org.apache.myfaces.taglib.html.HtmlPanelGridTag
JSP
This element renders as an HTML table with specified number of
columns. Children of this element are rendered as cells in the
table, filling rows from left to right. Facets named "header"
and "footer" are optional and specify the content of the thead
and tfoot rows, respectively.
Unless otherwise specified, all attributes accept static values
or EL expressions.
id
false
false
java.lang.String
The developer-assigned ID of this component. The ID must be unique
within the scope of the tag's enclosing naming container (e.g.
h:form or f:subview). This value must be a static value.
binding
false
false
java.lang.String
Identifies a backing bean property (of type UIComponent or appropriate
subclass) to bind to this component instance. This value must be an
EL expression.
rendered
false
false
java.lang.String
A boolean value that indicates whether this component should be rendered.
Default value: true.
dir
false
false
HTML: The direction of text display, either 'ltr' (left-to-right) or 'rtl' (right-to-left).
lang
false
false
HTML: The base language of this document.
style
false
false
HTML: CSS styling instructions.
title
false
false
HTML: An advisory title for this element. Often used by the user agent as a tooltip.
styleClass
false
false
The CSS class for this element. Corresponds to the HTML 'class' attribute.
onclick
false
false
HTML: Script to be invoked when the element is clicked.
ondblclick
false
false
HTML: Script to be invoked when the element is double-clicked.
onmousedown
false
false
HTML: Script to be invoked when the pointing device is pressed over this element.
onmouseup
false
false
HTML: Script to be invoked when the pointing device is released over this element.
onmouseover
false
false
HTML: Script to be invoked when the pointing device is moved into this element.
onmousemove
false
false
HTML: Script to be invoked when the pointing device is moved while it is in this element.
onmouseout
false
false
HTML: Script to be invoked when the pointing device is moves out of this element.
onkeypress
false
false
HTML: Script to be invoked when a key is pressed over this element.
onkeydown
false
false
HTML: Script to be invoked when a key is pressed down over this element.
onkeyup
false
false
HTML: Script to be invoked when a key is released over this element.
align
false
false
HTML: Specifies the horizontal alignment of this element. Deprecated in HTML 4.01.
border
false
false
java.lang.String
HTML: Specifies the width of the border of this element, in pixels. Deprecated in HTML 4.01.
bgcolor
false
false
HTML: The background color of this element.
datafld
false
false
Reserved for future use.
datasrc
false
false
Reserved for future use.
dataformatas
false
false
Reserved for future use.
cellpadding
false
false
HTML: Specifies the amount of empty space between the cell border and
its contents. It can be either a pixel length or a percentage.
cellspacing
false
false
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.
frame
false
false
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.
rules
false
false
HTML: Controls how rules are rendered between cells. Values include:
none, groups, rows, cols, and all.
summary
false
false
HTML: Provides a summary of the contents of the table, for
accessibility purposes.
width
false
false
HTML: Specifies the desired width of the table, as a pixel length or
a percentage of available space.
columnClasses
false
false
A comma separated list of CSS class names to apply to td elements in
each column.
footerClass
false
false
The CSS class to be applied to footer cells.
headerClass
false
false
The CSS class to be applied to header cells.
rowClasses
false
false
A comma separated list of CSS class names to apply to td elements in
each row.
columns
false
false
Specifies the number of columns in the grid.
panelGroup
org.apache.myfaces.taglib.html.HtmlPanelGroupTag
JSP
This element is used to group other components where the
specification requires one child element. If any of the HTML or
CSS attributes are set, its content is rendered within a span element.
Unless otherwise specified, all attributes accept static values
or EL expressions.
id
false
false
java.lang.String
The developer-assigned ID of this component. The ID must be unique
within the scope of the tag's enclosing naming container (e.g.
h:form or f:subview). This value must be a static value.
binding
false
false
java.lang.String
Identifies a backing bean property (of type UIComponent or appropriate
subclass) to bind to this component instance. This value must be an
EL expression.
rendered
false
false
java.lang.String
A boolean value that indicates whether this component should be rendered.
Default value: true.
dir
false
false
HTML: The direction of text display, either 'ltr' (left-to-right) or 'rtl' (right-to-left).
lang
false
false
HTML: The base language of this document.
style
false
false
HTML: CSS styling instructions.
title
false
false
HTML: An advisory title for this element. Often used by the user agent as a tooltip.
styleClass
false
false
The CSS class for this element. Corresponds to the HTML 'class' attribute.
onclick
false
false
HTML: Script to be invoked when the element is clicked.
ondblclick
false
false
HTML: Script to be invoked when the element is double-clicked.
onmousedown
false
false
HTML: Script to be invoked when the pointing device is pressed over this element.
onmouseup
false
false
HTML: Script to be invoked when the pointing device is released over this element.
onmouseover
false
false
HTML: Script to be invoked when the pointing device is moved into this element.
onmousemove
false
false
HTML: Script to be invoked when the pointing device is moved while it is in this element.
onmouseout
false
false
HTML: Script to be invoked when the pointing device is moves out of this element.
onkeypress
false
false
HTML: Script to be invoked when a key is pressed over this element.
onkeydown
false
false
HTML: Script to be invoked when a key is pressed down over this element.
onkeyup
false
false
HTML: Script to be invoked when a key is released over this element.
selectBooleanCheckbox
org.apache.myfaces.taglib.html.HtmlSelectBooleanCheckboxTag
JSP
Allow the user to choose a "true" or "false" value, presented as a
checkbox.
<p>
Renders as an HTML input tag with its type set to "checkbox", and
its name attribute set to the id. The "checked" attribute is rendered
if the value of this component is true.
<p>
Unless otherwise specified, all attributes accept static values
or EL expressions.
id
false
false
java.lang.String
The developer-assigned ID of this component. The ID must be unique
within the scope of the tag's enclosing naming container (e.g.
h:form or f:subview). This value must be a static value.
binding
false
false
java.lang.String
Identifies a backing bean property (of type UIComponent or appropriate
subclass) to bind to this component instance. This value must be an
EL expression.
rendered
false
false
java.lang.String
A boolean value that indicates whether this component should be rendered.
Default value: true.
value
false
false
java.lang.String
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
converter
false
false
java.lang.String
An expression that specifies the Converter for this component.
If the value binding expression is a String, the String is used
as an ID to look up a Converter. If the value binding expression
is a Converter, uses that instance as the converter.
The value can either be a static value (ID case only) or an EL expression.
immediate
false
false
java.lang.String
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.
required
false
false
java.lang.String
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.
validator
false
false
java.lang.String
A method binding EL expression, accepting FacesContext, UIComponent,
and Object parameters, and returning void, that validates the
component's local value.
valueChangeListener
false
false
java.lang.String
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.
dir
false
false
HTML: The direction of text display, either 'ltr' (left-to-right) or 'rtl' (right-to-left).
lang
false
false
HTML: The base language of this document.
style
false
false
HTML: CSS styling instructions.
title
false
false
HTML: An advisory title for this element. Often used by the user agent as a tooltip.
styleClass
false
false
The CSS class for this element. Corresponds to the HTML 'class' attribute.
onclick
false
false
HTML: Script to be invoked when the element is clicked.
ondblclick
false
false
HTML: Script to be invoked when the element is double-clicked.
onmousedown
false
false
HTML: Script to be invoked when the pointing device is pressed over this element.
onmouseup
false
false
HTML: Script to be invoked when the pointing device is released over this element.
onmouseover
false
false
HTML: Script to be invoked when the pointing device is moved into this element.
onmousemove
false
false
HTML: Script to be invoked when the pointing device is moved while it is in this element.
onmouseout
false
false
HTML: Script to be invoked when the pointing device is moves out of this element.
onkeypress
false
false
HTML: Script to be invoked when a key is pressed over this element.
onkeydown
false
false
HTML: Script to be invoked when a key is pressed down over this element.
onkeyup
false
false
HTML: Script to be invoked when a key is released over this element.
accesskey
false
false
java.lang.String
HTML: Sets the access key for this element.
alt
false
false
java.lang.String
HTML: Specifies alternative text that can be used by a browser that can't show this element.
datafld
false
false
Reserved for future use.
datasrc
false
false
Reserved for future use.
dataformatas
false
false
Reserved for future use.
disabled
false
false
java.lang.String
HTML: When true, this element cannot receive focus.
onblur
false
false
java.lang.String
HTML: Specifies a script to be invoked when the element loses focus.
onfocus
false
false
java.lang.String
HTML: Specifies a script to be invoked when the element receives focus.
onchange
false
false
java.lang.String
HTML: Specifies a script to be invoked when the element is modified.
onselect
false
false
java.lang.String
HTML: Specifies a script to be invoked when the element is selected.
readonly
false
false
java.lang.String
HTML: When true, indicates that this component cannot be modified by the user.
The element may receive focus unless it has also been disabled.
tabindex
false
false
java.lang.String
HTML: Specifies the position of this element within the tab order of the document.
selectManyCheckbox
org.apache.myfaces.taglib.html.HtmlSelectManyCheckboxTag
JSP
Allow the user to select zero or more items from a set of
available options. This is presented as a table with one cell per
available option; each cell contains a checkbox and the option's
label. The "layout" attribute determines whether the checkboxes
are laid out horizontally or vertically.
<p>
The set of available options is defined by adding child
f:selectItem or f:selectItems components to this component.
<p>
The value attribute must be a value-binding expression to a
property of type List, Object array or primitive array. That
"collection" is expected to contain objects of the same type as
SelectItem.getValue() returns for the child SelectItem objects.
On rendering, any child whose value is in the list will be
selected initially. During the update phase, the property setter
is called to replace the original collection with a completely
new collection object of the appropriate type. The new collection
object contains the value of each child SelectItem object that
is currently selected.
<p>
Unless otherwise specified, all attributes accept static values
or EL expressions.
id
false
false
java.lang.String
The developer-assigned ID of this component. The ID must be unique
within the scope of the tag's enclosing naming container (e.g.
h:form or f:subview). This value must be a static value.
binding
false
false
java.lang.String
Identifies a backing bean property (of type UIComponent or appropriate
subclass) to bind to this component instance. This value must be an
EL expression.
rendered
false
false
java.lang.String
A boolean value that indicates whether this component should be rendered.
Default value: true.
value
false
false
java.lang.String
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
converter
false
false
java.lang.String
An expression that specifies the Converter for this component.
If the value binding expression is a String, the String is used
as an ID to look up a Converter. If the value binding expression
is a Converter, uses that instance as the converter.
The value can either be a static value (ID case only) or an EL expression.
immediate
false
false
java.lang.String
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.
required
false
false
java.lang.String
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.
validator
false
false
java.lang.String
A method binding EL expression, accepting FacesContext, UIComponent,
and Object parameters, and returning void, that validates the
component's local value.
valueChangeListener
false
false
java.lang.String
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.
border
false
false
java.lang.String
HTML: Specifies the width of the border of this element, in pixels. Deprecated in HTML 4.01.
dir
false
false
HTML: The direction of text display, either 'ltr' (left-to-right) or 'rtl' (right-to-left).
lang
false
false
HTML: The base language of this document.
style
false
false
HTML: CSS styling instructions.
title
false
false
HTML: An advisory title for this element. Often used by the user agent as a tooltip.
styleClass
false
false
The CSS class for this element. Corresponds to the HTML 'class' attribute.
onclick
false
false
HTML: Script to be invoked when the element is clicked.
ondblclick
false
false
HTML: Script to be invoked when the element is double-clicked.
onmousedown
false
false
HTML: Script to be invoked when the pointing device is pressed over this element.
onmouseup
false
false
HTML: Script to be invoked when the pointing device is released over this element.
onmouseover
false
false
HTML: Script to be invoked when the pointing device is moved into this element.
onmousemove
false
false
HTML: Script to be invoked when the pointing device is moved while it is in this element.
onmouseout
false
false
HTML: Script to be invoked when the pointing device is moves out of this element.
onkeypress
false
false
HTML: Script to be invoked when a key is pressed over this element.
onkeydown
false
false
HTML: Script to be invoked when a key is pressed down over this element.
onkeyup
false
false
HTML: Script to be invoked when a key is released over this element.
accesskey
false
false
java.lang.String
HTML: Sets the access key for this element.
alt
false
false
java.lang.String
HTML: Specifies alternative text that can be used by a browser that can't show this element.
datafld
false
false
Reserved for future use.
datasrc
false
false
Reserved for future use.
dataformatas
false
false
Reserved for future use.
disabled
false
false
java.lang.String
HTML: When true, this element cannot receive focus.
onblur
false
false
java.lang.String
HTML: Specifies a script to be invoked when the element loses focus.
onfocus
false
false
java.lang.String
HTML: Specifies a script to be invoked when the element receives focus.
onchange
false
false
java.lang.String
HTML: Specifies a script to be invoked when the element is modified.
onselect
false
false
java.lang.String
HTML: Specifies a script to be invoked when the element is selected.
readonly
false
false
java.lang.String
HTML: When true, indicates that this component cannot be modified by the user.
The element may receive focus unless it has also been disabled.
tabindex
false
false
java.lang.String
HTML: Specifies the position of this element within the tab order of the document.
layout
false
false
java.lang.String
Controls the layout direction of the child elements. Values include:
lineDirection (vertical) and pageDirection (horzontal).
enabledClass
false
false
The CSS class assigned to the label element for enabled choices.
disabledClass
false
false
The CSS class assigned to the label element for enabled choices.
selectManyListbox
org.apache.myfaces.taglib.html.HtmlSelectManyListboxTag
JSP
Allow the user to select zero or more items from a set of
available options. This is presented as a listbox which allows
multiple rows in the list to be selected simultaneously.
<p>
The set of available options is defined by adding child
f:selectItem or f:selectItems components to this component.
<p>
The list is rendered as an HTML select element. The "multiple"
attribute is set on the element and the size attribute is set to
the provided value, defaulting to the number of items in the list
if no value is provided. If the size is set to 1, then a
"drop-down" list (aka "combo-box") is presented, though if this is
the intention then a selectManyMenu should be used instead.
<p>
The value attribute must be a value-binding expression to a
property of type List, Object array or primitive array. That
"collection" is expected to contain objects of the same type as
SelectItem.getValue() returns for the child SelectItem objects.
On rendering, any child whose value is in the list will be
selected initially. During the update phase, the property is set
to contain a "collection" of values for those child SelectItem
objects that are currently selected.
<p>
Unless otherwise specified, all attributes accept static values
or EL expressions.
id
false
false
java.lang.String
The developer-assigned ID of this component. The ID must be unique
within the scope of the tag's enclosing naming container (e.g.
h:form or f:subview). This value must be a static value.
binding
false
false
java.lang.String
Identifies a backing bean property (of type UIComponent or appropriate
subclass) to bind to this component instance. This value must be an
EL expression.
rendered
false
false
java.lang.String
A boolean value that indicates whether this component should be rendered.
Default value: true.
value
false
false
java.lang.String
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
converter
false
false
java.lang.String
An expression that specifies the Converter for this component.
If the value binding expression is a String, the String is used
as an ID to look up a Converter. If the value binding expression
is a Converter, uses that instance as the converter.
The value can either be a static value (ID case only) or an EL expression.
immediate
false
false
java.lang.String
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.
required
false
false
java.lang.String
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.
validator
false
false
java.lang.String
A method binding EL expression, accepting FacesContext, UIComponent,
and Object parameters, and returning void, that validates the
component's local value.
valueChangeListener
false
false
java.lang.String
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.
dir
false
false
HTML: The direction of text display, either 'ltr' (left-to-right) or 'rtl' (right-to-left).
lang
false
false
HTML: The base language of this document.
style
false
false
HTML: CSS styling instructions.
title
false
false
HTML: An advisory title for this element. Often used by the user agent as a tooltip.
styleClass
false
false
The CSS class for this element. Corresponds to the HTML 'class' attribute.
onclick
false
false
HTML: Script to be invoked when the element is clicked.
ondblclick
false
false
HTML: Script to be invoked when the element is double-clicked.
onmousedown
false
false
HTML: Script to be invoked when the pointing device is pressed over this element.
onmouseup
false
false
HTML: Script to be invoked when the pointing device is released over this element.
onmouseover
false
false
HTML: Script to be invoked when the pointing device is moved into this element.
onmousemove
false
false
HTML: Script to be invoked when the pointing device is moved while it is in this element.
onmouseout
false
false
HTML: Script to be invoked when the pointing device is moves out of this element.
onkeypress
false
false
HTML: Script to be invoked when a key is pressed over this element.
onkeydown
false
false
HTML: Script to be invoked when a key is pressed down over this element.
onkeyup
false
false
HTML: Script to be invoked when a key is released over this element.
accesskey
false
false
java.lang.String
HTML: Sets the access key for this element.
onblur
false
false
java.lang.String
HTML: Specifies a script to be invoked when the element loses focus.
onfocus
false
false
java.lang.String
HTML: Specifies a script to be invoked when the element receives focus.
onchange
false
false
java.lang.String
HTML: Specifies a script to be invoked when the element is modified.
onselect
false
false
java.lang.String
HTML: Specifies a script to be invoked when the element is selected.
tabindex
false
false
java.lang.String
HTML: Specifies the position of this element within the tab order of the document.
readonly
false
false
java.lang.String
HTML: When true, indicates that this component cannot be modified by the user.
The element may receive focus unless it has also been disabled.
disabled
false
false
java.lang.String
HTML: When true, this element cannot receive focus.
datafld
false
false
Reserved for future use.
datasrc
false
false
Reserved for future use.
dataformatas
false
false
Reserved for future use.
size
false
false
java.lang.String
see JSF Spec.
enabledClass
false
false
disabledClass
false
false
selectManyMenu
org.apache.myfaces.taglib.html.HtmlSelectManyMenuTag
JSP
Allow the user to select zero or more items from a set of available
options. This is presented as a drop-down "combo-box" which allows
multiple rows in the list to be selected simultaneously.
<p>
The set of available options is defined by adding child
f:selectItem or f:selectItems components to this component.
<p>
Renders as an HTML select element, with the choices made up of
child f:selectItem or f:selectItems elements. The multiple
attribute is set and the size attribute is set to 1.
<p>
The value attribute must be a value-binding expression to a
property of type List, Object array or primitive array. That
"collection" is expected to contain objects of the same type as
SelectItem.getValue() returns for the child SelectItem objects.
On rendering, any child whose value is in the list will be
selected initially. During the update phase, the property is set
to contain a "collection" of values for those child SelectItem
objects that are currently selected.
<p>
Unless otherwise specified, all attributes accept static values
or EL expressions.
id
false
false
java.lang.String
The developer-assigned ID of this component. The ID must be unique
within the scope of the tag's enclosing naming container (e.g.
h:form or f:subview). This value must be a static value.
binding
false
false
java.lang.String
Identifies a backing bean property (of type UIComponent or appropriate
subclass) to bind to this component instance. This value must be an
EL expression.
rendered
false
false
java.lang.String
A boolean value that indicates whether this component should be rendered.
Default value: true.
value
false
false
java.lang.String
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
converter
false
false
java.lang.String
An expression that specifies the Converter for this component.
If the value binding expression is a String, the String is used
as an ID to look up a Converter. If the value binding expression
is a Converter, uses that instance as the converter.
The value can either be a static value (ID case only) or an EL expression.
immediate
false
false
java.lang.String
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.
required
false
false
java.lang.String
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.
validator
false
false
java.lang.String
A method binding EL expression, accepting FacesContext, UIComponent,
and Object parameters, and returning void, that validates the
component's local value.
valueChangeListener
false
false
java.lang.String
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.
dir
false
false
HTML: The direction of text display, either 'ltr' (left-to-right) or 'rtl' (right-to-left).
lang
false
false
HTML: The base language of this document.
style
false
false
HTML: CSS styling instructions.
title
false
false
HTML: An advisory title for this element. Often used by the user agent as a tooltip.
styleClass
false
false
The CSS class for this element. Corresponds to the HTML 'class' attribute.
onclick
false
false
HTML: Script to be invoked when the element is clicked.
ondblclick
false
false
HTML: Script to be invoked when the element is double-clicked.
onmousedown
false
false
HTML: Script to be invoked when the pointing device is pressed over this element.
onmouseup
false
false
HTML: Script to be invoked when the pointing device is released over this element.
onmouseover
false
false
HTML: Script to be invoked when the pointing device is moved into this element.
onmousemove
false
false
HTML: Script to be invoked when the pointing device is moved while it is in this element.
onmouseout
false
false
HTML: Script to be invoked when the pointing device is moves out of this element.
onkeypress
false
false
HTML: Script to be invoked when a key is pressed over this element.
onkeydown
false
false
HTML: Script to be invoked when a key is pressed down over this element.
onkeyup
false
false
HTML: Script to be invoked when a key is released over this element.
accesskey
false
false
java.lang.String
HTML: Sets the access key for this element.
onblur
false
false
java.lang.String
HTML: Specifies a script to be invoked when the element loses focus.
onfocus
false
false
java.lang.String
HTML: Specifies a script to be invoked when the element receives focus.
onchange
false
false
java.lang.String
HTML: Specifies a script to be invoked when the element is modified.
onselect
false
false
java.lang.String
HTML: Specifies a script to be invoked when the element is selected.
tabindex
false
false
java.lang.String
HTML: Specifies the position of this element within the tab order of the document.
readonly
false
false
java.lang.String
HTML: When true, indicates that this component cannot be modified by the user.
The element may receive focus unless it has also been disabled.
disabled
false
false
java.lang.String
HTML: When true, this element cannot receive focus.
datafld
false
false
Reserved for future use.
datasrc
false
false
Reserved for future use.
dataformatas
false
false
Reserved for future use.
enabledClass
false
false
disabledClass
false
false
selectOneListbox
org.apache.myfaces.taglib.html.HtmlSelectOneListboxTag
JSP
Allow the user to choose one option from a set of options.
<p>
Rendered as a listbox with the MULTIPLE attribute set to false.
<p>
The available choices are defined via child f:selectItem or
f:selectItems elements. The size of the listbox defaults to the
number of available choices; if size is explicitly set to a
smaller value, then scrollbars will be rendered. If size is set
to 1 then a "drop-down menu" (aka "combo-box") is rendered, though
if this is the intent then selectOneMenu should be used instead.
<p>
The value attribute of this component is read to determine
which of the available options is initially selected; its value
should match the "value" property of one of the child SelectItem
objects.
<p>
On submit of the enclosing form, the value attribute's bound
property is updated to contain the "value" property from the
chosen SelectItem.
<p>
Unless otherwise specified, all attributes accept static values
or EL expressions.
id
false
false
java.lang.String
The developer-assigned ID of this component. The ID must be unique
within the scope of the tag's enclosing naming container (e.g.
h:form or f:subview). This value must be a static value.
binding
false
false
java.lang.String
Identifies a backing bean property (of type UIComponent or appropriate
subclass) to bind to this component instance. This value must be an
EL expression.
rendered
false
false
java.lang.String
A boolean value that indicates whether this component should be rendered.
Default value: true.
value
false
false
java.lang.String
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
converter
false
false
java.lang.String
An expression that specifies the Converter for this component.
If the value binding expression is a String, the String is used
as an ID to look up a Converter. If the value binding expression
is a Converter, uses that instance as the converter.
The value can either be a static value (ID case only) or an EL expression.
immediate
false
false
java.lang.String
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.
required
false
false
java.lang.String
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.
validator
false
false
java.lang.String
A method binding EL expression, accepting FacesContext, UIComponent,
and Object parameters, and returning void, that validates the
component's local value.
valueChangeListener
false
false
java.lang.String
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.
dir
false
false
HTML: The direction of text display, either 'ltr' (left-to-right) or 'rtl' (right-to-left).
lang
false
false
HTML: The base language of this document.
style
false
false
HTML: CSS styling instructions.
title
false
false
HTML: An advisory title for this element. Often used by the user agent as a tooltip.
styleClass
false
false
The CSS class for this element. Corresponds to the HTML 'class' attribute.
onclick
false
false
HTML: Script to be invoked when the element is clicked.
ondblclick
false
false
HTML: Script to be invoked when the element is double-clicked.
onmousedown
false
false
HTML: Script to be invoked when the pointing device is pressed over this element.
onmouseup
false
false
HTML: Script to be invoked when the pointing device is released over this element.
onmouseover
false
false
HTML: Script to be invoked when the pointing device is moved into this element.
onmousemove
false
false
HTML: Script to be invoked when the pointing device is moved while it is in this element.
onmouseout
false
false
HTML: Script to be invoked when the pointing device is moves out of this element.
onkeypress
false
false
HTML: Script to be invoked when a key is pressed over this element.
onkeydown
false
false
HTML: Script to be invoked when a key is pressed down over this element.
onkeyup
false
false
HTML: Script to be invoked when a key is released over this element.
accesskey
false
false
java.lang.String
HTML: Sets the access key for this element.
onblur
false
false
java.lang.String
HTML: Specifies a script to be invoked when the element loses focus.
onfocus
false
false
java.lang.String
HTML: Specifies a script to be invoked when the element receives focus.
onchange
false
false
java.lang.String
HTML: Specifies a script to be invoked when the element is modified.
onselect
false
false
java.lang.String
HTML: Specifies a script to be invoked when the element is selected.
tabindex
false
false
java.lang.String
HTML: Specifies the position of this element within the tab order of the document.
readonly
false
false
java.lang.String
HTML: When true, indicates that this component cannot be modified by the user.
The element may receive focus unless it has also been disabled.
disabled
false
false
java.lang.String
HTML: When true, this element cannot receive focus.
datafld
false
false
Reserved for future use.
datasrc
false
false
Reserved for future use.
dataformatas
false
false
Reserved for future use.
size
false
false
java.lang.String
see JSF Spec.
enabledClass
false
false
disabledClass
false
false
selectOneMenu
org.apache.myfaces.taglib.html.HtmlSelectOneMenuTag
JSP
Allow the user to choose one option from a set of options.
<p>
Renders a drop-down menu (aka "combo-box") containing a set of
choices, of which only one can be chosen at a time. The available
choices are defined via child f:selectItem or f:selectItems
elements.
<p>
The value attribute of this component is read to determine
which of the available options is initially selected; its value
should match the "value" property of one of the child SelectItem
objects.
<p>
On submit of the enclosing form, the value attribute's bound property
is updated to contain the "value" property from the chosen SelectItem.
<p>
Unless otherwise specified, all attributes accept static values
or EL expressions.
id
false
false
java.lang.String
The developer-assigned ID of this component. The ID must be unique
within the scope of the tag's enclosing naming container (e.g.
h:form or f:subview). This value must be a static value.
binding
false
false
java.lang.String
Identifies a backing bean property (of type UIComponent or appropriate
subclass) to bind to this component instance. This value must be an
EL expression.
rendered
false
false
java.lang.String
A boolean value that indicates whether this component should be rendered.
Default value: true.
value
false
false
java.lang.String
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
converter
false
false
java.lang.String
An expression that specifies the Converter for this component.
If the value binding expression is a String, the String is used
as an ID to look up a Converter. If the value binding expression
is a Converter, uses that instance as the converter.
The value can either be a static value (ID case only) or an EL expression.
immediate
false
false
java.lang.String
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.
required
false
false
java.lang.String
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.
validator
false
false
java.lang.String
A method binding EL expression, accepting FacesContext, UIComponent,
and Object parameters, and returning void, that validates the
component's local value.
valueChangeListener
false
false
java.lang.String
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.
dir
false
false
HTML: The direction of text display, either 'ltr' (left-to-right) or 'rtl' (right-to-left).
lang
false
false
HTML: The base language of this document.
style
false
false
HTML: CSS styling instructions.
title
false
false
HTML: An advisory title for this element. Often used by the user agent as a tooltip.
styleClass
false
false
The CSS class for this element. Corresponds to the HTML 'class' attribute.
onclick
false
false
HTML: Script to be invoked when the element is clicked.
ondblclick
false
false
HTML: Script to be invoked when the element is double-clicked.
onmousedown
false
false
HTML: Script to be invoked when the pointing device is pressed over this element.
onmouseup
false
false
HTML: Script to be invoked when the pointing device is released over this element.
onmouseover
false
false
HTML: Script to be invoked when the pointing device is moved into this element.
onmousemove
false
false
HTML: Script to be invoked when the pointing device is moved while it is in this element.
onmouseout
false
false
HTML: Script to be invoked when the pointing device is moves out of this element.
onkeypress
false
false
HTML: Script to be invoked when a key is pressed over this element.
onkeydown
false
false
HTML: Script to be invoked when a key is pressed down over this element.
onkeyup
false
false
HTML: Script to be invoked when a key is released over this element.
accesskey
false
false
java.lang.String
HTML: Sets the access key for this element.
onblur
false
false
java.lang.String
HTML: Specifies a script to be invoked when the element loses focus.
onfocus
false
false
java.lang.String
HTML: Specifies a script to be invoked when the element receives focus.
onchange
false
false
java.lang.String
HTML: Specifies a script to be invoked when the element is modified.
onselect
false
false
java.lang.String
HTML: Specifies a script to be invoked when the element is selected.
tabindex
false
false
java.lang.String
HTML: Specifies the position of this element within the tab order of the document.
readonly
false
false
java.lang.String
HTML: When true, indicates that this component cannot be modified by the user.
The element may receive focus unless it has also been disabled.
disabled
false
false
java.lang.String
HTML: When true, this element cannot receive focus.
datafld
false
false
Reserved for future use.
datasrc
false
false
Reserved for future use.
dataformatas
false
false
Reserved for future use.
enabledClass
false
false
disabledClass
false
false
selectOneRadio
org.apache.myfaces.taglib.html.HtmlSelectOneRadioTag
JSP
Allow the user to choose one option from a set of options.
<p>
Renders as an HTML table element, containing an input element for
each child f:selectItem or f:selectItems elements. The input
elements are rendered as type radio.
<p>
The value attribute of this component is read to determine
which of the available options is initially selected; its value should
match the "value" property of one of the child SelectItem objects.
<p>
On submit of the enclosing form, the value attribute's bound property
is updated to contain the "value" property from the chosen SelectItem.
<p>
Unless otherwise specified, all attributes accept static values
or EL expressions.
id
false
false
java.lang.String
The developer-assigned ID of this component. The ID must be unique
within the scope of the tag's enclosing naming container (e.g.
h:form or f:subview). This value must be a static value.
binding
false
false
java.lang.String
Identifies a backing bean property (of type UIComponent or appropriate
subclass) to bind to this component instance. This value must be an
EL expression.
rendered
false
false
java.lang.String
A boolean value that indicates whether this component should be rendered.
Default value: true.
value
false
false
java.lang.String
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
converter
false
false
java.lang.String
An expression that specifies the Converter for this component.
If the value binding expression is a String, the String is used
as an ID to look up a Converter. If the value binding expression
is a Converter, uses that instance as the converter.
The value can either be a static value (ID case only) or an EL expression.
immediate
false
false
java.lang.String
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.
required
false
false
java.lang.String
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.
validator
false
false
java.lang.String
A method binding EL expression, accepting FacesContext, UIComponent,
and Object parameters, and returning void, that validates the
component's local value.
valueChangeListener
false
false
java.lang.String
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.
dir
false
false
HTML: The direction of text display, either 'ltr' (left-to-right) or 'rtl' (right-to-left).
lang
false
false
HTML: The base language of this document.
style
false
false
HTML: CSS styling instructions.
title
false
false
HTML: An advisory title for this element. Often used by the user agent as a tooltip.
styleClass
false
false
The CSS class for this element. Corresponds to the HTML 'class' attribute.
onclick
false
false
HTML: Script to be invoked when the element is clicked.
ondblclick
false
false
HTML: Script to be invoked when the element is double-clicked.
onmousedown
false
false
HTML: Script to be invoked when the pointing device is pressed over this element.
onmouseup
false
false
HTML: Script to be invoked when the pointing device is released over this element.
onmouseover
false
false
HTML: Script to be invoked when the pointing device is moved into this element.
onmousemove
false
false
HTML: Script to be invoked when the pointing device is moved while it is in this element.
onmouseout
false
false
HTML: Script to be invoked when the pointing device is moves out of this element.
onkeypress
false
false
HTML: Script to be invoked when a key is pressed over this element.
onkeydown
false
false
HTML: Script to be invoked when a key is pressed down over this element.
onkeyup
false
false
HTML: Script to be invoked when a key is released over this element.
accesskey
false
false
java.lang.String
HTML: Sets the access key for this element.
alt
false
false
java.lang.String
HTML: Specifies alternative text that can be used by a browser that can't show this element.
disabled
false
false
java.lang.String
HTML: When true, this element cannot receive focus.
onblur
false
false
java.lang.String
HTML: Specifies a script to be invoked when the element loses focus.
onfocus
false
false
java.lang.String
HTML: Specifies a script to be invoked when the element receives focus.
onchange
false
false
java.lang.String
HTML: Specifies a script to be invoked when the element is modified.
onselect
false
false
java.lang.String
HTML: Specifies a script to be invoked when the element is selected.
readonly
false
false
java.lang.String
HTML: When true, indicates that this component cannot be modified by the user.
The element may receive focus unless it has also been disabled.
tabindex
false
false
java.lang.String
HTML: Specifies the position of this element within the tab order of the document.
datafld
false
false
Reserved for future use.
datasrc
false
false
Reserved for future use.
dataformatas
false
false
Reserved for future use.
layout
false
false
java.lang.String
Orientation of the options list. Valid values are
"pageDirection" for a vertical layout, or "lineDirection" for
horizontal. The default value is "lineDirection".
border
false
false
java.lang.String
Width in pixels of the border to be drawn around the table containing the options list.
enabledClass
false
false
disabledClass
false
false