JSF - h:commandLink

Quiz

The h:commandLink tag renders an HTML "anchor" element.

JSF Tag

<h:commandLink value = "Page 1" action = "page1" />

Rendered Output

<a href = "#" onclick = "mojarra.jsfcljs(document.getElementById('j_idt13'), 
   {'j_idt13:j_idt14':'j_idt13:j_idt14'},'');return false">Page 1</a>

Tag Attributes

S.No	Attribute & Description
1	id Identifier for a component
2	binding Reference to the component that can be used in a backing bean
3	rendered A boolean; false suppresses rendering
4	styleClass Cascading stylesheet (CSS) class name
5	value A components value, typically a value binding
6	valueChangeListener A method binding to a method that responds to value changes
7	converter Converter class name
8	validator Class name of a validator thats created and attached to a component
9	required A boolean; if true, requires a value to be entered in the associated field
10	Accesskey A key, typically combined with a system-defined metakey, that gives focus to an element
11	accept Comma-separated list of content types for a form
12	accept-charset Comma- or space-separated list of character encodings for a form. The accept-charset attribute is specified with the JSF HTML attribute named acceptcharset.
13	Alt Alternative text for nontextual elements such as images or applets
14	border Pixel value for an elements border width
15	charset Character encoding for a linked resource
16	coords Coordinates for an element whose shape is a rectangle, circle, or polygon
17	dir Direction for text. Valid values are ltr (left to right) and rtl (right to left)
18	hreflang Base language of a resource specified with the href attribute; hreflang may only be used with href.
19	lang Base language of an elements attributes and text
20	maxlength Maximum number of characters for text fields
21	readonly Read-only state of an input field; text can be selected in a readonly field but not edited
22	rel Relationship between the current document and a link specified with the href attribute
23	rev Reverse link from the anchor specified with href to the current document. The value of the attribute is a space-separated list of link types
24	size Size of an input field
25	style Inline style information
26	tabindex Numerical value specifying a tab index
27	target The name of a frame in which a document is opened
28	title A title, used for accessibility, that describes an element. Visual browsers typically create tooltips for the titles value
29	type Type of a link; for example, stylesheet
30	width Width of an element
31	onblur Element loses focus
32	onchange Elements value changes
33	onclick Mouse button is clicked over the element
34	ondblclick Mouse button is double-clicked over the element
35	onfocus Element receives focus
36	onkeydown Key is pressed
37	onkeypress Key is pressed and subsequently released
38	onkeyup Key is released
39	onmousedown Mouse button is pressed over the element
40	onmousemove Mouse moves over the element
41	onmouseout Mouse leaves the elements area
42	onmouseover Mouse moves onto an element
43	onmouseup Mouse button is released
44	onreset Form is reset
45	onselect Text is selected in an input field

Example Application

Let us create a test JSF application to test the above tag.

Step	Description
1	Create a project with a name helloworld under a package com.tutorialspoint.test as explained in the JSF - First Application chapter.
2	Modify home.xhtml as explained below. Keep rest of the files unchanged.
3	Compile and run the application to make sure business logic is working as per the requirements.
4	Finally, build the application in the form of war file and deploy it in Apache Tomcat Webserver.
5	Launch your web application using appropriate URL as explained below in the last step.

home.xhtml

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
   "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns = "http://www.w3.org/1999/xhtml">
   <head>
      <title>JSF Tutorial!</title>
   </head>
   
   <body>
      <h2>h:commandLink example</h2>
      <hr />
      
      <h:form>
         <h:commandLink value = "Page 1" action = "page1" />
      </h:form>
   </body>
</html>

Once you are ready with all the changes done, let us compile and run the application as we did in JSF - First Application chapter. If everything is fine with your application, this will produce the following result.

jsf_basic_tags.htm

Print Page