Apache MyFaces HTML
Tag commandLink


This tag renders as an HTML a element. Unless otherwise specified, all attributes accept static values or EL expressions.


Tag Information
Tag Classorg.apache.myfaces.taglib.html.HtmlCommandLinkTag
TagExtraInfo ClassNone
Body ContentJSP
Display NameNone

Attributes
NameRequiredRequest-timeTypeDescription
idfalsefalsejava.lang.StringThe developer-assigned ID of this component. The ID must be unique within the scope of the tag's enclosing naming container (e.g. h:form or f:subview). This value must be a static value.
bindingfalsefalsejavax.el.ValueExpression
(must evaluate to javax.faces.component.UIComponent)
Identifies a backing bean property (of type UIComponent or appropriate subclass) to bind to this component instance. This value must be an EL expression.
renderedfalsefalsejavax.el.ValueExpression
(must evaluate to java.lang.Boolean)
A boolean value that indicates whether this component should be rendered. Default value: true.
immediatefalsefalsejavax.el.ValueExpression
(must evaluate to boolean)
A boolean value that identifies the phase during which action events should fire. During normal event processing, action methods and action listener methods are fired during the "invoke application" phase of request processing. If this attribute is set to "true", these methods are fired instead at the end of the "apply request values" phase.
valuefalsefalsejavax.el.ValueExpression
(must evaluate to java.lang.Object)
The initial value of this component.
actionfalsefalsejavax.el.MethodExpression
(signature must match java.lang.Object myMethod())
Specifies the action to take when this command is invoked. If the value is an expression, it is expected to be a method binding EL expression that identifies an action method. An action method accepts no parameters and has a String return value, called the action outcome, that identifies the next view displayed. The phase that this event is fired in can be controlled via the immediate attribute. If the value is a string literal, it is treated as a navigation outcome for the current view. This is functionally equivalent to a reference to an action method that returns the string literal.
actionListenerfalsefalsejavax.el.MethodExpression
(signature must match void myMethod(javax.faces.event.ActionEvent))
A method binding EL expression that identifies an action listener method to be invoked if this component is activated by the user. An action listener method accepts a parameter of type javax.faces.event.ActionEvent and returns void. The phase that this event is fired in can be controlled via the immediate attribute.
stylefalsefalsejavax.el.ValueExpression
(must evaluate to java.lang.Object)
CSS styling instructions.
styleClassfalsefalsejavax.el.ValueExpression
(must evaluate to java.lang.Object)
The CSS class for this element. Corresponds to the HTML 'class' attribute.
dirfalsefalsejavax.el.ValueExpression
(must evaluate to java.lang.Object)
The direction of text display, either 'ltr' (left-to-right) or 'rtl' (right-to-left).
langfalsefalsejavax.el.ValueExpression
(must evaluate to java.lang.Object)
The base language of this document.
titlefalsefalsejavax.el.ValueExpression
(must evaluate to java.lang.Object)
An advisory title for this element. Often used by the user agent as a tooltip.
onclickfalsefalsejavax.el.ValueExpression
(must evaluate to java.lang.Object)
Script to be invoked when the element is clicked.
ondblclickfalsefalsejavax.el.ValueExpression
(must evaluate to java.lang.Object)
Script to be invoked when the element is double-clicked.
onmousedownfalsefalsejavax.el.ValueExpression
(must evaluate to java.lang.Object)
Script to be invoked when the pointing device is pressed over this element.
onmouseupfalsefalsejavax.el.ValueExpression
(must evaluate to java.lang.Object)
Script to be invoked when the pointing device is released over this element.
onmouseoverfalsefalsejavax.el.ValueExpression
(must evaluate to java.lang.Object)
Script to be invoked when the pointing device is moved into this element.
onmousemovefalsefalsejavax.el.ValueExpression
(must evaluate to java.lang.Object)
Script to be invoked when the pointing device is moved while it is in this element.
onmouseoutfalsefalsejavax.el.ValueExpression
(must evaluate to java.lang.Object)
Script to be invoked when the pointing device is moves out of this element.
onkeypressfalsefalsejavax.el.ValueExpression
(must evaluate to java.lang.Object)
Script to be invoked when a key is pressed over this element.
onkeydownfalsefalsejavax.el.ValueExpression
(must evaluate to java.lang.Object)
Script to be invoked when a key is pressed down over this element.
onkeyupfalsefalsejavax.el.ValueExpression
(must evaluate to java.lang.Object)
Script to be invoked when a key is released over this element.
onblurfalsefalsejavax.el.ValueExpression
(must evaluate to java.lang.Object)
Specifies a script to be invoked when the element loses focus.
onfocusfalsefalsejavax.el.ValueExpression
(must evaluate to java.lang.Object)
Specifies a script to be invoked when the element receives focus.
accesskeyfalsefalsejavax.el.ValueExpression
(must evaluate to java.lang.Object)
Sets the access key for this element.
charsetfalsefalsejavax.el.ValueExpression
(must evaluate to java.lang.Object)
Specifies the character encoding of the linked resource.
coordsfalsefalsejavax.el.ValueExpression
(must evaluate to java.lang.Object)
The position and the shape of the hotspot.
hreflangfalsefalsejavax.el.ValueExpression
(must evaluate to java.lang.Object)
The language code for teh link.
disabledfalsefalsejavax.el.ValueExpression
(must evaluate to boolean)
When true, this element cannot receive focus.
relfalsefalsejavax.el.ValueExpression
(must evaluate to java.lang.Object)
A space-separated list of links defining the relationship from the current document to the anchor specified by this hyperlink
revfalsefalsejavax.el.ValueExpression
(must evaluate to java.lang.Object)
A space-separated list of Reverselinks.
shapefalsefalsejavax.el.ValueExpression
(must evaluate to java.lang.Object)
The 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).
targetfalsefalsejavax.el.ValueExpression
(must evaluate to java.lang.Object)
Names the frame that should display content generated by invoking this action.
tabindexfalsefalsejavax.el.ValueExpression
(must evaluate to java.lang.Object)
Specifies the position of this element within the tab order of the document.
typefalsefalsejavax.el.ValueExpression
(must evaluate to java.lang.Object)
A hint to the user agent about the content type of the linked resource.

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.