Flutter Radio Button

A radio button is also known as the options button which holds the Boolean value. It allows the user to choose only one option from a predefined set of options. This feature makes it different from a checkbox where we can select more than one option and the unselected state to be restored. We can arrange the radio button in a group of two or more and displayed on the screen as circular holes with white space (for unselected) or a dot (for selected). We can also provide a label for each corresponding radio button describing the choice that the radio button represents. A radio button can be selected by clicking the mouse on the circular hole or using a keyboard shortcut.

In this section, we are going to explain how to use radio buttons in Flutter. Flutter allows us to use radio buttons with the help of 'Radio', 'RadioListTile', or 'ListTitle' Widgets.

The flutter radio button does not maintain any state itself. When we select any radio option, it invokes the onChanged callback and passing the value as a parameter. If the value and groupValue match, the radio option will be selected.

Let us see how we can create radio buttons in the Flutter app through the following steps:

Step 1: Create a Flutter project in the IDE. Here, I am going to use Android Studio.

Step 2: Open the project in Android Studio and navigate to the lib folder. In this folder, open the main.dart file and create a RadioButtonWidget class (Here: MyStatefulWidget). Next, we will create the Column widget and put three RadioListTile components. Also, we will create a Text widget for displaying the selected item. The ListTitle contains the following properties:

groupValue: It is used to specify the currently selected item for the radio button group.

title: It is used to specify the radio button label.

value: It specifies the backhand value, which is represented by a radio button.

onChanged: It will be called whenever the user selects the radio button.

1. ListTile(  
2.   title: const Text('www.javatpoint.com'),  
3.   leading: Radio(  
4.     value: BestTutorSite.javatpoint,  
5.     groupValue: _site,  
6.     onChanged: (BestTutorSite value) {  
7.       setState(() {  
8.         _site = value;  
9.       });  
10.     },  
11.   ),  
12. ),  

Let us see the complete code of the above steps. Open the main.dart file and replace the following code.

Here, the Radio widgets wrapped in ListTiles and the currently selected text is passed into groupValue and maintained by the example's State. Here, the first Radio button will be selected off because _site is initialized to BestTutorSite.javatpoint. If the second radio button is pressed, the example's State is updated with setState, updating _site to BestTutorSite.w3schools. It rebuilds the button with the updated groupValue, and therefore it will select the second button.

1. import 'package:flutter/material.dart';  
2.   
3. void main() => runApp(MyApp());  
4.   
5. /// This Widget is the main application widget.  
6. class MyApp extends StatelessWidget {  
7.   static const String _title = 'Radio Button Example';  
8.   
9.   @override  
10.   Widget build(BuildContext context) {  
11.     return MaterialApp(  
12.       title: _title,  
13.       home: Scaffold(  
14.         appBar: AppBar(title: const Text(_title)),  
15.         body: Center(  
16.           child: MyStatefulWidget(),  
17.         ),  
18.       ),  
19.     );  
20.   }  
21. }  
22.   
23. enum BestTutorSite { javatpoint, w3schools, tutorialandexample }  
24.   
25. class MyStatefulWidget extends StatefulWidget {  
26.   MyStatefulWidget({Key key}) : super(key: key);  
27.   
28.   @override  
29.   _MyStatefulWidgetState createState() => _MyStatefulWidgetState();  
30. }  
31.   
32. class _MyStatefulWidgetState extends State<MyStatefulWidget> {  
33.   BestTutorSite _site = BestTutorSite.javatpoint;  
34.   
35.   Widget build(BuildContext context) {  
36.     return Column(  
37.       children: <Widget>[  
38.         ListTile(  
39.           title: const Text('www.javatpoint.com'),  
40.           leading: Radio(  
41.             value: BestTutorSite.javatpoint,  
42.             groupValue: _site,  
43.             onChanged: (BestTutorSite value) {  
44.               setState(() {  
45.                 _site = value;  
46.               });  
47.             },  
48.           ),  
49.         ),  
50.         ListTile(  
51.           title: const Text('www.w3school.com'),  
52.           leading: Radio(  
53.             value: BestTutorSite.w3schools,  
54.             groupValue: _site,  
55.             onChanged: (BestTutorSite value) {  
56.               setState(() {  
57.                 _site = value;  
58.               });  
59.             },  
60.           ),  
61.         ),  
62.         ListTile(  
63.           title: const Text('www.tutorialandexample.com'),  
64.           leading: Radio(  
65.             value: BestTutorSite.tutorialandexample,  
66.             groupValue: _site,  
67.             onChanged: (BestTutorSite value) {  
68.               setState(() {  
69.                 _site = value;  
70.               });  
71.             },  
72.           ),  
73.         ),  
74.       ],  
75.     );  
76.   }  
77. }  

Output

When we run the app, the following output appears. Here, we have three radio buttons, and only one is selected by default. We can also select any other option.