JSF inputtext html tag

by

JSF h:inputText tag is used to render an HTML input element of the type “text”.

JSF tag:

<h:inputText value="Hello World" />

Rendered HTML tag:

<input name="j_idt6:j_idt8" type="text" value="Hello World" />

Attributes of h:inputText tag.

Attribute Description
1. id id for the tag
2. binding Reference to the component used in a backing bean
3. rendered A boolean value; false would suppress rendering
4. styleClass Cascading stylesheet (CSS) class name
5. value value binding
6. valueChangeListener A method binding that responds to value changes
7. converter Converter class name
8. validator Class name of a validator attached to the component
9. required A boolean; if true, marks the tag as required
10. accesskey 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.
13. alt Alternative text for nontextual elements such as images
14. border Pixel value for an element’s 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. disabled Disabled state of an input element or button
19. hreflang Base language of a resource specified with the href attribute;
20. lang Base language of an element’s attributes and text
21. maxlength Maximum number of characters for text fields
22. readonly Read-only state of an input field
23. style Inline style information
24. tabindex Numerical value specifying a tab index
25. target The name of a frame in which a document is opened
26. title A title used for accessibility. Browsers typically create tooltips for the title’s value
27. type Type of a link; for example, stylesheet
28. width Width of an element
29. onblur Event handler for losing focus
30. onchange Event handler for value changes
31. onclick Event handler for Mouse button clicked over the element
32. ondblclick Event handler for Mouse button double-clicked
33. onfocus Event handler for element received focus
34. onkeydown Event handler for Key pressed
35. onkeypress Event handler for Key pressed and released
36. onkeyup Event handler for Key released
37. onmousedown Event handler for Mouse button pressed
38. onmousemove Event handler for mouse moved
39. onmouseout Event handler for mouse left
40. onmouseover Event handler for mouse moved onto
41. onmouseup Event handler for mouse button released
42. onreset Event handler for form reset
43. onselect Event handler for Text selected
44. immediate Process validation early in the life cycle

Example explanation:

On “helloworld.xhtml” page we have input text with id and value attribute. The value of the input text is binding with the userName property of the Test.java class. Click “Hello” button after entering the value in input text. JSF framework assign the input text value to the bean property and “sayHello” method returns the “success”. This return value is matched with the navigation rules defined in faces-config.xml file and renders the welcome.xhtml page.

Example:

helloworld.xhtml

<?xml version="1.0" encoding="UTF-8"?>
<!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"
	xmlns:h="http://java.sun.com/jsf/html"
	xmlns:f="http://java.sun.com/jsf/core">
	<h:head>
		<title>JSF input text example.</title>
	</h:head>
    <h:body>
    	<h2>JSF input text example.</h2> 
    	<h:form>
    	   <h:inputText id="name" value="#{test.userName}"/>
    	   <br/> <br/>
    	   <h:commandButton value="Hello" 
    	   		action="#{test.sayHello}"/>	
    	</h:form> 
    </h:body>
 
</html>

Test.java

package com.w3schools.business;
import javax.faces.bean.ManagedBean;
import javax.faces.bean.SessionScoped;
 
/**
 * Managed bean.
 * @author w3schools
 */
@ManagedBean(name="test")
@SessionScoped
public class Test {
	private String userName;
 
	public String getUserName() {
		return userName;
	}
 
	public void setUserName(String userName) {
		this.userName = userName;
	}
 
	public String sayHello() {
		if(userName == null || userName.equals("")){
			return "fail";
		}else{
			return "success";
		}
	}
}

faces-config.xml

<?xml version="1.0" encoding="windows-1252"?>
<faces-config version="2.0" 
xmlns="http://java.sun.com/xml/ns/javaee" 
xmlns:xi="http://www.w3.org/2001/XInclude" 
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://java.sun.com/xml/ns/javaee 
http://java.sun.com/xml/ns/javaee/web-facesconfig_2_0.xsd">
 
<navigation-rule>
   <from-view-id>helloworld.xhtml</from-view-id>
   <navigation-case>
      <from-outcome>success</from-outcome>
      <to-view-id>welcome.xhtml</to-view-id>
   </navigation-case>
 
   <navigation-case>
      <from-outcome>fail</from-outcome>
      <to-view-id>helloworld.xhtml</to-view-id>
   </navigation-case>
 
</navigation-rule>
 
</faces-config>

web.xml

<?xml version="1.0" encoding="UTF-8"?>
<web-app version="3.0" 
    	xmlns="http://java.sun.com/xml/ns/javaee" 
    	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
    	xsi:schemaLocation="http://java.sun.com/xml/ns/javaee 
    	http://java.sun.com/xml/ns/javaee/web-app_3_0.xsd">
 
    <servlet>
        <servlet-name>faces</servlet-name>
        <servlet-class>javax.faces.webapp.FacesServlet</servlet-class>
    </servlet>
 
    <servlet-mapping>
        <servlet-name>faces</servlet-name>
        <url-pattern>/faces/*</url-pattern>
    </servlet-mapping>
 
</web-app>

welcome.xhtml

<?xml version="1.0" encoding="UTF-8"?>
<!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"
	xmlns:h="http://java.sun.com/jsf/html"
	xmlns:f="http://java.sun.com/jsf/core">
	<h:head>
		<title>JSF input text example.</title>
	</h:head>
    <h:body> 
    	 <h3>Hello <h:outputText value="#{test.userName}"/></h3> 
    </h:body>
 
</html>

URL:

http://localhost:7001/JSFExample4/faces/helloworld.xhtml

Output:

JSF example4-1
Enter value in text box.
JSF example4-2
Click on Hello button.
JSF example4-3
 
Download this example.