A list that shows all options but the user can select only one at a time.

Description

A Radio control, with which users have decades of experience, is best used with only a few options that are mutually exclusive.

Key properties

Default – The initial value of a control before it is changed by the user.

Items – The source of data that appears in a control such as a gallery, a list, or a chart.

Items The source of data that appears in a control such as a gallery, a list, or a chart.

When you add a gallery, a list, or a chart, the property list shows Items by default so that you can easily specify the data that the new control should show. For example, you might set the Items property of a gallery to the Account table in Salesforce, a table named Inventory that you created in Excel and uploaded to the cloud, or a SharePoint list named ConferenceSpeakers.

Value – The value of an input control.

All properties

Align – The location of text in relation to the horizontal center of its control.

BorderColor – The color of a control's border.

BorderStyle – Whether a control's border is Solid, Dashed, Dotted, or None.

BorderThickness – The thickness of a control's border.

FocusedBorderThickness – The thickness of the control's border when it has keyboard focus.

Color – The color of text in a control.

Disabled – Whether the user can interact with the control.

DisabledBorderColor – The color of a control's border if the control's Disabled property is set to true.

DisabledColor – The color of text in a control if its Disabled property is set to true.

DisabledFill – The background color of a control if its Disabled property is set to true.

Fill – The background color of a control.

Font – The name of the family of fonts in which text appears.

FontWeight – The weight of the text in a control: Bold, Semibold, Normal, or Lighter.

Height – The distance between a control's top and bottom edges.

HoverColor – The color of the text in a control when the user keeps the mouse pointer on it.

HoverFill – The background color of a control when the user keeps the mouse pointer on it.

Italic – Whether the text in a control is italic.

LineHeight – The distance between, for example, lines of text or items in a list.

OnChange – How the app responds when the user changes the value of a control (for example, by adjusting a slider).

OnSelect – How the app responds when the user taps or clicks a control.

PaddingBottom – The distance between text in a control and the bottom edge of that control.

PaddingLeft – The distance between text in a control and the left edge of that control.

PaddingRight – The distance between text in a control and the right edge of that control.

PaddingTop – The distance between text in a control and the top edge of that control.

PressedColor – The color of text in a control when the user taps or clicks that control.

PressedFill – The background color of a control when the user taps or clicks that control.

RadioBackgroundFill – The background color of the circles in a radio-button control.

RadioBorderColor – The color of the circle for each option in a radio-button control.

RadioSelectionFill – The color that appears inside the circle of the selected option in a radio-button control.

RadioSize – The diameter of the circles in a radio-button control.

Reset – Whether a control reverts to its default value.

Size – The font size of the text that appears on a control.

Strikethrough – Whether a line appears through the text that appears on a control.

Tooltip – Explanatory text that appears when the user hovers over a control.

Underline – Whether a line appears under the text that appears on a control.

Visible – Whether a control appears or is hidden.

Width – The distance between a control's left and right edges.

X – The distance between the left edge of a control and the left edge of the screen.

Y – The distance between the top edge of a control and the top edge of the screen.

Related functions

Distinct( DataSource, ColumnName )

Example

  1. Add a Radio control, name it Pricing, and set its Items property to this formula:
    ["Standard", "Premium"]

    Don't know how to add, name, and configure a control?

  2. Add a Text box control, move it below the Radio control, and set the Text property of the Text box control to this formula:
    If("Premium" in Pricing.Selected.Value, "$200 per day", "$150 per day")

    Want more information about the If function or other functions?

  3. Press F5, and then choose either option in the Radio control.

    The Text box control shows the appropriate text for your choice.

  4. (optional) In the Radio control, choose the other option to confirm that the appropriate text appears.

  5. To return to the default workspace, press Esc.