h
Tag commandButton


<p>Renders an HTML "input" element.</p><p>Decode Behavior</p><ul><p>Obtain the <code>Map</code> from the "requestParameterMap" property of the <code>ExternalContext</code>. If the value in the<code>Map</code> for the value of the "clientId" property of the component is <code>null</code>, create a String by concatenating the value of the "clientId" property of the component with the String ".x" (without the quotes). Create another String in the same manner, but concatenate ".y" (without the quotes). If<code>null</code> is the value in the <code>Map</code> for both Strings, return from <code>decode()</code>. If the value in the<code>Map</code> for the value of the "clientId" property of the component is not <code>null</code>, get the value of the "type" attribute, and convert it to lower case. If the result is equal to the String "reset" (without the quotes), return from<code>decode()</code>. Otherwise, create a<code>javax.faces.event.ActionEvent</code> around the component, and pass it to the <code>queueEvent()</code> method of the component, which must be an instance of<code>UICommand</code>.</p></ul><p>Encode Behavior</p><ul><p>Render the clientId of the component as the value of the "name" attribute. Render the current value of the component as the value of the "value" attribute. If the "styleClass" attribute is specified, render its value as the value of the "class" attribute.</p></ul>


Tag Information
Tag Classcom.sun.faces.taglib.html_basic.CommandButtonTag
TagExtraInfo Classcom.sun.faces.taglib.FacesTagExtraInfo
Body ContentJSP
Display NameNone

Attributes
NameRequiredRequest-timeTypeDescription
actionfalsefalsejava.lang.String MethodBinding representing the application action to invoke when this component is activated by the user. The expression must evaluate to a public method that takes no parameters, and returns a String (the logical outcome) which is passed to the NavigationHandler for this application.
actionListenerfalsefalsejava.lang.String MethodBinding representing an action listener method that will be notified when this component is activated by the user. The expression must evaluate to a public method that takes an ActionEvent parameter, with a return type of void.
idfalsefalsejava.lang.String The component identifier for this component. This value must be unique within the closest parent component that is a naming container.
immediatefalsefalsejava.lang.String Flag indicating that, if this component is activated by the user, notifications should be delivered to interested listeners and actions immediately (that is, during Apply Request Values phase) rather than waiting until Invoke Application phase.
renderedfalsefalsejava.lang.String Flag indicating whether or not this component should be rendered (during Render Response Phase), or processed on any subsequent form submit.
valuefalsefalsejava.lang.String The current value of this component.
accesskeyfalsefalsejava.lang.String Access key that, when pressed, transfers focus to this element.
altfalsefalsejava.lang.String Alternate textual description of the element rendered by this component.
dirfalsefalsejava.lang.String Direction indication for text that does not inherit directionality. Valid values are "LTR" (left-to-right) and "RTL" (right-to-left).
disabledfalsefalsejava.lang.String Flag indicating that this element must never receive focus or be included in a subsequent submit.
imagefalsefalsejava.lang.String 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.
langfalsefalsejava.lang.String Code describing the language used in the generated markup for this component.
onblurfalsefalsejava.lang.String Javascript code executed when this element loses focus.
onchangefalsefalsejava.lang.String Javascript code executed when this element loses focus and its value has been modified since gaining focus.
onclickfalsefalsejava.lang.String Javascript code executed when a pointer button is clicked over this element.
ondblclickfalsefalsejava.lang.String Javascript code executed when a pointer button is double clicked over this element.
onfocusfalsefalsejava.lang.String Javascript code executed when this element receives focus.
onkeydownfalsefalsejava.lang.String Javascript code executed when a key is pressed down over this element.
onkeypressfalsefalsejava.lang.String Javascript code executed when a key is pressed and released over this element.
onkeyupfalsefalsejava.lang.String Javascript code executed when a key is released over this element.
onmousedownfalsefalsejava.lang.String Javascript code executed when a pointer button is pressed down over this element.
onmousemovefalsefalsejava.lang.String Javascript code executed when a pointer button is moved within this element.
onmouseoutfalsefalsejava.lang.String Javascript code executed when a pointer button is moved away from this element.
onmouseoverfalsefalsejava.lang.String Javascript code executed when a pointer button is moved onto this element.
onmouseupfalsefalsejava.lang.String Javascript code executed when a pointer button is released over this element.
onselectfalsefalsejava.lang.String Javascript code executed when text within this element is selected by the user.
readonlyfalsefalsejava.lang.String Flag indicating that this component will prohibit changes by the user. The element may receive focus unless it has also been disabled.
stylefalsefalsejava.lang.String CSS style(s) to be applied when this component is rendered.
styleClassfalsefalsejava.lang.String 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.
tabindexfalsefalsejava.lang.String Position of this element in the tabbing order for the current document. This value must be an integer between 0 and 32767.
titlefalsefalsejava.lang.String Advisory title information about markup elements generated for this component.
typefalsefalsejava.lang.String Type of button to create. Valid values are "submit" and "reset". If not specified, or not a valid value, the default value is "submit".
bindingfalsefalsejava.lang.String The value binding expression linking this component to a property in a backing bean

Variables
No Variables Defined.


Output Generated by TLDDoc, a Sun Microsystems, Inc. CoolStuff project. 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.