Class HtmlForm
- All Implemented Interfaces:
ClientBehaviorHolder, NamingContainer, PartialStateHolder, StateHolder, TransientStateHolder, UniqueIdVendor, ComponentSystemEventListener, FacesListener, SystemEventListenerHolder, EventListener
Represents an HTML form element. Child input components will be submitted unless they have been
disabled.
By default, the rendererType property must be set to "jakarta.faces.Form". This value can
be changed by calling the setRendererType() method.
-
Nested Class Summary
Nested ClassesModifier and TypeClassDescriptionprotected static enumProperties used by this component -
Field Summary
FieldsModifier and TypeFieldDescriptionstatic final StringThe standard component type for this component.Fields inherited from class UIForm
COMPONENT_FAMILYModifier and TypeFieldDescriptionstatic final StringThe standard component family for this component.Fields inherited from class UIComponent
ATTRS_WITH_DECLARED_DEFAULT_VALUES, BEANINFO_KEY, COMPOSITE_COMPONENT_TYPE_KEY, COMPOSITE_FACET_NAME, FACETS_KEY, VIEW_LOCATION_KEYModifier and TypeFieldDescriptionstatic final StringThis constant enables one to quickly discover the names of the declared composite component attributes that have been given default values by the composite component author.static final StringThe value of this constant is used as the key in the component attribute map, the value for which is ajava.beans.BeanInfoimplementation describing the composite component.static final StringThe value of this constant is used as the key in the composite component BeanDescriptor for aValueExpressionthat evaluates to thecomponent-typeof the composite component rootUIComponentfor this composite component, if one was declared by the composite component author.static final StringThe value of this constant is used as the key in theMapreturned as described inUIComponent.FACETS_KEYfor thePropertyDescriptordescribing the composite component facet.static final StringThe value of this constant is used as the key in the composite component BeanDescriptor for theMap<PropertyDescriptor>that contains meta-information for the declared facets for this composite component.static final StringThe value of this constant is used as the key in the component attributesMapfor theLocationin the view at which this component instance resides.Fields inherited from interface NamingContainer
SEPARATOR_CHARModifier and TypeFieldDescriptionstatic final charThe default separator character used in component identifiers to demarcate navigation to a child naming container, in caseUINamingContainer.getSeparatorChar(jakarta.faces.context.FacesContext)does not resolve to a valid value. -
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionReturn the value of theacceptproperty.Return the value of theacceptcharsetproperty.This is a default implementation ofClientBehaviorHolder.getDefaultEventName().getDir()Return the value of thedirproperty.Return the value of theenctypeproperty.This is a default implementation ofClientBehaviorHolder.getEventNames().getLang()Return the value of thelangproperty.Return the value of theonclickproperty.Return the value of theondblclickproperty.Return the value of theonkeydownproperty.Return the value of theonkeypressproperty.Return the value of theonkeyupproperty.Return the value of theonmousedownproperty.Return the value of theonmousemoveproperty.Return the value of theonmouseoutproperty.Return the value of theonmouseoverproperty.Return the value of theonmouseupproperty.Return the value of theonresetproperty.Return the value of theonsubmitproperty.getRole()Return the value of theroleproperty.getStyle()Return the value of thestyleproperty.Return the value of thestyleClassproperty.Return the value of thetargetproperty.getTitle()Return the value of thetitleproperty.voidSet the value of theacceptproperty.voidsetAcceptcharset(String acceptcharset) Set the value of theacceptcharsetproperty.voidSet the value of thedirproperty.voidsetEnctype(String enctype) Set the value of theenctypeproperty.voidSet the value of thelangproperty.voidsetOnclick(String onclick) Set the value of theonclickproperty.voidsetOndblclick(String ondblclick) Set the value of theondblclickproperty.voidsetOnkeydown(String onkeydown) Set the value of theonkeydownproperty.voidsetOnkeypress(String onkeypress) Set the value of theonkeypressproperty.voidsetOnkeyup(String onkeyup) Set the value of theonkeyupproperty.voidsetOnmousedown(String onmousedown) Set the value of theonmousedownproperty.voidsetOnmousemove(String onmousemove) Set the value of theonmousemoveproperty.voidsetOnmouseout(String onmouseout) Set the value of theonmouseoutproperty.voidsetOnmouseover(String onmouseover) Set the value of theonmouseoverproperty.voidsetOnmouseup(String onmouseup) Set the value of theonmouseupproperty.voidsetOnreset(String onreset) Set the value of theonresetproperty.voidsetOnsubmit(String onsubmit) Set the value of theonsubmitproperty.voidSet the value of theroleproperty.voidSet the value of thestyleproperty.voidsetStyleClass(String styleClass) Set the value of thestyleClassproperty.voidSet the value of thetargetproperty.voidSet the value of thetitleproperty.Methods inherited from class UIForm
createUniqueId, getContainerClientId, getFamily, invokeOnComponent, isPrependId, isSubmitted, processDecodes, processUpdates, processValidators, setPrependId, setSubmitted, visitTreeModifier and TypeMethodDescriptioncreateUniqueId(FacesContext context, String seed) Generate an identifier for a component.getContainerClientId(FacesContext context) Override theUIComponent.getContainerClientId(FacesContext)to allow users to disable this form from prepending itsclientIdto its descendent'sclientIdsdepending on the value of this form'sUIForm.isPrependId()property.Return the identifier of the component family to which this component belongs.booleaninvokeOnComponent(FacesContext context, String clientId, ContextCallback callback) Starting at this component in the View hierarchy, search for a component with aclientIdequal to the argumentclientIdand, if found, call theContextCallback.invokeContextCallback(FacesContext, UIComponent)method on the argumentcallback, passing the currentFacesContextand the found component as arguments.booleanDeprecated, for removal: This API element is subject to removal in a future version.booleanReturns the current value of thesubmittedproperty.voidprocessDecodes(FacesContext context) OverrideUIComponent.processDecodes(FacesContext)to ensure that the form is decoded before its children.voidprocessUpdates(FacesContext context) OverrideUIComponent.processUpdates(FacesContext)to ensure that the children of thisUIForminstance are only processed ifUIForm.isSubmitted()returnstrue.voidprocessValidators(FacesContext context) OverrideUIComponent.processValidators(FacesContext)to ensure that the children of thisUIForminstance are only processed ifUIForm.isSubmitted()returnstrue.voidsetPrependId(boolean prependId) Deprecated, for removal: This API element is subject to removal in a future version.This attribute breaks theUIComponent.findComponent(String).voidsetSubmitted(boolean submitted) If thisUIForminstance (as opposed to other forms in the page) is experiencing a submit during this request processing lifecycle, this method must be called, withtrueas the argument, during theUIComponent.decode(FacesContext)for thisUIForminstance.booleanvisitTree(VisitContext context, VisitCallback callback) Perform a tree visit starting at this node in the tree.Methods inherited from class UIComponentBase
addClientBehavior, addFacesListener, broadcast, clearInitialState, decode, encodeBegin, encodeChildren, encodeEnd, findComponent, getAttributes, getChildCount, getChildren, getClientBehaviors, getClientId, getFacesContext, getFacesListeners, getFacet, getFacetCount, getFacets, getFacetsAndChildren, getId, getListenersForEventClass, getParent, getPassThroughAttributes, getRenderer, getRendererType, getRendersChildren, isRendered, isTransient, markInitialState, processRestoreState, processSaveState, queueEvent, removeFacesListener, restoreAttachedState, restoreState, saveAttachedState, saveState, setId, setParent, setRendered, setRendererType, setTransient, subscribeToEvent, unsubscribeFromEventModifier and TypeMethodDescriptionvoidaddClientBehavior(String eventName, ClientBehavior behavior) This is a default implementation ofClientBehaviorHolder.addClientBehavior(String, ClientBehavior).protected voidaddFacesListener(FacesListener listener) Add the specifiedFacesListenerto the set of listeners registered to receive event notifications from thisUIComponent.voidbroadcast(FacesEvent event) Broadcast the specifiedFacesEventto all registered event listeners who have expressed an interest in events of this type.voidFor each of the attached objects on this instance that implementPartialStateHolder, callPartialStateHolder.clearInitialState()on the attached object.voiddecode(FacesContext context) Decode any new state of thisUIComponentfrom the request contained in the specifiedFacesContext, and store this state as needed.voidencodeBegin(FacesContext context) If ourrenderedproperty istrue, render the beginning of the current state of thisUIComponentto the response contained in the specifiedFacesContext.voidencodeChildren(FacesContext context) voidencodeEnd(FacesContext context) findComponent(String expression) Search for and return theUIComponentwith anidthat matches the specified search expression (if any), according to the algorithm described below.Return a mutableMaprepresenting the attributes (and properties, see below) associated wth thisUIComponent, keyed by attribute name (which must be a String).intReturn the number of childUIComponents that are associated with thisUIComponent.This is a default implementation ofClientBehaviorHolder.getClientBehaviors().getClientId(FacesContext context) Return a client-side identifier for this component, generating one if necessary.protected FacesContextConvenience method to return theFacesContextinstance for the current request.protected FacesListener[]getFacesListeners(Class clazz) Return an array of registeredFacesListeners that are instances of the specified class.Convenience method to return the named facet, if it exists, ornullotherwise.intReturn the number of facetUIComponents that are associated with thisUIComponent.Return a mutableMaprepresenting the facetUIComponents associated with thisUIComponent, keyed by facet name (which must be a String).getId()Return the component identifier of thisUIComponent.getListenersForEventClass(Class<? extends SystemEvent> eventClass) Return theSystemEventListenerinstances registered on thisUIComponentinstance that are interested in events of typeeventClass.Return the parentUIComponentof thisUIComponent, if any.getPassThroughAttributes(boolean create) This method has the same specification asUIComponent.getPassThroughAttributes()except that it is allowed to returnnullif and only if the argumentcreateisfalseand no pass through attribute data structure exists for this instance.protected RenderergetRenderer(FacesContext context) Convenience method to return theRendererinstance associated with this component, if any; otherwise, returnnull.Return theRenderertype for thisUIComponent(if any).booleanReturn a flag indicating whether this component is responsible for rendering its child components.booleanReturntrueif this component (and its children) should be rendered during the Render Response phase of the request processing lifecycle.booleanIf true, the Object implementing this interface must not participate in state saving or restoring.voidFor each of the attached objects on this instance that implementPartialStateHolder, callPartialStateHolder.markInitialState()on the attached object.voidprocessRestoreState(FacesContext context, Object state) Perform the component tree processing required by the Restore View phase of the request processing lifecycle for all facets of this component, all children of this component, and this component itself, as follows.processSaveState(FacesContext context) Perform the component tree processing required by the state saving portion of the Render Response phase of the request processing lifecycle for all facets of this component, all children of this component, and this component itself, as follows.voidqueueEvent(FacesEvent event) Queue an event for broadcast at the end of the current request processing lifecycle phase.protected voidremoveFacesListener(FacesListener listener) Remove the specifiedFacesListenerfrom the set of listeners registered to receive event notifications from thisUIComponent.static ObjectrestoreAttachedState(FacesContext context, Object stateObj) This method is called byUIComponentsubclasses that need to restore the objects they saved usingUIComponentBase.saveAttachedState(FacesContext, Object).voidrestoreState(FacesContext context, Object state) Perform any processing required to restore the state from the entries in the state Object.static ObjectsaveAttachedState(FacesContext context, Object attachedObject) This method is called byUIComponentsubclasses that want to save one or more attached objects.saveState(FacesContext context) Gets the state of the instance as aSerializableObject.voidSet the component identifier of thisUIComponent(if any).voidsetParent(UIComponent parent) Set the parentUIComponentof thisUIComponent.voidsetRendered(boolean rendered) Set therenderedproperty of thisUIComponent.voidsetRendererType(String rendererType) voidsetTransient(boolean transientFlag) Denotes whether or not the Object implementing this interface must or must not participate in state saving or restoring.voidsubscribeToEvent(Class<? extends SystemEvent> eventClass, ComponentSystemEventListener componentListener) Install the listener instance referenced by argumentcomponentListeneras a listener for events of typeeventClassoriginating from this specific instance ofUIComponent.voidunsubscribeFromEvent(Class<? extends SystemEvent> eventClass, ComponentSystemEventListener componentListener) Remove the listener instance referenced by argumentcomponentListeneras a listener for events of typeeventClassoriginating from this specific instance ofUIComponent.Methods inherited from class UIComponent
encodeAll, getClientId, getCompositeComponentParent, getCurrentComponent, getCurrentCompositeComponent, getFacet, getNamingContainer, getPassThroughAttributes, getResourceBundleMap, getStateHelper, getStateHelper, getTransientStateHelper, getTransientStateHelper, getValueExpression, initialStateMarked, isCompositeComponent, isInView, isVisitable, popComponentFromEL, processEvent, pushComponentToEL, restoreTransientState, saveTransientState, setInView, setValueExpressionModifier and TypeMethodDescriptionvoidencodeAll(FacesContext context) If this component returnstruefromUIComponent.isRendered(), take the following action.Enable Jakarta Expression Language to access theclientIdof a component.static UIComponentgetCompositeComponentParent(UIComponent component) Finds the nearest composite component parent of the specified component.static UIComponentgetCurrentComponent(FacesContext context) Return theUIComponentinstance that is currently processing.static UIComponentgetCurrentCompositeComponent(FacesContext context) Return the closest ancestor component, relative to the component returned fromUIComponent.getCurrentComponent(FacesContext), that is a composite component, ornullif no such component exists.Convenience method to return the named facet using an enum identifier, if it exists, ornullotherwise.Starting with "this", return the closest component in the ancestry that is aNamingContainerornullif none can be found.This is a convenience method that simply callsUIComponent.getPassThroughAttributes(boolean), passingtrueas the argument.Return aMap<String,String>of theResourceBundlefor this component.protected StateHelperReturn theStateHelperinstance used to help this component implementPartialStateHolder.protected StateHelpergetStateHelper(boolean create) LikeUIComponent.getStateHelper(), but only create a state helper instance if the argumentcreatistrue.Return theTransientStateHelperinstance for thisUIComponentinstance.getTransientStateHelper(boolean create) Return theTransientStateHelperinstance for thisUIComponentinstance.jakarta.el.ValueExpressiongetValueExpression(String name) Return theValueExpressionused to calculate the value for the specified attribute or property name, if any.booleanAn implementation ofPartialStateHolder.initialStateMarked(), this method is called by the runtime to test if thePartialStateHolder.markInitialState()method was called.static booleanisCompositeComponent(UIComponent component) Returntrueifcomponentis a composite component, otherwisefalse.booleanisInView()Returntrueif this component is within the view hierarchy otherwisefalseprotected booleanisVisitable(VisitContext context) Returntrueif this component should be visited,falseotherwise.voidpopComponentFromEL(FacesContext context) Pop the currentUIComponentfrom theFacesContextattributes map so that the previousUIComponent, if any, becomes the current component.voidprocessEvent(ComponentSystemEvent event) The default implementation performs the following action.voidpushComponentToEL(FacesContext context, UIComponent component) Push the currentUIComponentthisto theFacesContextattribute map saving the previousUIComponentfor a subsequent call toUIComponent.popComponentFromEL(FacesContext).voidrestoreTransientState(FacesContext context, Object state) For components that need to support the concept of transient state, this method will restore any state saved on a prior call toUIComponent.saveTransientState(FacesContext).saveTransientState(FacesContext context) For components that need to support the concept of transient state, this method will save any state that is known to be transient in nature.voidsetInView(boolean isInView) Updates the status as to whether or not this component is currently within the view hierarchy.voidsetValueExpression(String name, jakarta.el.ValueExpression binding) Set theValueExpressionused to calculate the value for the specified attribute or property name, if any.Methods inherited from class Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, waitMethods inherited from interface ClientBehaviorHolder
addClientBehavior, getClientBehaviorsModifier and TypeMethodDescriptionvoidaddClientBehavior(String eventName, ClientBehavior behavior) Attaches aClientBehaviorto the component implementing this interface for the specified event.Returns a non-null, unmodifiableMapthat contains the theClientBehaviors that have been attached to the component implementing this interface.
-
Field Details
-
COMPONENT_TYPE
-
-
Constructor Details
-
HtmlForm
public HtmlForm()
-
-
Method Details
-
getAccept
Return the value of the
acceptproperty.- Returns:
- the property value
Contents: List of content types that a server processing this form will handle correctly
-
setAccept
Set the value of the
acceptproperty.- Parameters:
accept- the new property value
-
getAcceptcharset
Return the value of the
acceptcharsetproperty.- Returns:
- the property value
Contents: List of character encodings for input data that are accepted by the server processing this form.
-
setAcceptcharset
Set the value of the
acceptcharsetproperty.- Parameters:
acceptcharset- the new property value
-
getDir
Return the value of the
dirproperty.- Returns:
- the property value
Contents: Direction indication for text that does not inherit directionality. Valid values are "LTR" (left-to-right) and "RTL" (right-to-left). These attributes are case sensitive when rendering to XHTML, so care must be taken to have the correct case.
-
setDir
Set the value of the
dirproperty.- Parameters:
dir- the new property value
-
getEnctype
Return the value of the
enctypeproperty.- Returns:
- the property value
Contents: Content type used to submit the form to the server. If not specified, the default value is "application/x-www-form-urlencoded".
-
setEnctype
Set the value of the
enctypeproperty.- Parameters:
enctype- the new property value
-
getLang
Return the value of the
langproperty.- Returns:
- the property value
Contents: Code describing the language used in the generated markup for this component.
-
setLang
Set the value of the
langproperty.- Parameters:
lang- the new property value
-
getOnclick
Return the value of the
onclickproperty.- Returns:
- the property value
Contents: Javascript code executed when a pointer button is clicked over this element.
-
setOnclick
Set the value of the
onclickproperty.- Parameters:
onclick- the new property value
-
getOndblclick
Return the value of the
ondblclickproperty.- Returns:
- the property value
Contents: Javascript code executed when a pointer button is double clicked over this element.
-
setOndblclick
Set the value of the
ondblclickproperty.- Parameters:
ondblclick- the new property value
-
getOnkeydown
Return the value of the
onkeydownproperty.- Returns:
- the property value
Contents: Javascript code executed when a key is pressed down over this element.
-
setOnkeydown
Set the value of the
onkeydownproperty.- Parameters:
onkeydown- the new property value
-
getOnkeypress
Return the value of the
onkeypressproperty.- Returns:
- the property value
Contents: Javascript code executed when a key is pressed and released over this element.
-
setOnkeypress
Set the value of the
onkeypressproperty.- Parameters:
onkeypress- the new property value
-
getOnkeyup
Return the value of the
onkeyupproperty.- Returns:
- the property value
Contents: Javascript code executed when a key is released over this element.
-
setOnkeyup
Set the value of the
onkeyupproperty.- Parameters:
onkeyup- the new property value
-
getOnmousedown
Return the value of the
onmousedownproperty.- Returns:
- the property value
Contents: Javascript code executed when a pointer button is pressed down over this element.
-
setOnmousedown
Set the value of the
onmousedownproperty.- Parameters:
onmousedown- the new property value
-
getOnmousemove
Return the value of the
onmousemoveproperty.- Returns:
- the property value
Contents: Javascript code executed when a pointer button is moved within this element.
-
setOnmousemove
Set the value of the
onmousemoveproperty.- Parameters:
onmousemove- the new property value
-
getOnmouseout
Return the value of the
onmouseoutproperty.- Returns:
- the property value
Contents: Javascript code executed when a pointer button is moved away from this element.
-
setOnmouseout
Set the value of the
onmouseoutproperty.- Parameters:
onmouseout- the new property value
-
getOnmouseover
Return the value of the
onmouseoverproperty.- Returns:
- the property value
Contents: Javascript code executed when a pointer button is moved onto this element.
-
setOnmouseover
Set the value of the
onmouseoverproperty.- Parameters:
onmouseover- the new property value
-
getOnmouseup
Return the value of the
onmouseupproperty.- Returns:
- the property value
Contents: Javascript code executed when a pointer button is released over this element.
-
setOnmouseup
Set the value of the
onmouseupproperty.- Parameters:
onmouseup- the new property value
-
getOnreset
Return the value of the
onresetproperty.- Returns:
- the property value
Contents: Javascript code executed when this form is reset.
-
setOnreset
Set the value of the
onresetproperty.- Parameters:
onreset- the new property value
-
getOnsubmit
Return the value of the
onsubmitproperty.- Returns:
- the property value
Contents: Javascript code executed when this form is submitted.
-
setOnsubmit
Set the value of the
onsubmitproperty.- Parameters:
onsubmit- the new property value
-
getRole
Return the value of the
roleproperty.- Returns:
- the property value
Contents:
Per the WAI-ARIA spec and its relationship to HTML5 (Section title ARIA Role Attriubute), every HTML element may have a "role" attribute whose value must be passed through unmodified on the element on which it is declared in the final rendered markup. The attribute, if specified, must have a value that is a string literal that is, or an EL Expression that evaluates to, a set of space-separated tokens representing the various WAI-ARIA roles that the element belongs to.
It is the page author's responsibility to ensure that the user agent is capable of correctly interpreting the value of this attribute.
-
setRole
Set the value of the
roleproperty.- Parameters:
role- the new property value
-
getStyle
Return the value of the
styleproperty.- Returns:
- the property value
Contents: CSS style(s) to be applied when this component is rendered.
-
setStyle
Set the value of the
styleproperty.- Parameters:
style- the new property value
-
getStyleClass
Return the value of the
styleClassproperty.- Returns:
- the property value
Contents: Space-separated list of CSS style class(es) to be applied when this element is rendered. This value must be passed through as the "class" attribute on generated markup.
-
setStyleClass
Set the value of the
styleClassproperty.- Parameters:
styleClass- the new property value
-
getTarget
Return the value of the
targetproperty.- Returns:
- the property value
Contents: Name of a frame where the response retrieved after this form submit is to be displayed.
-
setTarget
Set the value of the
targetproperty.- Parameters:
target- the new property value
-
getTitle
Return the value of the
titleproperty.- Returns:
- the property value
Contents: Advisory title information about markup elements generated for this component.
-
setTitle
Set the value of the
titleproperty.- Parameters:
title- the new property value
-
getEventNames
Description copied from class:UIComponentBaseThis is a default implementation of
ClientBehaviorHolder.getEventNames().UIComponentdoes not implement theClientBehaviorHolderinterface, but provides default implementations for the methods defined byClientBehaviorHolderto simplify subclass implementations. Subclasses that wish to support theClientBehaviorHoldercontract must declare that the subclass implementsClientBehaviorHolder, and must override this method to return a non-EmptyCollectionof the client event names that the component supports.- Specified by:
getEventNamesin interfaceClientBehaviorHolder- Overrides:
getEventNamesin classUIComponentBase- Returns:
- the collection of event names.
-
getDefaultEventName
Description copied from class:UIComponentBaseThis is a default implementation of
ClientBehaviorHolder.getDefaultEventName().UIComponentdoes not implement theClientBehaviorHolderinterface, but provides default implementations for the methods defined byClientBehaviorHolderto simplify subclass implementations. Subclasses that wish to support theClientBehaviorHoldercontract must declare that the subclass implementsClientBehaviorHolder, and must provide an implementation ofClientBehaviorHolder.getEventNames().- Specified by:
getDefaultEventNamein interfaceClientBehaviorHolder- Overrides:
getDefaultEventNamein classUIComponentBase- Returns:
- the default event name.
-
UIComponent.findComponent(String).