ChoiceGroup

Radio buttons let people select a single option from two or more choices.

Properties#

Name	Type	Description
`value`	string	`key` value of the selected option.
`label`	string	Descriptive label for the choice group.
`data`	string	Additional data attached to the control. The value is passed in `change` event data along with a ChoiceGroup selected value.

Name	Description
`change`	Fires when the choice has been changed.

Option represents an item within ChoiceGroup.

Name	Type	Description
`key`	string	Option's key. `text` value will be used instead if `key` is not specified.
`text`	string	Option's display text. `key` value will be used instead if `text` is not specified.
`icon`	string	Icon name to display with this option.
`iconColor`	string	Icon color.

Adding a new ChoiceGroup with a couple of options defined as tuples:

cg1 = page.add(ChoiceGroup(label="Favorite color:", options=[
    ("r", "Red"),
    ("g", "Green"),
    ("b", "Blue")
]))

or as Option controls:

cg1 = page.add(ChoiceGroup(label="Favorite color:", options=[
    Option("r", "Red"),
    Option("g", "Green"),
    Option("b", "Blue")
]))

Get the key of selected option:

favorite_color = page.get_value(cg1)