selectOneRadio (jsf-ri-1

Overview

Library

Tag

Help

FRAMES NO FRAMES

h
Tag selectOneRadio

Render a set of html "input" elements of type "radio".

Decode Behavior

See the "Decode Behavior for UISelectOne Components" section.

Encode Behavior

Render a "table" element. If the "styleClass" is specified, render the value of the "styleClass" attribute as the value of the "class" attribute on the "table" element. If the "style", "border" attributes are specified, pass them thru. If the "layout" attribute is specified, and its value is "pageDirection", render the children elements vertically, otherwise horizontally, in the table. If any of the children are an instance of SelectItemGroup, render them as a nested table. Render a "label" element. Each of the children are ultimately rendererd as an "input" element of "type" "radio". As an exception to the general rules about how to handle the "id" attribute, render it as an attribute on the outer "table" element, the value of which is the clientId of the component per the rules at the beginning of this specification. The "id" attribute must not be output on each "input" element. Output the value of the "label" attribute of the SelectItem after the "input" element. If the value of the currently rendered child is equal to the value of the parent UISelectOne, render an appropriate HTML boolean value indicating "checked" for the enclosing "input". If the current SelectItem.isDisabled() returns true, render "disabled" as the value of the "disabled" attribute. See the "Rendering the option elements" specification for ListboxRenderer for more detail on how to render the "option" elements in this renderer. Close out the "label" element.

Tag Information
Tag Class	com.sun.faces.taglib.html_basic.SelectOneRadioTag
TagExtraInfo Class	com.sun.faces.taglib.FacesTagExtraInfo
Body Content	JSP
Display Name	None

Attributes
Name	Required	Request-time	Type	Description
converter	false	false	`java.lang.String`	Converter instance registered with this component.
id	false	false	`java.lang.String`	The component identifier for this component. This value must be unique within the closest parent component that is a naming container.
immediate	false	false	`java.lang.String`	Flag indicating that this component's value must be converted and validated immediately (that is, during Apply Request Values phase), rather than waiting until Process Validations phase.
rendered	false	false	`java.lang.String`	Flag indicating whether or not this component should be rendered (during Render Response Phase), or processed on any subsequent form submit.
required	false	false	`java.lang.String`	Flag indicating that the user is required to provide a submitted value for this input component.
validator	false	false	`java.lang.String`	MethodBinding representing a validator method that will be called during Process Validations to perform correctness checks on the value of this component. The expression must evaluate to a public method that takes FacesContext, UIComponent, and Object parameters, with a return type of void.
value	false	false	`java.lang.String`	The current value of this component.
valueChangeListener	false	false	`java.lang.String`	MethodBinding representing a value change listener method that will be notified when a new value has been set for this input component. The expression must evaluate to a public method that takes a ValueChangeEvent parameter, with a return type of void.
accesskey	false	false	`java.lang.String`	Access key that, when pressed, transfers focus to this element.
border	false	false	`java.lang.String`	Width (in pixels) of the border to be drawn around the table containing the options list.
dir	false	false	`java.lang.String`	Direction indication for text that does not inherit directionality. Valid values are "LTR" (left-to-right) and "RTL" (right-to-left).
disabled	false	false	`java.lang.String`	Flag indicating that this element must never receive focus or be included in a subsequent submit.
disabledClass	false	false	`java.lang.String`	CSS style class to apply to the rendered label on disabled options.
enabledClass	false	false	`java.lang.String`	CSS style class to apply to the rendered label on enabled options.
lang	false	false	`java.lang.String`	Code describing the language used in the generated markup for this component.
layout	false	false	`java.lang.String`	Orientation of the options list to be created. Valid values are "pageDirection" (list is laid out vertically), or "lineDirection" (list is laid out horizontally). If not specified, the default value is "lineDirection".
onblur	false	false	`java.lang.String`	Javascript code executed when this element loses focus.
onchange	false	false	`java.lang.String`	Javascript code executed when this element loses focus and its value has been modified since gaining focus.
onclick	false	false	`java.lang.String`	Javascript code executed when a pointer button is clicked over this element.
ondblclick	false	false	`java.lang.String`	Javascript code executed when a pointer button is double clicked over this element.
onfocus	false	false	`java.lang.String`	Javascript code executed when this element receives focus.
onkeydown	false	false	`java.lang.String`	Javascript code executed when a key is pressed down over this element.
onkeypress	false	false	`java.lang.String`	Javascript code executed when a key is pressed and released over this element.
onkeyup	false	false	`java.lang.String`	Javascript code executed when a key is released over this element.
onmousedown	false	false	`java.lang.String`	Javascript code executed when a pointer button is pressed down over this element.
onmousemove	false	false	`java.lang.String`	Javascript code executed when a pointer button is moved within this element.
onmouseout	false	false	`java.lang.String`	Javascript code executed when a pointer button is moved away from this element.
onmouseover	false	false	`java.lang.String`	Javascript code executed when a pointer button is moved onto this element.
onmouseup	false	false	`java.lang.String`	Javascript code executed when a pointer button is released over this element.
onselect	false	false	`java.lang.String`	Javascript code executed when text within this element is selected by the user.
readonly	false	false	`java.lang.String`	Flag indicating that this component will prohibit changes by the user. The element may receive focus unless it has also been disabled.
style	false	false	`java.lang.String`	CSS style(s) to be applied when this component is rendered.
styleClass	false	false	`java.lang.String`	Space-separated list of CSS style class(es) to be applied when this element is rendered. This value must be passed through as the "class" attribute on generated markup.
tabindex	false	false	`java.lang.String`	Position of this element in the tabbing order for the current document. This value must be an integer between 0 and 32767.
title	false	false	`java.lang.String`	Advisory title information about markup elements generated for this component.
binding	false	false	`java.lang.String`	The value binding expression linking this component to a property in a backing bean

Variables
No Variables Defined.

Overview

Library

Tag

Help

FRAMES NO FRAMES

Output Generated by Tag Library Documentation Generator. Java, JSP, and JavaServer Pages are trademarks or registered trademarks of Sun Microsystems, Inc. in the US and other countries. Copyright 2002-4 Sun Microsystems, Inc. 4150 Network Circle Santa Clara, CA 95054, U.S.A. All Rights Reserved.

h Tag selectOneRadio

h
Tag selectOneRadio