RadioButton SAP SE RadioButton is a control similar to a {@link sap.m.CheckBox checkbox}, but it allows you to choose only one of the predefined set of options. Multiple radio buttons have to belong to the same group (have the same value for <code>groupName</code>) in order to be mutually exclusive. A wrapper control {@link sap.m.RadioButtonGroup RadioButtonGroup} can be used instead of individual radio buttons. <h3>Structure</h3> <ul> <li>Radio buttons can have a value state like Error or Warning.</li> <li>Radio buttons can be arranged vertically by setting the <code>column</code> to a number higher than 1.</li> <li>Radio button options need to have a {@link sap.m.Label label}.</li> </ul> <h3>Usage</h3> <h4>When to use:</h4> <ul> <li>You quickly need to choose between at least two alternatives.</li> <li>You need to place other controls between the radio button options.</li> </ul> <h4>When not to use:</h4> <ul> <li>You want to select multiple values for the same option. Use {@link sap.m.CheckBox checkboxes} instead.</li> <li>When the default value is recommended for most users in most situations. Use a {@link sap.m.Select drop-down} instead as is saves space by not showing all the alternatives.</li> <li>You want have more than 8 options. Use a {@link sap.m.Select drop-down} instead.</li> <li>When the options are mutually exclusive e.g. ON/OFF. Use a {@link sap.m.Switch switch} instead.</li> <li>Avoid using horizontally aligned radio buttons as they will be cut off on phones.</li> </ul> <b>Note:</b> The order in which the RadioButtons will be selected one after another is determined upon instantiation of the control. This order is consistent with the ARIA attributes for position, which the same button will receive when added to specific group. <b>Example:</b> If three buttons are created (<code>button1, button2, button3</code>) in consecutive order, initially they will have the same positions and TAB order. However if after that <code>button1</code> and <code>button3</code> are moved to a new group and then <code>button2</code> is added to the same group, their TAB order and position in this group will be <code>button1, button3, button2</code>. sap.ui.core/Control Specifies if the radio button is disabled. Specifies the select state of the radio button Name of the radio button group the current radio button belongs to. You can define a new name for the group. If no new name is specified, this radio button belongs to the sapMRbDefaultGroup per default. Default behavior of a radio button in a group is that when one of the radio buttons in a group is selected, all others are unselected. Specifies the text displayed next to the RadioButton Options for the text direction are RTL and LTR. Alternatively, the control can inherit the text direction from its parent container. Width of the RadioButton or it's label depending on the useEntireWidth property. By Default width is set only for the label. Indicates if the given width will be applied for the whole RadioButton or only it's label. By Default width is set only for the label. This is a flag to switch on activeHandling. When it is switched off, there will not be visual changes on active state. Default value is 'true' Specifies whether the user can select the radio button. Enumeration sap.ui.core.ValueState provides state values Error, Success, Warning, Information, None Specifies the alignment of the radio button. Available alignment settings are "Begin", "Center", "End", "Left", and "Right". Specifies if the RadioButton should be editable. This property meant to be used by parent controls (e.g. RadioButtoGroup). Defines the text that appears in the tooltip of the <code>RadioButton</code>. If this is not specified, a default text is shown from the resource bundle. Event is triggered when the user makes a change on the radio button (selecting or unselecting it). Checks whether the RadioButton is active or not. Association to controls / IDs which describe this control (see WAI-ARIA attribute aria-describedby). Association to controls / IDs which label this control (see WAI-ARIA attribute aria-labelledby).