commandButton (jsf-ri-1

Overview

Library

Tag

Help

FRAMES NO FRAMES

h
Tag commandButton

Renders an HTML "input" element.

Decode Behavior

Obtain the Map from the "requestParameterMap" property of the ExternalContext. If the value in theMap for the value of the "clientId" property of the component is null, 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). Ifnull is the value in the Map for both Strings, return from decode(). If the value in theMap for the value of the "clientId" property of the component is not null, 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 fromdecode(). Otherwise, create ajavax.faces.event.ActionEvent around the component, and pass it to the queueEvent() method of the component, which must be an instance ofUICommand.

Encode Behavior

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.

Tag Information
Tag Class	com.sun.faces.taglib.html_basic.CommandButtonTag
TagExtraInfo Class	com.sun.faces.taglib.FacesTagExtraInfo
Body Content	JSP
Display Name	None

Attributes
Name	Required	Request-time	Type	Description
action	false	false	`java.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.
actionListener	false	false	`java.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.
id	false	false	`java.lang.String`	The component identifier for this component. This value must be unique within the closest parent component that is a naming container.
immediate	false	false	`java.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.
rendered	false	false	`java.lang.String`	Flag indicating whether or not this component should be rendered (during Render Response Phase), or processed on any subsequent form submit.
value	false	false	`java.lang.String`	The current value of this component.
accesskey	false	false	`java.lang.String`	Access key that, when pressed, transfers focus to this element.
alt	false	false	`java.lang.String`	Alternate textual description of the element rendered by this component.
dir	false	false	`java.lang.String`	Direction indication for text that does not inherit directionality. Valid values are "LTR" (left-to-right) and "RTL" (right-to-left).
disabled	false	false	`java.lang.String`	Flag indicating that this element must never receive focus or be included in a subsequent submit.
image	false	false	`java.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.
lang	false	false	`java.lang.String`	Code describing the language used in the generated markup for this component.
onblur	false	false	`java.lang.String`	Javascript code executed when this element loses focus.
onchange	false	false	`java.lang.String`	Javascript code executed when this element loses focus and its value has been modified since gaining focus.
onclick	false	false	`java.lang.String`	Javascript code executed when a pointer button is clicked over this element.
ondblclick	false	false	`java.lang.String`	Javascript code executed when a pointer button is double clicked over this element.
onfocus	false	false	`java.lang.String`	Javascript code executed when this element receives focus.
onkeydown	false	false	`java.lang.String`	Javascript code executed when a key is pressed down over this element.
onkeypress	false	false	`java.lang.String`	Javascript code executed when a key is pressed and released over this element.
onkeyup	false	false	`java.lang.String`	Javascript code executed when a key is released over this element.
onmousedown	false	false	`java.lang.String`	Javascript code executed when a pointer button is pressed down over this element.
onmousemove	false	false	`java.lang.String`	Javascript code executed when a pointer button is moved within this element.
onmouseout	false	false	`java.lang.String`	Javascript code executed when a pointer button is moved away from this element.
onmouseover	false	false	`java.lang.String`	Javascript code executed when a pointer button is moved onto this element.
onmouseup	false	false	`java.lang.String`	Javascript code executed when a pointer button is released over this element.
onselect	false	false	`java.lang.String`	Javascript code executed when text within this element is selected by the user.
readonly	false	false	`java.lang.String`	Flag indicating that this component will prohibit changes by the user. The element may receive focus unless it has also been disabled.
style	false	false	`java.lang.String`	CSS style(s) to be applied when this component is rendered.
styleClass	false	false	`java.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.
tabindex	false	false	`java.lang.String`	Position of this element in the tabbing order for the current document. This value must be an integer between 0 and 32767.
title	false	false	`java.lang.String`	Advisory title information about markup elements generated for this component.
type	false	false	`java.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".
binding	false	false	`java.lang.String`	The value binding expression linking this component to a property in a backing bean

Variables
No Variables Defined.

Overview

Library

Tag

Help

FRAMES NO FRAMES

Output Generated by Tag Library Documentation Generator. Java, JSP, and JavaServer Pages are trademarks or registered trademarks of Sun Microsystems, Inc. in the US and other countries. Copyright 2002-4 Sun Microsystems, Inc. 4150 Network Circle Santa Clara, CA 95054, U.S.A. All Rights Reserved.

h Tag commandButton

h
Tag commandButton