JavaServer Faces

Name

<h:selectOneRadio>

Synopsis

This action represents an instance of the component type registered with the type ID javax.faces.HtmlSelectOneRadio (by default, an instance of the javax.faces.component.html.HtmlSelectOneRadio class), combined with a renderer registered with the renderer type ID javax.faces.Radio.

The component is rendered as an HTML <table> element with an <input> element for each choice represented by its children (one or more UISelectItem and UISelectItems components) as the table cells. If the layout attribute is set to pageDirection, each cell is rendered in a separate table row; otherwise all cells are rendered in one row. A UISelectItemGroup child component is rendered as a nested table within the corresponding outer table cell. If the id attribute is set, a <span> element with an id attribute containing the component’s client ID is rendered around the outer table.

The <input> elements are rendered with a type attribute set to radio and a name attribute set to the component’s client ID. Each <input> element is also nested within a <label> elements with a for attribute set to the component’s client ID. For all choices that match one of the component’s values, the checked attribute is set for the corresponding <input> element.

Syntax

<h:selectOneRadio [id="id"] [binding="componentBinding"] 
  [rendered="true|false"] [value="value"] [converter="converter"]
  [required="true|false"] [validator="validatorMethod"]
  [valueChangeListener="listenerMethod"] [immediate="true| ...