Jsf selectonelistbox html tag

JSF h:selectOneListbox tag is used to render a single select HTML input element of the type “select” with size specified.

JSF tag:

<h:selectOneListbox value="#{testBean.data}" />
  <f:selectItem itemValue="1" itemLabel="Item 1" />
   <f:selectItem itemValue="2" itemLabel="Item 2" />
</h:selectOneListbox>

Rendered HTML tag:

<select name="j_idt6:j_idt8" size="2">  
   <option value="1">Item 1</option>
   <option value="2">Item 2</option>
</select>

Attribute of h:selectOneListbox tag:

Attribute Description
id id for the tag
binding Reference to the component used in a backing bean
rendered A boolean value; false would suppress rendering
styleClass Cascading stylesheet (CSS) class name
value value binding
valueChangeListener A method binding that responds to value changes
converter Converter class name
validator Class name of a validator attached to the component
required A boolean; if true, marks the tag as required
accesskey gives focus to an element
accept Comma-separated list of content types for a form
accept-charset Comma- or space-separated list of character encodings for a form.
alt Alternative text for nontextual elements such as images
border Pixel value for an element’s border width
charset Character encoding for a linked resource
coords Coordinates for an element whose shape is a rectangle, circle, or polygon
dir Direction for text. Valid values are ltr (left to right) and rtl (right to left).
disabled Disabled state of an input element or button
hreflang Base language of a resource specified with the href attribute;
lang Base language of an element’s attributes and text
maxlength Maximum number of characters for text fields
readonly Read-only state of an input field
style Inline style information
tabindex Numerical value specifying a tab index
target The name of a frame in which a document is opened
title A title used for accessibility. Browsers typically create tooltips for the title’s value
type Type of a link; for example, stylesheet
width Width of an element
onblur Event handler for losing focus
onchange Event handler for value changes
onclick Event handler for Mouse button clicked over the element
ondblclick Event handler for Mouse button double-clicked
onfocus Event handler for element received focus
onkeydown Event handler for Key pressed
onkeypress Event handler for Key pressed and released
onkeyup Event handler for Key released
onmousedown Event handler for Mouse button pressed
onmousemove Event handler for mouse moved
onmouseout Event handler for mouse left
onmouseover Event handler for mouse moved onto
onmouseup Event handler for mouse button released
onreset Event handler for form reset
onselect Event handler for Text selected
immediate Process validation early in the life cycle

Example:

Test.java

import javax.faces.bean.ManagedBean;
import javax.faces.bean.SessionScoped;
 
/**
 * Managed bean.
 * @author w3schools
 */
@ManagedBean(name="test")
@SessionScoped
public class Test {
	private String selectedValue;
 
	public String getSelectedValue() {
		return selectedValue;
	}
 
	public void setSelectedValue(String selectedValue) {
		this.selectedValue = selectedValue;
	}
 
	public String checkSelectedValue() {
		return "success";
	}
}

test.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 select one list box example.</title>
	</h:head>
    <h:body>
    	<h2>JSF select one list box example.</h2>
 
    	<h:form>
    	   <h:selectOneListbox value="#{test.selectedValue}">
    	   	<f:selectItem itemValue="MCA" itemLabel="MCA" />
    	   	<f:selectItem itemValue="CSE" itemLabel="CSE" />
    	   	<f:selectItem itemValue="IT" itemLabel="IT" />
    	   </h:selectOneListbox>
    	   <br/> <br/>
    	   <h:commandButton value="Check Selected Value" 
    	      action="#{test.checkSelectedValue}"/>	
    	</h:form>
 
    </h:body>
 
</html>

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"
	xmlns:ui="http://java.sun.com/jsf/facelets">
	<h:head>
		<title>JSF select one list box example.</title>
	</h:head>
    <h:body> 
    	 <h3>Selected value: </h3> 
    	 <h:outputText value="#{test.selectedValue}"/>
    </h:body>
 
</html>

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>test.xhtml</from-view-id>
   <navigation-case>
      <from-outcome>success</from-outcome>
      <to-view-id>welcome.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>

URL:

http://localhost:7001/JSFExample53/faces/test.xhtml

Output:

JSF example53-1
Select value.
JSF example53-2
Click on Check Selected Value button.
JSF example53-3
 
Download this example.