public class HtmlCommandButton extends UICommand implements ClientBehaviorHolder
Represents an HTML input
element
for a button of type submit
or reset
.
The label text is specified by the component value.
By default, the rendererType
property must be set to "javax.faces.Button
".
This value can be changed by calling the setRendererType()
method.
Modifier and Type | Class and Description |
---|---|
protected static class |
HtmlCommandButton.PropertyKeys |
Modifier and Type | Field and Description |
---|---|
static 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, CURRENT_COMPONENT, CURRENT_COMPOSITE_COMPONENT, FACETS_KEY, HONOR_CURRENT_COMPONENT_ATTRIBUTES_PARAM_NAME, VIEW_LOCATION_KEY
Constructor and Description |
---|
HtmlCommandButton() |
Modifier and Type | Method and Description |
---|---|
String |
getAccesskey()
Return the value of the
accesskey property. |
String |
getAlt()
Return the value of the
alt property. |
String |
getDefaultEventName()
This is a default implementation of
|
String |
getDir()
Return the value of the
dir property. |
Collection<String> |
getEventNames()
This is a default implementation of
|
String |
getImage()
Return the value of the
image property. |
String |
getLabel()
Return the value of the
label property. |
String |
getLang()
Return the value of the
lang property. |
String |
getOnblur()
Return the value of the
onblur property. |
String |
getOnchange()
Return the value of the
onchange property. |
String |
getOnclick()
Return the value of the
onclick property. |
String |
getOndblclick()
Return the value of the
ondblclick property. |
String |
getOnfocus()
Return the value of the
onfocus property. |
String |
getOnkeydown()
Return the value of the
onkeydown property. |
String |
getOnkeypress()
Return the value of the
onkeypress property. |
String |
getOnkeyup()
Return the value of the
onkeyup property. |
String |
getOnmousedown()
Return the value of the
onmousedown property. |
String |
getOnmousemove()
Return the value of the
onmousemove property. |
String |
getOnmouseout()
Return the value of the
onmouseout property. |
String |
getOnmouseover()
Return the value of the
onmouseover property. |
String |
getOnmouseup()
Return the value of the
onmouseup property. |
String |
getOnselect()
Return the value of the
onselect property. |
String |
getRole()
Return the value of the
role property. |
String |
getStyle()
Return the value of the
style property. |
String |
getStyleClass()
Return the value of the
styleClass property. |
String |
getTabindex()
Return the value of the
tabindex property. |
String |
getTitle()
Return the value of the
title property. |
String |
getType()
Return the value of the
type property. |
boolean |
isDisabled()
Return the value of the
disabled property. |
boolean |
isReadonly()
Return the value of the
readonly property. |
void |
setAccesskey(String accesskey)
Set the value of the
accesskey property. |
void |
setAlt(String alt)
Set the value of the
alt property. |
void |
setDir(String dir)
Set the value of the
dir property. |
void |
setDisabled(boolean disabled)
Set the value of the
disabled property. |
void |
setImage(String image)
Set the value of the
image property. |
void |
setLabel(String label)
Set the value of the
label property. |
void |
setLang(String lang)
Set the value of the
lang property. |
void |
setOnblur(String onblur)
Set the value of the
onblur property. |
void |
setOnchange(String onchange)
Set the value of the
onchange property. |
void |
setOnclick(String onclick)
Set the value of the
onclick property. |
void |
setOndblclick(String ondblclick)
Set the value of the
ondblclick property. |
void |
setOnfocus(String onfocus)
Set the value of the
onfocus property. |
void |
setOnkeydown(String onkeydown)
Set the value of the
onkeydown property. |
void |
setOnkeypress(String onkeypress)
Set the value of the
onkeypress property. |
void |
setOnkeyup(String onkeyup)
Set the value of the
onkeyup property. |
void |
setOnmousedown(String onmousedown)
Set the value of the
onmousedown property. |
void |
setOnmousemove(String onmousemove)
Set the value of the
onmousemove property. |
void |
setOnmouseout(String onmouseout)
Set the value of the
onmouseout property. |
void |
setOnmouseover(String onmouseover)
Set the value of the
onmouseover property. |
void |
setOnmouseup(String onmouseup)
Set the value of the
onmouseup property. |
void |
setOnselect(String onselect)
Set the value of the
onselect property. |
void |
setReadonly(boolean readonly)
Set the value of the
readonly property. |
void |
setRole(String role)
Set the value of the
role property. |
void |
setStyle(String style)
Set the value of the
style property. |
void |
setStyleClass(String styleClass)
Set the value of the
styleClass property. |
void |
setTabindex(String tabindex)
Set the value of the
tabindex property. |
void |
setTitle(String title)
Set the value of the
title property. |
void |
setType(String type)
Set the value of the
type property. |
addActionListener, broadcast, getAction, getActionExpression, getActionListener, getActionListeners, getFamily, getValue, isImmediate, queueEvent, removeActionListener, setAction, setActionExpression, setActionListener, setImmediate, setValue
addClientBehavior, addFacesListener, clearInitialState, decode, encodeBegin, encodeChildren, encodeEnd, findComponent, getAttributes, getChildCount, getChildren, getClientBehaviors, getClientId, getFacesContext, getFacesListeners, getFacet, getFacetCount, getFacets, getFacetsAndChildren, getId, getListenersForEventClass, getParent, getPassThroughAttributes, getRenderer, getRendererType, getRendersChildren, getValueBinding, invokeOnComponent, isRendered, isTransient, markInitialState, processDecodes, processRestoreState, processSaveState, processUpdates, processValidators, removeFacesListener, restoreAttachedState, restoreState, saveAttachedState, saveState, setId, setParent, setRendered, setRendererType, setTransient, setValueBinding, subscribeToEvent, unsubscribeFromEvent
encodeAll, getClientId, getCompositeComponentParent, getContainerClientId, getCurrentComponent, getCurrentCompositeComponent, getNamingContainer, getPassThroughAttributes, getResourceBundleMap, getStateHelper, getStateHelper, getTransientStateHelper, getTransientStateHelper, getValueExpression, initialStateMarked, isCompositeComponent, isInView, isVisitable, popComponentFromEL, processEvent, pushComponentToEL, restoreTransientState, saveTransientState, setInView, setValueExpression, visitTree
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
addClientBehavior, getClientBehaviors
public static final String COMPONENT_TYPE
The standard component type for this component.
public String getAccesskey()
Return the value of the accesskey
property.
Contents: Access key that, when pressed, transfers focus to this element.
public void setAccesskey(String accesskey)
Set the value of the accesskey
property.
public String getAlt()
Return the value of the alt
property.
Contents: Alternate textual description of the element rendered by this component.
public void setAlt(String alt)
Set the value of the alt
property.
public 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(String dir)
Set the value of the dir
property.
public boolean isDisabled()
Return the value of the disabled
property.
Contents: Flag indicating that this element must never receive focus or be included in a subsequent submit. A value of false causes no attribute to be rendered, while a value of true causes the attribute to be rendered as disabled="disabled".
public void setDisabled(boolean disabled)
Set the value of the disabled
property.
public String getImage()
Return the value of the image
property.
Contents:
Absolute or relative URL of the image to be displayed for this button. If specified, this "input" element will be of type "image". Otherwise, it will be of the type specified by the "type" property with a label specified by the "value" property. Note that if the value of this attribute starts with "/", the rendered value for this attribute will be prefixed with the context-root for this application.
public void setImage(String image)
Set the value of the image
property.
public String getLabel()
Return the value of the label
property.
Contents: A localized user presentable name for this component.
public void setLabel(String label)
Set the value of the label
property.
public 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(String lang)
Set the value of the lang
property.
public String getOnblur()
Return the value of the onblur
property.
Contents: Javascript code executed when this element loses focus.
public void setOnblur(String onblur)
Set the value of the onblur
property.
public String getOnchange()
Return the value of the onchange
property.
Contents: Javascript code executed when this element loses focus and its value has been modified since gaining focus.
public void setOnchange(String onchange)
Set the value of the onchange
property.
public 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(String onclick)
Set the value of the onclick
property.
public 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(String ondblclick)
Set the value of the ondblclick
property.
public String getOnfocus()
Return the value of the onfocus
property.
Contents: Javascript code executed when this element receives focus.
public void setOnfocus(String onfocus)
Set the value of the onfocus
property.
public 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(String onkeydown)
Set the value of the onkeydown
property.
public 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(String onkeypress)
Set the value of the onkeypress
property.
public String getOnkeyup()
Return the value of the onkeyup
property.
Contents: Javascript code executed when a key is released over this element.
public void setOnkeyup(String onkeyup)
Set the value of the onkeyup
property.
public 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(String onmousedown)
Set the value of the onmousedown
property.
public 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(String onmousemove)
Set the value of the onmousemove
property.
public 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(String onmouseout)
Set the value of the onmouseout
property.
public 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(String onmouseover)
Set the value of the onmouseover
property.
public 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(String onmouseup)
Set the value of the onmouseup
property.
public String getOnselect()
Return the value of the onselect
property.
Contents: Javascript code executed when text within this element is selected by the user.
public void setOnselect(String onselect)
Set the value of the onselect
property.
public boolean isReadonly()
Return the value of the readonly
property.
Contents: Flag indicating that this component will prohibit changes by the user. The element may receive focus unless it has also been disabled. A value of false causes no attribute to be rendered, while a value of true causes the attribute to be rendered as readonly="readonly".
public void setReadonly(boolean readonly)
Set the value of the readonly
property.
public 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(String role)
Set the value of the role
property.
public String getStyle()
Return the value of the style
property.
Contents: CSS style(s) to be applied when this component is rendered.
public void setStyle(String style)
Set the value of the style
property.
public 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(String styleClass)
Set the value of the styleClass
property.
public String getTabindex()
Return the value of the tabindex
property.
Contents: Position of this element in the tabbing order for the current document. This value must be an integer between 0 and 32767.
public void setTabindex(String tabindex)
Set the value of the tabindex
property.
public String getTitle()
Return the value of the title
property.
Contents: Advisory title information about markup elements generated for this component.
public void setTitle(String title)
Set the value of the title
property.
public String getType()
Return the value of the type
property.
Contents: Type of button to create. Valid values are "submit", "button", and "reset". If not specified, or not a valid value, the default value is "submit".
public void setType(String type)
Set the value of the type
property.
public Collection<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 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
Copyright © 1996-2013, Oracle and/or its affiliates. All Rights Reserved. Use is subject to license terms.