---
title: "Perspective - Radio Group"
description: "The Radio Group allows you to create multiple radio buttons in a single container."
---

# Perspective - Radio Group

> The Radio Group allows you to create multiple radio buttons in a single container.

![](img1.png)

**Component Palette Icon**:  

![](img2.png)

## Description

The Radio Group allows you to create multiple radio buttons in a single container. The number of radio buttons in the group is determined by the number of elements in the "radios" object. Only one radio button in a group may be selected at a time. Radio groups are a good way to let the user choose just one of a number of options. If multiple selections are expected, the Checkbox or Dropdown components can be used.

 

The Radio Group component has three pre-configured [variants](../../../../../ignition-modules/perspective/working-with-perspective-components/working-with-perspective-components.md):

* Text Right - Default layout with text on the right of the radio button.
* Text Left - Layout with text on the left of the radio button.
* Multiple - Layout with multiple radio buttons and text on the right.

## Properties

Most Properties have binding options. For more information on Bindings, see [Types of Bindings in Perspective](ignition-modules/perspective/working-with-perspective-components/bindings-in-perspective/bindings-in-perspective.md).
This section only documents the Props Category of properties. The other Categories are described on the [Perspective Component Properties](ignition-modules/perspective/working-with-perspective-components/perspective-component-properties.md) page.

| Name                | Description     | Property Type  | 
| ------------------- | --------------- | ------------- |
| value| 	The value of the selected radio.| 	value: string, integer, boolean, or null| 
| index| 	The index of the selected node. | 	value: integer| 
| radios	| List of radios that make up this group. **text**: Text to pair with this radio. Value is string.**selected**: If 'true,' this radio is selected. Value is boolean.**value**: The value of the radio to be evaluated when selected. Value is numeric.| array|
|orientation|Placement of the Radio Button: row or column. Default is row.|value: string |
|align	|Align radios along the cross axis. Vertical if orientation is set to row; horizontal if orientation is set to column.|value: string |
|justify|Justify radios along the main axis. Horizontal if orientation is set to row; vertical if orientation is set to column.|value: string |
|textPosition|Where to place the label text in relation to the Radio Button: top, right, bottom, or left. Default is right.|value: string |
|enabled	|If true, user is allowed to select a radio. Default is true.**Note**: If the component is disabled, scripts can still run on the component. For example, if you add a script action to the onClick event, the script will fire when the user clicks on the Radio Button.|value: boolean|
|selectedIcon	|Settings for the appearance of the radio's icon when it is selected.**path**: Path to the icon source, in format: library/IconName. For more information on icons, see the [Images, and Icons in Perspective](../../../../../ignition-modules/perspective/working-with-perspective-components/images-and-icons-in-perspective.md) page. Value is string.**color**: Settings for the fill color for the icon.**enabled**: Color of the icon when enabled. Can be a named color. Value is string.**disabled**: Color of the icon when disabled. Can be a named color. Value is string.**style**: Sets a style for the icon. Full menu of [style options](appendix/reference-pages/style-reference.md) is available for text, background, margin and padding, border, shape and miscellaneous. You can also specify a [style class](ignition-modules/perspective/styles/style-classes/style-classes.md).|object|
|unselectedIcon	|Settings for the appearance of the radio's icon when it is not selected.**path**: Path to the icon source, in format: library/IconName. For more information on icons, see the [Images, and Icons in Perspective](../../../../../ignition-modules/perspective/working-with-perspective-components/images-and-icons-in-perspective.md) page. Value is string.**color**: Settings for the fill color for the icon.**enabled**: Color of the icon when enabled. Can be a named color. Value is string.**disabled**: Color of the icon when disabled. Can be a named color. Value is string.**style**: Sets a style for the icon. Full menu of [style options](appendix/reference-pages/style-reference.md) is available for text, background, margin and padding, border, shape and miscellaneous. You can also specify a [style class](ignition-modules/perspective/styles/style-classes/style-classes.md).|object|
|radioStyle|	 Sets a style for the radio buttons. Full menu of [style options](appendix/reference-pages/style-reference.md) is available for text, background, margin and padding, border, shape and miscellaneous. |object|
|style|Sets a style for this component. Full menu of [style options](appendix/reference-pages/style-reference.md) is available for text, background, margin and padding, border, shape and miscellaneous. You can also specify a [style class](ignition-modules/perspective/styles/style-classes/style-classes.md).|object|

## Component Events

The [Perspective Event Types Reference](appendix/reference-pages/perspective-event-types-reference.md) page describes all the possible component event types for Perspective components. Not all component events support each Perspective component. The [Component Events and Actions](ignition-modules/perspective/working-with-perspective-components/component-events-and-actions.md) page shows how to configure events and actions on a Perspective component. Component scripting is handled separately and can be accessed from the Component menubar or by right clicking on the component.