JSF HTML Tag Reference - Command Link

Documentation

Search

	1.	Introduction
	2.	Getting Started
	3.	Developing Web Sites
	4.	Using Components
	5.	Internationalization
	6.	Code View Support
	7.	Design View Support
	8.	Keyboard Shortcuts
	9.	Tag Object Toolbars
	10.	JSF Server Behaviors
	11.	Property Inspectors
	12.	JSF Tag Reference

12. JSF Tag Reference

Contents > JSF Tag Reference > JSF HTML Tags

10. JSF HTML Tag Reference

Contents > JSF HTML Tag Reference > h:commandLink

h:commandLink

The commandLink tag renders an HTML anchor tag that behaves like a form submit button and that can be associated with a backing bean or ActionListener class for event handling purposes. The display value of the link can also be obtained from a message bundle to support internationalization (I18N).

Example:

<h:commandLink id="link1" value="#{bundle.checkoutLabel}" action="#{shoppingCartBean.checkout}" />

HTML Output

<a href="#" onclick="someEvent();" id="form:link1">Check Out</a>

Tag Attributes

accesskey	String

The accesskey attribute is a standard HTML attribute that sets the access key that transfers focus to this element when pressed.

action	String

The action attribute accepts a method-binding expression for a backing bean action method to invoke when this component is activated by the user. An action method must be a public method with no parameters that returns a String. The returned string represents the logical outcome of the action (eg. "success", "failure", etc.) and is used by the JavaServer Faces MVC framework to determine which view to display next.

actionListener	String

The actionListener attribute accepts a method-binding expression for a backing bean action listener method that will be notified when this component is activated by the user. An action listener method must be a public method with an javax.faces.event.ActionEvent parameter and a void return type.

binding	String

The value-binding expression linking this component tag to a backing bean property.

charset	String

The charset attribute identifies the character encoding of the resource linked to by this hyperlink.

coords	String

The coords attribute sets the position and shape of the hotspot on the screen when using this link with a client-side image map.

dir	String

The dir attribute is a standard HTML attribute that overrides the default text directionality for this component. The values accepted for this component are "LTR" (left-to-right) and "RTL" (right-to-left).

hreflang	String

The hreflang attribute identifies the language code of the resource link to by this hyperlink.

id	String

The unique identifier value for this component. The value must be unique within the closest naming container.

immediate	String

The immediate attribute is a boolean flag indicating that component events should be sent to registered event listeners immediately rather than after the validation phase of the JSF request processing lifecycle. The immediate flag allows you bypass JSF validation for a particular component.

lang	String

The lang attribute is a standard HTML attribute that sets the code describing the language to be used in the markup generated by this component.

onblur	String

The onblur attribute sets the JavaScript code to execute when this element loses focus.

ondblclick	String

The ondblclick attribute sets the JavaScript code to execute when the mouse pointer is double-clicked over this element.

onfocus	String

The onfocus attribute sets the JavaScript code to execute when the element receives focus.

onkeydown	String

The onkeydown attribute sets the JavaScript code to execute when a key is pressed down over this element.

onkeypress	String

The onkeypress attribute sets the JavaScript code to execute when a key is pressed and released over this element.

onkeyup	String

The onkeyup attribute sets the JavaScript code to execute when a key is released over this element.

onmousedown	String

The onmousedown attribute sets the JavaScript code to execute when the mouse pointer is pressed down over this element.

onmousemove	String

The onmousemove attribute sets the JavaScript code to execute when the mouse pointer is moved within this element.

onmouseout	String

The onmouseout attribute sets the JavaScript code to execute when the mouse pointer is moved away from this element.

onmouseover	String

The onmouseover attribute sets the JavaScript code to execute when the mouse pointer is moved onto this element.

onmouseup	String

The onmouseup attribute sets the JavaScript code to execute when the mouse button is released over this element.

rel	String

The rel attribute identifies the 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.

rendered	String

A value-binding expression that evaluates to a Boolean condition indicating if this component should be rendered.

rev	String

The rev attribute identifies a 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.

shape	String

style	String

The style attribute sets the CSS style definition to be applied to this component when it is rendered.

styleClass	String

The styleClass attribute sets the CSS class to apply to this component when it is rendered.

tabindex	String

The tabindex attribute is a standard HTML attribute that sets the order in which this element receives focus when the user cycles through the elements using the TAB key. The value for this attribute must be an integer between 0 and 32767.

target	String

The target attribute identifies the name of a frame into which the resource retrieved by this hyperlink should be displayed.

title	String

The title attribute is a standard HTML attribute that sets the tooltip text to display for the rendered component.

type	String

value	String

The value attribute sets the current value for this component.