f


Standard Syntax:
     <%@ taglib prefix="f" uri="http://java.sun.com/jsf/core" %>

XML Syntax:
     <anyxmlelement xmlns:f="http://java.sun.com/jsf/core" />

The core JavaServer Faces custom actions that are independent of any particular RenderKit.

Tag Library Information
Display NameNone
Version2.1
Short Namef
URIhttp://java.sun.com/jsf/core
 

Tag Summary
actionListener

Register an ActionListener instance on the UIComponent associated with the closest parent UIComponent custom action.

attributeAdd an attribute to the UIComponent associated with the closest parent UIComponent custom action.
convertDateTimeRegister a DateTimeConverter instance on the UIComponent associated with the closest parent UIComponent custom action.
convertNumberRegister a NumberConverter instance on the UIComponent associated with the closest parent UIComponent custom action.
converterRegister a named Converter instance on the UIComponent associated with the closest parent UIComponent custom action.
facet

Register a named facet on the UIComponent associated with the closest parent UIComponent custom action.

loadBundleLoad a resource bundle localized for the Locale of the current view, and expose it as a java.util.Map in the request attributes of the current request under the key specified by the value of the "var" attribute of this tag. The Map must behave such that if a get() call is made for a key that does not exist in the Map, the literal string ???KEY??? is returned from the Map, where KEY is the key being looked up in the Map, instead of a MissingResourceException being thrown. If the ResourceBundle does not exist, a JspException must be thrown.
paramAdd a child UIParameter component to the UIComponent associated with the closed parent UIComponent custom action.
viewParam

Used inside of the metada facet of a view, this tag causes a UIViewParameter to be attached as metadata for the current view. Because UIViewParameter extends UIInput all of the attributes and nested child content for any UIInput tags are valid on this tag as well.

phaseListenerRegister a PhaseListener instance on the UIViewRoot in which this tag is nested.
selectItem

Add a child UISelectItem component to the UIComponent associated with the closed parent UIComponent custom action.

selectItems

Add a child UISelectItems component to the UIComponent associated with the closed parent UIComponent custom action.

When iterating over the select items, toString() must be called on the string rendered attribute values.

Version 2 of the specification introduces several new attributes, described below. These are: var, itemValue, itemLabel, itemDescription, itemDisabled, and itemLabelEscaped.

setPropertyActionListener

Register an ActionListener instance on the UIComponent associated with the closest parent UIComponent custom action. This actionListener will cause the value given by the "value" attribute to be set into the ValueExpression given by the "target" attribute.

The implementation of this tag creates a special ActionListener instance and registers it on the ActionSource associated with our most immediate surrounding instance of a tag whose implementation class is a subclass of UIComponentTag. This tag creates no output to the page currently being created.

The ActionListener instance created and installed by this tag has the following behavior and contract.

  • Only create and register the ActionListener instance the first time the component for this tag is created
  • The "target" and "value" tag attributes are ValueExpression instances and are stored unevaluated as instance variables of the listener.
  • When the listener executes, perform the following:
      Call getValue() on the "value" ValueExpression.
      If value of the "value" expression is null, call setValue() on the "target" ValueExpression with the null value.
      If the value of the "value" expression is not null, call getType() on the "value" and "target" ValueExpressions to determine their property types.
      Coerce the value of the "value" expression to the "target" expression value type following the Expression Language coercion rules. Call setValue() on the "target" ValueExpression with the resulting value.
      If either coercion or the execution of setValue() fails throw an AbortProcessingException.
subviewContainer action for all JavaServer Faces core and custom component actions used on a nested page via "jsp:include" or any custom action that dynamically includes another page from the same web application, such as JSTL's "c:import".
validateDoubleRangeRegister a DoubleRangeValidator instance on the UIComponent associated with the closest parent UIComponent custom action.
validateLengthRegister a LengthValidator instance on the UIComponent associated with the closest parent UIComponent custom action.
validateLongRangeRegister a LongRangeValidator instance on the UIComponent associated with the closest parent UIComponent custom action.
validateRegex

A validator that uses the pattern attribute to validate the wrapping component. The entire pattern is matched against the String value of the component. If it matches, it's valid.

validatorRegister a named Validator instance on the UIComponent associated with the closest parent UIComponent custom action.
valueChangeListenerRegister an ValueChangeListener instance on the UIComponent associated with the closest parent UIComponent custom action.
verbatimCreate and register a child UIOutput component associated with the closest parent UIComponent custom action, which renders nested body content.
viewContainer for all JavaServer Faces core and custom component actions used on a page.
 

Tag Library Validator
com.sun.faces.taglib.jsf_core.CoreValidatorThis tag library validator verifies certain semantic restrictions on the use of JavaServer Faces component actions, including the requirement that component tags nested inside a JSTL conditional tag must have a value specified for the "id" attribute.
 

Listeners
com.sun.faces.config.ConfigureListener
 


Java, JSP, and JavaServer Pages are trademarks or registered trademarks of Sun Microsystems, Inc. in the US and other countries. Copyright 2002-3 Sun Microsystems, Inc. 4150 Network Circle Santa Clara, CA 95054, U.S.A. All Rights Reserved.