RadioButton

23 Sep 20254 minutes to read

The RadioButton is a graphical user interface element that allows you to select one option from the choices.
It contains checked and unchecked states.

<input type="radio" id="radio"/>
<script>
var radioObj = new RadioButton({ label: "Default" });
radioObj.appendTo("#radio");
</script>

Properties

checked boolean

Specifies a value that indicates whether the RadioButton is checked or not.
When set to true, the RadioButton will be in checked state.

Defaults to false

cssClass string

Defines class/multiple classes separated by a space in the RadioButton element.
You can add custom styles to the RadioButton by using this property.

Defaults to ’’

disabled boolean

Specifies a value that indicates whether the RadioButton is disabled or not.
When set to true, the RadioButton will be in disabled state.

Defaults to false

enableHtmlSanitizer boolean

Specifies whether to enable the rendering of untrusted HTML values in the Radio Button component.
If ‘enableHtmlSanitizer’ set to true, the component will sanitize any suspected untrusted strings and scripts before rendering them.

Defaults to true

enablePersistence boolean

Enable or disable persisting component’s state between page reloads.

Defaults to false

enableRtl boolean

Enable or disable rendering component in right to left direction.

Defaults to false

htmlAttributes { : }

You can add the additional html attributes such as disabled, value etc., to the element.
If you configured both property and equivalent html attribute then the component considers the property value.

Defaults to {}

label string

Defines the caption for the RadioButton, that describes the purpose of the RadioButton.

Defaults to ’’

labelPosition RadioLabelPosition

Positions label before/after the RadioButton.
The possible values are:

  • Before: The label is positioned to left of the RadioButton.
  • After: The label is positioned to right of the RadioButton.

Defaults to ‘After’

locale string

Overrides the global culture and localization value for this component. Default global culture is ‘en-US’.

Defaults to ’’

name string

Defines name attribute for the RadioButton.
It is used to reference form data (RadioButton value) after a form is submitted.

Defaults to ’’

value string

Defines value attribute for the RadioButton.
It is a form data passed to the server when submitting the form.

Defaults to ’’

Methods

addEventListener

Adds the handler to the given event listener.

Parameter Type Description
eventName string A String that specifies the name of the event
handler Function Specifies the call to run when the event occurs.

Returns void

appendTo

Appends the control within the given HTML element

Parameter Type Description
selector (optional) string | HTMLElement Target element where control needs to be appended

Returns void

attachUnloadEvent

Adding unload event to persist data when enable persistence true

Returns void

click

Click the RadioButton element
its native method

Returns void

dataBind

When invoked, applies the pending property changes immediately to the component.

Returns void

destroy

Destroys the widget.

Returns void

detachUnloadEvent

Removing unload event to persist data when enable persistence true

Returns void

focusIn

Sets the focus to RadioButton
its native method

Returns void

getLocalData

Returns the persistence data for component

Returns any

getRootElement

Returns the route element of the component

Returns HTMLElement

getSelectedValue

To get the value of selected radio button in a group.

Returns string

handleUnload

Handling unload event to persist data when enable persistence true

Returns void

refresh

Applies all the pending property changes and render the component again.

Returns void

removeEventListener

Removes the handler from the given event listener.

Parameter Type Description
eventName string A String that specifies the name of the event to remove
handler Function Specifies the function to remove

Returns void

Inject

Dynamically injects the required modules to the component.

Parameter Type Description
moduleList Function[] ?

Returns void

Events

change EmitType<ChangeArgs>

Event trigger when the RadioButton state has been changed by user interaction.

created EmitType<Event>

Triggers once the component rendering is completed.