ICE Components
Tag commandLink


Render an HTML "a" anchor element that acts like a form submit button when clicked.

General Behaviour

Both the encode and decode behavior require the ability to get the id/name for a hidden field whose value is set by the JavaScript form submit. This name must be constructed as follows:

In the following text, this String is called hiddenFieldName.

Decode Behavior

Encode Behavior



Tag Information
Tag Classcom.icesoft.faces.component.CommandLinkTag
TagExtraInfo ClassNone
Body ContentJSP
Display NameNone

Attributes
NameRequiredRequest-timeTypeDescription
accesskeyfalsefalsejava.lang.StringAccess key that, when pressed, transfers focus to this element.
actionfalsefalsejava.lang.StringMethodBinding representing the application action to invoke when this component is activated by the user. The expression must evaluate to a either a String or 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.StringMethodBinding 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.
bindingfalsefalsejava.lang.StringThe value binding expression linking this component to a property in a backing bean
charsetfalsefalsejava.lang.StringThe character encoding of the resource designated by this hyperlink.
coordsfalsefalsejava.lang.StringThe position and shape of the hot spot on the screen (for use in client-side image maps).
dirfalsefalsejava.lang.StringDirection indication for text that does not inherit directionality. Valid values are "LTR" (left-to-right) and "RTL" (right-to-left).
disabledfalsefalsejava.lang.StringFlag indicating that this element must never receive focus or be included in a subsequent submit.
effectfalsefalsejava.lang.StringThe Javascript Effect
enabledOnUserRolefalsefalsejava.lang.StringIf user is in given role, this component will be rendered normally. If not, the component will be in disabled state.
hreflangfalsefalsejava.lang.StringThe language code of the resource designated by this hyperlink.
idfalsefalsejava.lang.StringThe component identifier for this component. This value must be unique within the closest parent component that is a naming container.
immediatefalsefalsejava.lang.StringFlag indicating that this component's value must be converted and validated immediately (that is, during Apply Request Values phase), rather than waiting until Process Validations phase.
langfalsefalsejava.lang.StringCode describing the language used in the generated markup for this component.
onblurfalsefalsejava.lang.StringJavascript code executed when this element loses focus.
onclickfalsefalsejava.lang.StringNo Description
onclickeffectfalsefalsejava.lang.StringEffect invoked on onclick event
ondblclickfalsefalsejava.lang.StringNo Description
ondblclickeffectfalsefalsejava.lang.StringEffect invoked on ondblclick event
onfocusfalsefalsejava.lang.StringJavascript code executed when this element receives focus.
onkeydownfalsefalsejava.lang.StringNo Description
onkeydowneffectfalsefalsejava.lang.StringEffect invoked on onkeydown event
onkeypressfalsefalsejava.lang.StringNo Description
onkeypresseffectfalsefalsejava.lang.StringEffect invoked on onkeypress event
onkeyupfalsefalsejava.lang.StringNo Description
onkeyupeffectfalsefalsejava.lang.StringEffect invoked on onkeyup event
onmousedownfalsefalsejava.lang.StringNo Description
onmousedowneffectfalsefalsejava.lang.StringEffect invoked on onmousedown event
onmousemovefalsefalsejava.lang.StringNo Description
onmousemoveeffectfalsefalsejava.lang.StringEffect invoked on onmousemove event
onmouseoutfalsefalsejava.lang.StringNo Description
onmouseouteffectfalsefalsejava.lang.StringEffect invoked on onmouse event
onmouseoverfalsefalsejava.lang.StringNo Description
onmouseovereffectfalsefalsejava.lang.StringEffect invoked on onmouseover event
onmouseupfalsefalsejava.lang.StringNo Description
onmouseupeffectfalsefalsejava.lang.StringEffect invoked on onmouseup event
panelConfirmationfalsefalsejava.lang.StringThe id of the ice:panelConfirmation component associated to this link.
partialSubmitfalsefalsejava.lang.StringEnable component to perform partial submit. Default value is false.
relfalsefalsejava.lang.StringThe relationship from the current document to the anchor specified by this hyperlink. The value of this attribute is a space-separated list of link types.
renderedfalsefalsejava.lang.StringFlag indicating whether or not this component should be rendered (during Render Response Phase), or processed on any subsequent form submit.
renderedOnUserRolefalsefalsejava.lang.StringIf user is in given role, this component will be rendered normally. If not, nothing is rendered and the body of this tag will be skipped.
revfalsefalsejava.lang.StringA reverse link from the anchor specified by this hyperlink to the current document. The value of this attribute is a space-separated list of link types.
shapefalsefalsejava.lang.StringThe shape of the hot spot on the screen (for use in client-side image maps). Valid values are: default (entire region); rect (rectangular region); circle (circular region); and poly (polygonal region).
stylefalsefalsejava.lang.StringCSS style(s) to be applied when this component is rendered.
styleClassfalsefalsejava.lang.StringThe base name for all style classes. Default value is iceCmdLnk if enabled and iceCmdLnk-dis if disabled.
tabindexfalsefalsejava.lang.StringPosition of this element in the tabbing order for the current document. This value must be an integer between 0 and 32767.
targetfalsefalsejava.lang.StringName of a frame where the resource retrieved via this hyperlink is to be displayed.
titlefalsefalsejava.lang.StringAdvisory title information about markup elements generated for this component.
typefalsefalsejava.lang.StringThe content type of the resource designated by this hyperlink.
valuefalsefalsejava.lang.StringThe current value of this component.
visiblefalsefalsejava.lang.StringSet the visibility of this component. When false CSS style is set to display:none

Variables
No Variables Defined.


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.