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.
Attributes:
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.
Examples:
<dif:document> <dif:form> <dif:radioField id="sex" options="${stage.sexList}" /> </dif:form/> ... </dif:document>
See also: