JSF Core Facelets Tag Library.


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

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

This tag library implements the standard JSF core tags for Facelets.

Tag Library Information
Display NameJSF Core Facelets Tag Library.
Version2.0
Short Namef
URIhttp://java.sun.com/jsf/core
 

Tag Summary
importConstants$component.longDescription
subviewBase class for components that provide a new "namespace" for the ids of their child components.

See the javadocs for interface NamingContainer for further details.

viewActionNo Description
viewParamTODO: documentation on jsp and pld are not the same. It appear two params: maxlength and for, but no property getter and setter founded here. If maxlength is used, we can put something like this: JSFJspProperty(name = "maxlength", returnType = "java.lang.String")
paramThis 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.

Unless otherwise specified, all attributes accept static values or EL expressions.

selectItemThis 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.

Unless otherwise specified, all attributes accept static values or EL expressions.

UISelectItem should be nestetd inside a UISelectMany or UISelectOne component, and results in the addition of a SelectItem instance to the list of available options for the parent component

validateBean

BeanValidator is a {@link jakarta.faces.validator.Validator} that doesn't do any validation itself, but delegates validation logic to Bean Validation.

validateDoubleRangeCreates 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. see Javadoc of Faces Specification
validateLengthCreates 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. see Javadoc of Faces Specification
validateLongRangeCreates 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. see Javadoc of Faces Specification
validateRegex

RegexValidator is a {@link jakarta.faces.validator.Validator} that checks the value of the corresponding component against specified pattern using Java regular expression syntax. The regular expression syntax accepted by the RegexValidator class is same as mentioned in class {@link java.util.regex.Pattern} in package java.util.regex.

The following algorithm is implemented:

  • If the passed value is null, exit immediately.
  • If the passed value is not a String, exit with a {@link #NOT_MATCHED_MESSAGE_ID} error message.
  • If no pattern has been set, or pattern resolves to null or an empty String, throw a {@link jakarta.faces.validator.ValidatorException} with a {@link #PATTERN_NOT_SET_MESSAGE_ID} message.
  • If pattern is not a valid regular expression, according to the rules as defined in class {@link java.util.regex.Pattern}, throw a {@link ValidatorException} with a (@link #MATCH_EXCEPTION_MESSAGE_ID} message.
  • If a pattern property has been configured on this {@link jakarta.faces.validator.Validator}, check the passed value against this pattern. If value does not match pattern throw a {@link ValidatorException} containing a {@link #NOT_MATCHED_MESSAGE_ID} message.
validateRequiredCheck if a value is empty, in the same way as set UIInput required property to true (including all rules related to this property).
actionListenerRegister an ActionListener instance on the UIComponent associated with the closest parent UIComponent custom action. See jakarta.faces.event.ActionListener See jakarta.faces.component.ActionSource
ajaxThis tag creates an instance of AjaxBehavior, and associates it with the nearest parent UIComponent that implements ClientBehaviorHolder interface. This tag can be used on single or composite components.

Unless otherwise specified, all attributes accept static values or EL expressions.

According to the documentation, the tag handler implementing this tag should meet the following conditions:

  • Since this tag attach objects to UIComponent instances, and those instances implements Behavior interface, this component should implement BehaviorHolderAttachedObjectHandler interface.
  • f:ajax does not support binding property. In theory we should do something similar to f:convertDateTime tag does: extends from ConverterHandler and override setAttributes method, but in this case BehaviorTagHandlerDelegate has binding property defined, so if we extend from BehaviorHandler we add binding support to f:ajax.
  • This tag works as a attached object handler, but note on the api there is no component to define a target for a behavior. See comment inside apply() method.
attributeSets the specified name and attribute on the parent UIComponent. If the "value" specified is not a literal, it will instead set the ValueExpression on the UIComponent. See jakarta.faces.component.UIComponent#getAttributes() See jakarta.faces.component.UIComponent#setValueExpression(java.lang.String, jakarta.el.ValueExpression)
attributesNo Description
convertDateTimeThis tag associates a date time converter with the nearest parent UIComponent. Unless otherwise specified, all attributes accept static values or EL expressions. see Javadoc of Faces Specification

Register a DateTimeConverter 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.
convertNumberThis 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. see Javadoc of Faces Specification

Register a NumberConverter instance on the UIComponent associated with the closest parent UIComponent custom action.

eventRegisters a listener for a given system event class on the UIComponent associated with this tag.
facetRegister 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 Map) in the request attributes of the current request.
passThroughAttributeNo Description
passThroughAttributesNo Description
phaseListener$tag.longDescription
resetValuesNo Description
selectItemGroup$tag.longDescription
selectItemGroups$tag.longDescription
selectItemsThis tag associates a set of selection list items with the nearest parent UIComponent. The set of SelectItem objects is retrieved via a value-binding.

Unless otherwise specified, all attributes accept static values or EL expressions.

UISelectItems should be nested inside a UISelectMany or UISelectOne component, and results in the addition of one ore more SelectItem instance to the list of available options for the parent component

null

setPropertyActionListener$tag.longDescription
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.
viewCreates a Faces 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.

See the javadoc for this class in the JSF Specification for further details.

Container for all JavaServer Faces core and custom component actions used on a page.

metadataDefines the view metadata. It is expected that this tag contains only one or many f:viewParam tags.
websocket$tag.longDescription
 


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.