JSF - h:commandButton


Advertisements


The h:commandButton tag renders an HTML input element of the type "submit".

JSF Tag

<h:commandButton value="Click Me!" onclick="alert('Hello World!');" />

Rendered Output

<input type="submit" name="j_idt10:j_idt13" value="Click Me!"
   onclick="alert('Hello World!');" />

Tag Attributes

S.N.Attribute & Description
1id

Identifier for a component

2rendered

A boolean; false suppresses rendering

3value

A component’s value, typically a value binding

4valueChangeListener

A method binding to a method that responds to value changes

5coords

Coordinates for an element whose shape is a rectangle, circle, or polygon

6dir

Direction for text. Valid values are ltr (left to right) and rtl (right to left).

7disabled

Disabled state of an input element or button

8tabindex

Numerical value specifying a tab index

9target

The name of a frame in which a document is opened

10title

A title, used for accessibility, that describes an element. Visual browsers typically create tooltips for the title’s value

11width

Width of an element

12onblur

Element loses focus

13onchange

Element’s value changes

14onclick

Mouse button is clicked over the element

15ondblclick

Mouse button is double-clicked over the element

16onfocus

Element receives focus

17onkeydown

Key is pressed

18onkeypress

Key is pressed and subsequently released

19onkeyup

Key is released

20onmousedown

Mouse button is pressed over the element

21onmousemove

Mouse moves over the element

22onmouseout

Mouse leaves the element’s area

23onmouseover

Mouse moves onto an element

24onmouseup

Mouse button is released

25onreset

Form is reset

26onselect

Text is selected in an input field

Example Application

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

StepDescription
1Create a project with a name helloworld under a package com.tutorialspoint.test as explained in the JSF - First Application chapter.
2Modify home.xhtml as explained below. Keep rest of the files unchanged.
3Compile and run the application to make sure business logic is working as per the requirements.
4Finally, build the application in the form of war file and deploy it in Apache Tomcat Webserver.
5Launch 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:commandButton example</h2>
   <hr />
   <h:form>
   <h:commandButton value="Click Me!" onclick="alert('Hello World!');" />
   </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 following result:

JSF h:commandButton
jsf_basic_tags.htm

Advertisements