1.0
1.2
f
http://java.sun.com/jsf/core
JSF core tag library.
This tag library implements the standard JSF core tags.
org.apache.myfaces.webapp.StartupServletContextListener
actionListener
org.apache.myfaces.taglib.core.ActionListenerTag
empty
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.
type
true
false
The fully qualified class name of the ActionListener class.
attribute
javax.faces.webapp.AttributeTag
empty
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.
name
true
false
The name of the attribute.
value
true
false
The attribute's value.
convertDateTime
org.apache.myfaces.taglib.core.ConvertDateTimeTag
empty
This tag associates a date time converter with the nearest parent UIComponent.
Unless otherwise specified, all attributes accept static values or EL expressions.
dateStyle
false
false
The style of the date. Values include: default, short, medium, long, and full.
locale
false
false
The name of the locale to be used, instead of the default.
pattern
false
false
A custom Date formatting pattern, in the format used by java.text.SimpleDateFormat.
timeStyle
false
false
The style of the time. Values include: default, short, medium, long, and full.
timeZone
false
false
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).
type
false
false
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.
converter
javax.faces.webapp.ConverterTag
empty
This tag creates an instance of the specified Converter, and
associates it with the nearest parent UIComponent.
converterId
true
false
The converter's registered ID.
convertNumber
org.apache.myfaces.taglib.core.ConvertNumberTag
empty
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.
currencyCode
false
false
ISO 4217 currency code
currencySymbol
false
false
The currency symbol used to format a currency value. Defaults
to the currency symbol for locale.
groupingUsed
false
false
Specifies whether output will contain grouping separators. Default: true.
integerOnly
false
false
Specifies whether only the integer part of the input will be parsed. Default: false.
locale
false
false
The name of the locale to be used, instead of the default as
specified in the faces configuration file.
maxFractionDigits
false
false
The maximum number of digits in the fractional portion of the number.
maxIntegerDigits
false
false
The maximum number of digits in the integer portion of the number.
minFractionDigits
false
false
The minimum number of digits in the fractional portion of the number.
minIntegerDigits
false
false
The minimum number of digits in the integer portion of the number.
pattern
false
false
A custom Date formatting pattern, in the format used by java.text.SimpleDateFormat.
type
false
false
The type of formatting/parsing to be performed. Values include:
number, currency, and percent. Default: number.
facet
javax.faces.webapp.FacetTag
JSP
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.
name
true
false
The name of the facet to be created. This must be a static value.
loadBundle
org.apache.myfaces.taglib.core.LoadBundleTag
empty
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.
basename
true
false
The base name of the resource bundle.
var
true
false
The name of the variable in request scope that the resources
are saved to. This must be a static value.
param
org.apache.myfaces.taglib.core.ParamTag
empty
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.
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.
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.
name
false
false
java.lang.String
A String containing the name of the parameter.
value
true
false
java.lang.String
The value of this parameter.
selectItem
org.apache.myfaces.taglib.core.SelectItemTag
empty
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.
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.
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.
itemDisabled
false
false
java.lang.String
If true, this component will not be saved during state saving.
itemDescription
false
false
java.lang.String
An optional description for this item.
itemLabel
false
false
java.lang.String
The locale-specific label that will be displayed to the user for this item.
itemValue
false
false
java.lang.String
The value of this item, of the same type as the parent component's value.
value
false
false
java.lang.String
An EL expression that refers to a javax.faces.model.SelectItem instance.
selectItems
org.apache.myfaces.taglib.core.SelectItemsTag
empty
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.
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.
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.
value
false
false
java.lang.String
An EL expression that specifies the contents of the selection list.
The expression can refer to one of the following:
<ol>
<li>A single SelectItem</li>
<li>An array or Collection of SelectItem instances</li>
<li>A Map. The contents of the Map are used to create SelectItem
instances, where the SelectItem's label is the map's key value,
and the SelectItem's value is the map's value. When using a
map, it is recommended that an ordered implementation such as
java.util.TreeMap is used.</li>
</ol>
The value properties of each of the SelectItems must be of the same
basic type as the parent component's value.
subview
org.apache.myfaces.taglib.core.SubviewTag
JSP
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.
id
true
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.
validateDoubleRange
org.apache.myfaces.taglib.core.ValidateDoubleRangeTag
empty
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.
minimum
false
false
java.lang.String
The smallest value that should be considered valid.
maximum
false
false
java.lang.String
The largest value that should be considered valid.
validateLength
org.apache.myfaces.taglib.core.ValidateLengthTag
empty
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.
minimum
false
false
java.lang.String
The smallest value that should be considered valid.
maximum
false
false
java.lang.String
The largest value that should be considered valid.
validateLongRange
org.apache.myfaces.taglib.core.ValidateLongRangeTag
empty
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.
minimum
false
false
java.lang.String
The smallest value that should be considered valid.
maximum
false
false
java.lang.String
The largest value that should be considered valid.
validator
javax.faces.webapp.ValidatorTag
empty
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.
validatorId
false
false
java.lang.String
The registered ID of the desired Validator.
valueChangeListener
org.apache.myfaces.taglib.core.ValueChangeListenerTag
empty
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.
type
true
false
The name of a Java class that implements ValueChangeListener.
verbatim
org.apache.myfaces.taglib.core.VerbatimTag
JSP
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.
escape
false
false
If true, generated markup is escaped. Default: false.
view
org.apache.myfaces.taglib.core.ViewTag
JSP
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.
locale
false
false
The locale of this view. Default: the default locale from the configuration file.