Class “RadioButton”

Object > NativeObject > Widget > RadioButton

A radio button. Selecting a radio button de-selects all its siblings (i.e. all radio buttons within the same parent).

RadioButton on Android
Android
RadioButton on iOS
iOS
Type: RadioButton extends Widget
Constructor: public
Singleton: No
Namespace: tabris
Direct subclasses: None
JSX Support: Element: <RadioButton/>
Parent Elements: <Canvas/>, <Cell/>, <Composite/>, <Page/>, <RefreshComposite/>, <Row/>, <ScrollView/>, <Stack/>, <Tab/>
Child Elements: Not Supported
Element content sets: text

Examples

JavaScript

import {RadioButton, contentView} from 'tabris';

new RadioButton({text: 'One', checked: true})
  .onSelect(event => console.log(`Checked: ${event.checked}`))
  .appendTo(contentView);

new RadioButton({text: 'Two'})
  .onSelect(event => console.log(`Checked: ${event.checked}`))
  .appendTo(contentView);

See also:

JSX Creating a set of RadioButtons [► Run in Playground]

Constructor

new RadioButton(properties?)

Parameter Type Description
properties Properties<RadioButton> Sets all key-value pairs in the properties object as widget properties. Optional.

Properties

checked

The checked state of the radio button.

Type: boolean
Default: false
Settable: Yes
Change Event: checkedChanged

checkedTintColor

The color of the selectable area in checked state. Will fall back to tintColor if not set.

Type: ColorValue
Settable: Yes
Change Event: checkedTintColorChanged

font

The font used for the text.

Type: FontValue
Settable: Yes
Change Event: fontChanged

text

The label text of the radio button.

Type: string
Settable: Yes
Change Event: textChanged
JSX Content Type: Text

When using RadioButton as an JSX element the elements Text content is mapped to this property.

textColor

The color of the text.

Type: ColorValue
Settable: Yes
Change Event: textColorChanged

tintColor

The color of the selectable area.

Type: ColorValue
Settable: Yes
Change Event: tintColorChanged

Events

select

Fired when the radio button is selected or deselected by the user.

EventObject Type: RadioButtonSelectEvent<RadioButton>

Property Type Description
checked boolean The new value of checked.

Change Events

checkedChanged

Fired when the checked property has changed.

EventObject Type: PropertyChangedEvent<RadioButton, boolean>

Property Type Description
value boolean The new value of checked.

textChanged

Fired when the text property has changed.

EventObject Type: PropertyChangedEvent<RadioButton, string>

Property Type Description
value string The new value of text.

textColorChanged

Fired when the textColor property has changed.

EventObject Type: PropertyChangedEvent<RadioButton, ColorValue>

Property Type Description
value ColorValue The new value of textColor.

tintColorChanged

Fired when the tintColor property has changed.

EventObject Type: PropertyChangedEvent<RadioButton, ColorValue>

Property Type Description
value ColorValue The new value of tintColor.

checkedTintColorChanged

Fired when the checkedTintColor property has changed.

EventObject Type: PropertyChangedEvent<RadioButton, ColorValue>

Property Type Description
value ColorValue The new value of checkedTintColor.

fontChanged

Fired when the font property has changed.

EventObject Type: PropertyChangedEvent<RadioButton, FontValue>

Property Type Description
value FontValue The new value of font.