Developing Web 2.0 applications
with JavaServerFaces
and Dreamweaver
>> Just Became Easier
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
JSF HTML Tag Library
  h:body
  h:button
  h:column
  h:commandButton
  h:commandLink
  h:dataTable
  h:form
  h:graphicImage
  h:head
  h:inputHidden
  h:inputSecret
  h:inputText
  h:inputTextarea
  h:link
  h:message
  h:messages
  h:outputFormat
  h:outputLabel
  h:outputLink
  h:outputScript
  h:outputStylesheet
  h:outputText
  h:panelGrid
  h:panelGroup
  h:selectBooleanCheckbox
  h:selectManyCheckbox
  h:selectManyListbox
  h:selectManyMenu
  h:selectOneListbox
  h:selectOneMenu
Selected h:selectOneRadio
If you like this documentation, please take a look at my book:

12. JSF HTML Tag Reference

Documentation > JSF > JSF Tag Reference > JSF HTML Tag Library > h:selectOneRadio

h:selectOneRadio

The SelectOneRadio tag renders a table of HTML "input" elements of the type "radio". This component is designed for situations where you want to display a mutually exclusive list of options to the user as a set of radio buttons. Like the selectManyCheckbox tag, this tag supports two layout modes:lineDirection (horizontal, the default) and pageDirection (vertical).

JSF Example

<!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:f="http://java.sun.com/jsf/core" 
      xmlns:h="http://java.sun.com/jsf/html">
<h:head />
<body>
<h:form>
	<h:selectOneRadio id="subscriptions" 
	                  value="#{subscriptionController.subscriptions}">
		<f:selectItem id="item1" itemLabel="News" itemValue="1" />
		<f:selectItem id="item2" itemLabel="Sports" itemValue="2" />
		<f:selectItem id="item3" itemLabel="Music" itemValue="3" />
		<f:selectItem id="item4" itemLabel="Java" itemValue="4" />
		<f:selectItem id="item5" itemLabel="Web" itemValue="5" />
	</h:selectOneRadio>
</h:form>
</body>
</html>
This example was formatted by JSFToolbox for Dreamweaver.

Rendered Output

Rendered h:selectOneRadio tag

Tag Attributes

accesskey Text
 
The accesskey attribute is a standard HTML attribute that sets the access key that transfers focus to this element when pressed.
binding Expression
 
The value-binding expression linking this component tag to a backing bean property.
border Text
 
The border attribute sets the pixel width of the border to be drawn around the table.
converter Text
 
The converter attribute sets the converter instance to be registered for this component. It must match the converter-id value of a converter element defined in your Faces configuration file.
converterMessage Text
 
A ValueExpression enabled attribute that, if present, will be used as the text of the converter message, replacing any message that comes from the converter.
dir Enumerated
 
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).

This attribute accepts the following values:

  • LTR
  • RTL
disabled Boolean
 
The disabled attribute is a boolean flag that when set to true indicates that this component should not receive focus or be included in a form submit.
disabledClass Text
 
The disabledClass attribute sets the CSS style class to apply to the component for disabled options.
enabledClass Text
 
The enabledClass attribute sets the CSS style class to apply to the component for enabled options.
hideNoSelectionOption Boolean
 
Flag indicating that, if this component is activated by the user, The "no selection option", if any, must be hidden.
id Text
 
The unique identifier value for this component. The value must be unique within the closest naming container.
immediate Boolean
 
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.
label Text
 
A localized user presentable name for this component.
lang Text
 
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.
layout Text
 
The layout attribute sets the layout of the table containing the list of checkbox options. The valid values for this attribute are "lineDirection" (horizontally, the default) and "pageDirection" (vertically).

This attribute accepts the following values:

  • lineDirection
  • pageDirection
onblur Text
 
The onblur attribute sets the JavaScript code to execute when this element loses focus.
onchange Text
 
The onchange attribute sets the JavaScript code to execute when this element loses focus and its value changes after gaining focus.
onclick Text
 
The onclick attribute sets the JavaScript code to execute when the mouse pointer is clicked over this element.
ondblclick Text
 
The ondblclick attribute sets the JavaScript code to execute when the mouse pointer is double-clicked over this element.
onfocus Text
 
The onfocus attribute sets the JavaScript code to execute when the element receives focus.
onkeydown Text
 
The onkeydown attribute sets the JavaScript code to execute when a key is pressed down over this element.
onkeypress Text
 
The onkeypress attribute sets the JavaScript code to execute when a key is pressed and released over this element.
onkeyup Text
 
The onkeyup attribute sets the JavaScript code to execute when a key is released over this element.
onmousedown Text
 
The onmousedown attribute sets the JavaScript code to execute when the mouse pointer is pressed down over this element.
onmousemove Text
 
The onmousemove attribute sets the JavaScript code to execute when the mouse pointer is moved within this element.
onmouseout Text
 
The onmouseout attribute sets the JavaScript code to execute when the mouse pointer is moved away from this element.
onmouseover Text
 
The onmouseover attribute sets the JavaScript code to execute when the mouse pointer is moved onto this element.
onmouseup Text
 
The onmouseup attribute sets the JavaScript code to execute when the mouse button is released over this element.
onselect Text
 
The onselect attribute sets the JavaScript code to execute when the user selects the text contained by this element.
readonly Boolean
 
The readonly attribute is a boolean flag that when set to true prohibits changes to this element by the user. The element will continue to receive focus unless you set the disabled attribute to true.
rendered Boolean
 
A value-binding expression that evaluates to a Boolean condition indicating if this component should be rendered.
required Boolean
 
The required attribute is a boolean flag that indicates whether or not the user is required to provide a value for this field before the form can be submitted to the server.
requiredMessage Text
 
A ValueExpression enabled attribute that, if present, will be used as the text of the validation message for the "required" facility, if the "required" facility is used.
style Text
 
The style attribute sets the CSS style definition to be applied to this component when it is rendered.
styleClass Text
 
The styleClass attribute sets the CSS class to apply to this component when it is rendered.
tabindex Text
 
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.
title Text
 
The title attribute is a standard HTML attribute that sets the tooltip text to display for the rendered component.
validator Text
 
The validator attribute accepts a method-binding expression representing a validator method that will be called when the JSF framework validates this component. A validator method must be a public method that takes FacesContext, UIComponent, and Object parameters, with a return type of void.
validatorMessage Text
 
A ValueExpression enabled attribute that, if present, will be used as the text of the validator message, replacing any message that comes from the validator.
value Text
 
The value attribute sets the current value for this component.
valueChangeListener Text
 
The valueChangeListener attribute accepts a method-binding expression representing a value change listener method to be notified when a new value has been set for this input component. A value change listener method must be a public method that takes a ValueChangeEvent parameter, with a return type of void.