This tag library implements the standard JSF core tags.
1.2
f
http://java.sun.com/jsf/core
org.apache.myfaces.webapp.StartupServletContextListener
This tag creates an instance of the specified ActionListener, and
associates it with the nearest parent UIComponent.
Unless otherwise specified, all attributes accept static values
or EL expressions.
actionListener
org.apache.myfaces.taglib.core.ActionListenerTag
empty
The fully qualified class name of the ActionListener class.
type
java.lang.String
Value binding expression that evaluates to an object that
implements javax.faces.event.ActionListener.
binding
false
javax.faces.event.ActionListener
This tag associates an attribute with the nearest parent
UIComponent.
<p>
When the value is not an EL expression, this tag has the same effect
as calling component.getAttributes.put(name, value). When the attribute
name specified matches a standard property of the component, that
property is set. However it is also valid to assign attributes
to components using any arbitrary name; the component itself won't
make any use of these but other objects such as custom renderers,
validators or action listeners can later retrieve the attribute
from the component by name.
<p>
When the value is an EL expression, this tag has the same effect
as calling component.setValueBinding. A call to method
component.getAttributes().get(name) will then cause that
expression to be evaluated and the result of the expression is
returned, not the original EL expression string.
<p>
See the javadoc for UIComponent.getAttributes for more details.
<p>
Unless otherwise specified, all attributes accept static values
or EL expressions.
attribute
org.apache.myfaces.taglib.core.AttributeTag
empty
The name of the attribute.
name
java.lang.String
The attribute's value.
value
java.lang.Object
This tag associates a date time converter with the nearest parent UIComponent.
Unless otherwise specified, all attributes accept static values or EL expressions.
convertDateTime
org.apache.myfaces.taglib.core.ConvertDateTimeTag
empty
The style of the date. Values include: default, short, medium, long, and full.
dateStyle
false
java.lang.String
The name of the locale to be used, instead of the default.
locale
false
java.lang.Object
A custom Date formatting pattern, in the format used by java.text.SimpleDateFormat.
pattern
false
java.lang.String
The style of the time. Values include: default, short, medium, long, and full.
timeStyle
false
java.lang.String
The time zone to use instead of GMT (the default timezone). When
this value is a value-binding to a TimeZone instance, that
timezone is used. Otherwise this value is treated as a String
containing a timezone id, ie as the ID parameter of method
java.util.TimeZone.getTimeZone(String).
timeZone
false
java.lang.Object
Specifies whether the date, time, or both should be
parsed/formatted. Values include: date, time, and both.
Default based on setting of timeStyle and dateStyle.
type
false
java.lang.String
A ValueExpression that evaluates to a DateTimeConverter.
binding
javax.faces.convert.DateTimeConverter
This tag creates an instance of the specified Converter, and
associates it with the nearest parent UIComponent.
converter
org.apache.myfaces.taglib.core.ConverterImplTag
empty
The converter's registered ID.
converterId
false
java.lang.String
A ValueExpression that evaluates to a Converter.
binding
javax.faces.convert.Converter
This tag creates a number formatting converter and associates it
with the nearest parent UIComponent.
Unless otherwise specified, all attributes accept static values or EL expressions.
convertNumber
org.apache.myfaces.taglib.core.ConvertNumberTag
empty
ISO 4217 currency code
currencyCode
false
java.lang.String
The currency symbol used to format a currency value. Defaults
to the currency symbol for locale.
currencySymbol
false
java.lang.String
Specifies whether output will contain grouping separators. Default: true.
groupingUsed
false
java.lang.Boolean
Specifies whether only the integer part of the input will be parsed. Default: false.
integerOnly
false
java.lang.Boolean
The Locale to be used, instead of the default as
specified in the faces configuration file.
locale
false
java.util.Locale
The maximum number of digits in the fractional portion of the number.
maxFractionDigits
false
java.lang.Integer
The maximum number of digits in the integer portion of the number.
maxIntegerDigits
false
java.lang.Integer
The minimum number of digits in the fractional portion of the number.
minFractionDigits
false
java.lang.Integer
The minimum number of digits in the integer portion of the number.
minIntegerDigits
false
java.lang.Integer
A custom Date formatting pattern, in the format used by java.text.SimpleDateFormat.
pattern
false
java.lang.String
The type of formatting/parsing to be performed. Values include:
number, currency, and percent. Default: number.
type
false
java.lang.String
A ValueExpression that evaluates to a NumberConverter.
binding
javax.faces.convert.NumberConverter
This tag adds its child as a facet of the nearest parent UIComponent.
A child consisting of multiple elements should be nested within a
container component (i.e., within an h:panelGroup for HTML library
components).
Unless otherwise specified, all attributes accept static values or EL expressions.
facet
javax.faces.webapp.FacetTag
JSP
The name of the facet to be created. This must be a static value.
name
true
false
java.lang.String
Loads a resource bundle and saves it as a variable in the request scope.
Unless otherwise specified, all attributes accept static values or EL expressions.
loadBundle
org.apache.myfaces.taglib.core.LoadBundleTag
empty
The base name of the resource bundle.
basename
true
java.lang.String
The name of the variable in request scope that the resources
are saved to. This must be a static value.
var
true
false
This tag associates a parameter name-value pair with the nearest
parent UIComponent. A UIComponent is created to represent this
name-value pair, and stored as a child of the parent component; what
effect this has depends upon the renderer of that parent component.
<p>
Unless otherwise specified, all attributes accept static values
or EL expressions.
param
org.apache.myfaces.taglib.core.ParamTag
JSP
Identifies a backing bean property (of type UIComponent or appropriate
subclass) to bind to this component instance. This value must be an
EL expression.
binding
false
javax.faces.component.UIComponent
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.
id
false
true
A String containing the name of the parameter.
name
false
false
java.lang.String
The value of this parameter.
value
false
Register a PhaseListener instance
phaseListener
org.apache.myfaces.taglib.core.PhaseListenerTag
empty
Class name of the PhaseListener to be created and registered.
type
false
java.lang.String
Value binding expression that evaluates to a PhaseListener.
binding
false
javax.faces.event.PhaseListener
This tag associates a single SelectItem with the nearest
parent UIComponent. The item represents a single option
for a component such as an h:selectBooleanCheckbox or h:selectOneMenu.
See also component selectItems.
<p>
Unless otherwise specified, all attributes accept static values
or EL expressions.
selectItem
org.apache.myfaces.taglib.core.SelectItemTag
empty
Identifies a backing bean property (of type UIComponent or appropriate
subclass) to bind to this component instance. This value must be an
EL expression.
binding
false
javax.faces.component.UIComponent
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.
id
false
true
If true, this component will not be saved during state saving.
itemDisabled
false
java.lang.Boolean
An optional description for this item.
itemDescription
false
java.lang.String
The locale-specific label that will be displayed to the user for this item.
itemLabel
false
java.lang.String
The value of this item, of the same type as the parent component's value.
itemValue
false
An EL expression that refers to a javax.faces.model.SelectItem instance.
value
false
javax.faces.model.SelectItem
Flag indicating that characters that are sensitive in
the value of the itemLabel]]>
attribute must be escaped. This flag is set to "true" by
default.
escape
java.lang.String
This tag associates a set of selection list items with the nearest
parent UIComponent. The set of SelectItem objects is retrieved via
a value-binding.
<p>
Unless otherwise specified, all attributes accept static values
or EL expressions.
selectItems
org.apache.myfaces.taglib.core.SelectItemsTag
empty
Identifies a backing bean property (of type UIComponent or appropriate
subclass) to bind to this component instance. This value must be an
EL expression.
binding
false
javax.faces.component.UIComponent
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.
id
false
true
A single SelectItem
An array or Collection of SelectItem instances
A Map. The contents of the Map are used to create SelectItem
instances, where the SelectItem's label is the map's key value,
and the SelectItem's value is the map's value. When using a
map, it is recommended that an ordered implementation such as
java.util.TreeMap is used.
The value properties of each of the SelectItems must be of the same
basic type as the parent component's value.
]]>
value
false
java.lang.Object
setPropertyActionListener
org.apache.myfaces.taglib.core.SetPropertyActionListenerTag
empty
ValueExpression for the value of the target attribute.
value
true
ValueExpression for the destination of the value attribute.
target
true
This tag associates a set of UIComponents with the nearest parent
UIComponent. It acts as a naming container to make the IDs of its
component elements unique.
Unless otherwise specified, all attributes accept static values or EL expressions.
subview
org.apache.myfaces.taglib.core.SubviewTag
JSP
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.
id
true
true
Identifies a backing bean property (of type UIComponent or appropriate
subclass) to bind to this component instance. This value must be an
EL expression.
binding
false
javax.faces.component.UIComponent
A boolean value that indicates whether this component should be rendered.
Default value: true.
rendered
false
java.lang.Boolean
Creates a validator and associateds it with the nearest parent
UIComponent. When invoked, the validator ensures that values are
valid doubles that lie within the minimum and maximum values specified.
Commonly associated with a h:inputText entity.
Unless otherwise specified, all attributes accept static values or EL expressions.
validateDoubleRange
org.apache.myfaces.taglib.core.ValidateDoubleRangeTag
JSP
The smallest value that should be considered valid.
minimum
false
java.lang.Double
The largest value that should be considered valid.
maximum
false
java.lang.Double
A ValueExpression that evaluates to a DoubleRangeValidator.
binding
javax.faces.validator.DoubleRangeValidator
Creates a validator and associateds it with the nearest parent
UIComponent. When invoked, the validator ensures that values are
valid strings with a length that lies within the minimum and maximum
values specified.
Commonly associated with a h:inputText entity.
Unless otherwise specified, all attributes accept static values or EL expressions.
validateLength
org.apache.myfaces.taglib.core.ValidateLengthTag
JSP
The smallest value that should be considered valid.
minimum
false
java.lang.Integer
The largest value that should be considered valid.
maximum
false
java.lang.Integer
A ValueExpression that evaluates to a LenghtValidator.
binding
javax.faces.validator.LengthValidator
Creates a validator and associateds it with the nearest parent
UIComponent. When invoked, the validator ensures that values
are valid longs that lie within the minimum and maximum values specified.
Commonly associated with a h:inputText entity.
Unless otherwise specified, all attributes accept static values or EL expressions.
validateLongRange
org.apache.myfaces.taglib.core.ValidateLongRangeTag
JSP
The smallest value that should be considered valid.
minimum
false
java.lang.Long
The largest value that should be considered valid.
maximum
false
java.lang.Long
A ValueExpression that evaluates to a LongRangeValidator.
binding
javax.faces.validator.LongRangeValidator
Creates a validator and associates it with the nearest parent
UIComponent. During the validation phase (or the apply-request-values
phase for immediate components), if the associated component has any
submitted value and the conversion of that value to the required
type has succeeded then the specified validator type is
invoked to test the validity of the converted value.
<p>
Commonly associated with an h:inputText entity, but may be applied to
any input component.
<p>
Some validators may allow the component to use attributes to define
component-specific validation constraints; see the f:attribute tag.
See also the "validator" attribute of all input components, which
allows a component to specify an arbitrary validation <i>method</i>
(rather than a registered validation type, as this tag does).
<p>
Unless otherwise specified, all attributes accept static values
or EL expressions.
validator
org.apache.myfaces.taglib.core.ValidatorImplTag
empty
The registered ID of the desired Validator.
validatorId
false
java.lang.String
A ValueExpression that evaluates to an implementation of
the javax.faces.validator.Validator interface.
binding
javax.faces.validator.Validator
Adds the specified ValueChangeListener to the nearest parent
UIComponent (which is expected to be a UIInput component).
Whenever the form containing the parent UIComponent is submitted,
an instance of the specified type is created. If the submitted
value from the component is different from the component's current
value then a ValueChangeEvent is queued. When the ValueChangeEvent
is processed (at end of the validate phase for non-immediate components,
or at end of the apply-request-values phase for immediate components)
the object's processValueChange method is invoked.
<p>
Unless otherwise specified, all attributes accept static values
or EL expressions.
valueChangeListener
org.apache.myfaces.taglib.core.ValueChangeListenerTag
empty
The name of a Java class that implements ValueChangeListener.
type
java.lang.String
Value binding expression that evaluates to an implementation of
the javax.faces.event.ValueChangeListener interface.
binding
false
javax.faces.event.ValueChangeListener
Outputs its body as verbatim text. No JSP tags within the verbatim
tag (including JSF tags) are evaluated; the content is treated
simply as literal text to be copied to the response.
<p>
Unless otherwise specified, all attributes accept static values
or EL expressions.
verbatim
org.apache.myfaces.taglib.core.VerbatimTag
JSP
If true, generated markup is escaped. Default: false.
escape
java.lang.Boolean
rendered
false
java.lang.Boolean
Creates a JSF View, which is a container that holds all of the
components that are part of the view.
Unless otherwise specified, all attributes accept static values or EL expressions.
view
org.apache.myfaces.taglib.core.ViewTag
JSP
The locale of this view. Default: the default locale from the configuration file.
locale
java.lang.Object
Id for the RenderKit to use when rendering this page.
renderKitId
false
java.lang.String
MethodBinding pointing to a method that takes a
javax.faces.event.PhaseEvent and returns void,
called before every phase except for restore view.
beforePhase
false
void beforePhase(javax.faces.event.PhaseEvent)
MethodBinding pointing to a method that takes a
javax.faces.event.PhaseEvent and returns void,
called after every phase except for restore view.
afterPhase
false
void afterPhase(javax.faces.event.PhaseEvent)