Description: A radio button input with the corresponding label. If options are passed it renders a group of radio button options.

JavaDoc: Click here

Remarks: The id will map to an existent stage parameter if it exists.
This will cause it's value to be initialized and submitted to this parameter. All validation as defined in the parameter will be applied to the submitted value.

The layout can be selected from horizontal layout (radios in front on one another), or vertical, each one in a new line.
The options must be provided in a List of Option objects.

Body content: Empty. All enclosed content will be ignored.


Name Description Data type Required Default value
id The id for the generated HTML input. String Yes -
dataSourceAttribute The corresponding data source field id for editable detailsForms. String No The value of the id parameter
label The label for the input. String No A message with the id identical to the given tag id, or, if non-existent, the camel-cased interpretation of the id
labelCSSClass A CSS class to apply to the HTML label tag String No -
options A List of options for the radios. List<Option<?>> No* -
layout Selects the layout mode: "horizontal" or "vertical". String No horizontal layout
noTabIndex If we want to omit the tab index attribute. Boolean No False
readonly Render the value with a label, do not create an input. Boolean No False
tip A tip for the current field. String No -
helpID The id of the existing help item to use as help for this field. String No -
autoSubmit Defines if the component submit's the form when the value is changed. String No False
groupLabel Label text format and spacing normalization String No False

* When this component is used alone, not contained in a radioGroup component, the options parameter becomes required. The component will not render otherwise, reporting an error to the administration console.


       <dif:radioField id="sex" options="${stage.sexList}" />

See also:

Back to tag reference