public class HtmlForm extends UIForm implements ClientBehaviorHolder
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.
Modifier and Type | Class and Description |
---|---|
protected static class |
HtmlForm.PropertyKeys
Properties used by this component
|
Modifier and Type | Field and Description |
---|---|
static java.lang.String |
COMPONENT_TYPE
The standard component type for this component.
|
COMPONENT_FAMILY
ATTRS_WITH_DECLARED_DEFAULT_VALUES, BEANINFO_KEY, bindings, COMPOSITE_COMPONENT_TYPE_KEY, COMPOSITE_FACET_NAME, FACETS_KEY, VIEW_LOCATION_KEY
SEPARATOR_CHAR
Constructor and Description |
---|
HtmlForm() |
Modifier and Type | Method and Description |
---|---|
java.lang.String |
getAccept()
Return the value of the
accept property. |
java.lang.String |
getAcceptcharset()
Return the value of the
acceptcharset property. |
java.lang.String |
getDefaultEventName()
This is a default implementation of
|
java.lang.String |
getDir()
Return the value of the
dir property. |
java.lang.String |
getEnctype()
Return the value of the
enctype property. |
java.util.Collection<java.lang.String> |
getEventNames()
This is a default implementation of |
java.lang.String |
getLang()
Return the value of the
lang property. |
java.lang.String |
getOnclick()
Return the value of the
onclick property. |
java.lang.String |
getOndblclick()
Return the value of the
ondblclick property. |
java.lang.String |
getOnkeydown()
Return the value of the
onkeydown property. |
java.lang.String |
getOnkeypress()
Return the value of the
onkeypress property. |
java.lang.String |
getOnkeyup()
Return the value of the
onkeyup property. |
java.lang.String |
getOnmousedown()
Return the value of the
onmousedown property. |
java.lang.String |
getOnmousemove()
Return the value of the
onmousemove property. |
java.lang.String |
getOnmouseout()
Return the value of the
onmouseout property. |
java.lang.String |
getOnmouseover()
Return the value of the
onmouseover property. |
java.lang.String |
getOnmouseup()
Return the value of the
onmouseup property. |
java.lang.String |
getOnreset()
Return the value of the
onreset property. |
java.lang.String |
getOnsubmit()
Return the value of the
onsubmit property. |
java.lang.String |
getRole()
Return the value of the
role property. |
java.lang.String |
getStyle()
Return the value of the
style property. |
java.lang.String |
getStyleClass()
Return the value of the
styleClass property. |
java.lang.String |
getTarget()
Return the value of the
target property. |
java.lang.String |
getTitle()
Return the value of the
title property. |
void |
setAccept(java.lang.String accept)
Set the value of the
accept property. |
void |
setAcceptcharset(java.lang.String acceptcharset)
Set the value of the
acceptcharset property. |
void |
setDir(java.lang.String dir)
Set the value of the
dir property. |
void |
setEnctype(java.lang.String enctype)
Set the value of the
enctype property. |
void |
setLang(java.lang.String lang)
Set the value of the
lang property. |
void |
setOnclick(java.lang.String onclick)
Set the value of the
onclick property. |
void |
setOndblclick(java.lang.String ondblclick)
Set the value of the
ondblclick property. |
void |
setOnkeydown(java.lang.String onkeydown)
Set the value of the
onkeydown property. |
void |
setOnkeypress(java.lang.String onkeypress)
Set the value of the
onkeypress property. |
void |
setOnkeyup(java.lang.String onkeyup)
Set the value of the
onkeyup property. |
void |
setOnmousedown(java.lang.String onmousedown)
Set the value of the
onmousedown property. |
void |
setOnmousemove(java.lang.String onmousemove)
Set the value of the
onmousemove property. |
void |
setOnmouseout(java.lang.String onmouseout)
Set the value of the
onmouseout property. |
void |
setOnmouseover(java.lang.String onmouseover)
Set the value of the
onmouseover property. |
void |
setOnmouseup(java.lang.String onmouseup)
Set the value of the
onmouseup property. |
void |
setOnreset(java.lang.String onreset)
Set the value of the
onreset property. |
void |
setOnsubmit(java.lang.String onsubmit)
Set the value of the
onsubmit property. |
void |
setRole(java.lang.String role)
Set the value of the
role property. |
void |
setStyle(java.lang.String style)
Set the value of the
style property. |
void |
setStyleClass(java.lang.String styleClass)
Set the value of the
styleClass property. |
void |
setTarget(java.lang.String target)
Set the value of the
target property. |
void |
setTitle(java.lang.String title)
Set the value of the
title property. |
createUniqueId, getContainerClientId, getFamily, invokeOnComponent, isPrependId, isSubmitted, processDecodes, processUpdates, processValidators, setPrependId, setSubmitted, visitTree
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, unsubscribeFromEvent
encodeAll, getClientId, getCompositeComponentParent, getCurrentComponent, getCurrentCompositeComponent, getNamingContainer, getPassThroughAttributes, getResourceBundleMap, getStateHelper, getStateHelper, getTransientStateHelper, getTransientStateHelper, getValueExpression, initialStateMarked, isCompositeComponent, isInView, isVisitable, popComponentFromEL, processEvent, pushComponentToEL, restoreTransientState, saveTransientState, setInView, setValueExpression
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
addClientBehavior, getClientBehaviors
public static final java.lang.String COMPONENT_TYPE
The standard component type for this component.
public java.lang.String getAccept()
Return the value of the accept
property.
Contents: List of content types that a server processing this form will handle correctly
public void setAccept(java.lang.String accept)
Set the value of the accept
property.
accept
- the new property valuepublic java.lang.String getAcceptcharset()
Return the value of the acceptcharset
property.
Contents: List of character encodings for input data that are accepted by the server processing this form.
public void setAcceptcharset(java.lang.String acceptcharset)
Set the value of the acceptcharset
property.
acceptcharset
- the new property valuepublic java.lang.String getDir()
Return the value of the dir
property.
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.
public void setDir(java.lang.String dir)
Set the value of the dir
property.
dir
- the new property valuepublic java.lang.String getEnctype()
Return the value of the enctype
property.
Contents: Content type used to submit the form to the server. If not specified, the default value is "application/x-www-form-urlencoded".
public void setEnctype(java.lang.String enctype)
Set the value of the enctype
property.
enctype
- the new property valuepublic java.lang.String getLang()
Return the value of the lang
property.
Contents: Code describing the language used in the generated markup for this component.
public void setLang(java.lang.String lang)
Set the value of the lang
property.
lang
- the new property valuepublic java.lang.String getOnclick()
Return the value of the onclick
property.
Contents: Javascript code executed when a pointer button is clicked over this element.
public void setOnclick(java.lang.String onclick)
Set the value of the onclick
property.
onclick
- the new property valuepublic java.lang.String getOndblclick()
Return the value of the ondblclick
property.
Contents: Javascript code executed when a pointer button is double clicked over this element.
public void setOndblclick(java.lang.String ondblclick)
Set the value of the ondblclick
property.
ondblclick
- the new property valuepublic java.lang.String getOnkeydown()
Return the value of the onkeydown
property.
Contents: Javascript code executed when a key is pressed down over this element.
public void setOnkeydown(java.lang.String onkeydown)
Set the value of the onkeydown
property.
onkeydown
- the new property valuepublic java.lang.String getOnkeypress()
Return the value of the onkeypress
property.
Contents: Javascript code executed when a key is pressed and released over this element.
public void setOnkeypress(java.lang.String onkeypress)
Set the value of the onkeypress
property.
onkeypress
- the new property valuepublic java.lang.String getOnkeyup()
Return the value of the onkeyup
property.
Contents: Javascript code executed when a key is released over this element.
public void setOnkeyup(java.lang.String onkeyup)
Set the value of the onkeyup
property.
onkeyup
- the new property valuepublic java.lang.String getOnmousedown()
Return the value of the onmousedown
property.
Contents: Javascript code executed when a pointer button is pressed down over this element.
public void setOnmousedown(java.lang.String onmousedown)
Set the value of the onmousedown
property.
onmousedown
- the new property valuepublic java.lang.String getOnmousemove()
Return the value of the onmousemove
property.
Contents: Javascript code executed when a pointer button is moved within this element.
public void setOnmousemove(java.lang.String onmousemove)
Set the value of the onmousemove
property.
onmousemove
- the new property valuepublic java.lang.String getOnmouseout()
Return the value of the onmouseout
property.
Contents: Javascript code executed when a pointer button is moved away from this element.
public void setOnmouseout(java.lang.String onmouseout)
Set the value of the onmouseout
property.
onmouseout
- the new property valuepublic java.lang.String getOnmouseover()
Return the value of the onmouseover
property.
Contents: Javascript code executed when a pointer button is moved onto this element.
public void setOnmouseover(java.lang.String onmouseover)
Set the value of the onmouseover
property.
onmouseover
- the new property valuepublic java.lang.String getOnmouseup()
Return the value of the onmouseup
property.
Contents: Javascript code executed when a pointer button is released over this element.
public void setOnmouseup(java.lang.String onmouseup)
Set the value of the onmouseup
property.
onmouseup
- the new property valuepublic java.lang.String getOnreset()
Return the value of the onreset
property.
Contents: Javascript code executed when this form is reset.
public void setOnreset(java.lang.String onreset)
Set the value of the onreset
property.
onreset
- the new property valuepublic java.lang.String getOnsubmit()
Return the value of the onsubmit
property.
Contents: Javascript code executed when this form is submitted.
public void setOnsubmit(java.lang.String onsubmit)
Set the value of the onsubmit
property.
onsubmit
- the new property valuepublic java.lang.String getRole()
Return the value of the role
property.
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.
public void setRole(java.lang.String role)
Set the value of the role
property.
role
- the new property valuepublic java.lang.String getStyle()
Return the value of the style
property.
Contents: CSS style(s) to be applied when this component is rendered.
public void setStyle(java.lang.String style)
Set the value of the style
property.
style
- the new property valuepublic java.lang.String getStyleClass()
Return the value of the styleClass
property.
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.
public void setStyleClass(java.lang.String styleClass)
Set the value of the styleClass
property.
styleClass
- the new property valuepublic java.lang.String getTarget()
Return the value of the target
property.
Contents: Name of a frame where the response retrieved after this form submit is to be displayed.
public void setTarget(java.lang.String target)
Set the value of the target
property.
target
- the new property valuepublic java.lang.String getTitle()
Return the value of the title
property.
Contents: Advisory title information about markup elements generated for this component.
public void setTitle(java.lang.String title)
Set the value of the title
property.
title
- the new property valuepublic java.util.Collection<java.lang.String> getEventNames()
UIComponentBase
This is a default implementation of ClientBehaviorHolder.getEventNames()
.
UIComponent
does not implement the ClientBehaviorHolder
interface, but provides default implementations for the methods defined by
ClientBehaviorHolder
to simplify subclass implementations. Subclasses that
wish to support the ClientBehaviorHolder
contract must declare that the
subclass implements ClientBehaviorHolder
, and must override this method to
return a non-Empty Collection
of the client event names that the component supports.
getEventNames
in interface ClientBehaviorHolder
getEventNames
in class UIComponentBase
public java.lang.String getDefaultEventName()
UIComponentBase
This is a default implementation of
ClientBehaviorHolder.getDefaultEventName()
. UIComponent
does not
implement the ClientBehaviorHolder
interface, but provides default
implementations for the methods defined by ClientBehaviorHolder
to simplify
subclass implementations. Subclasses that wish to support the
ClientBehaviorHolder
contract must declare that the subclass implements
ClientBehaviorHolder
, and must provide an implementation of
ClientBehaviorHolder.getEventNames()
.
getDefaultEventName
in interface ClientBehaviorHolder
getDefaultEventName
in class UIComponentBase