Android 单选框RadioGroup+RadioButton

学习笔记

一、引言

在 Android 开发中，单选框（RadioButton）常用于提供一组选项，用户可以从中选择一个选项。为了实现这种功能，Android 提供了两个重要的组件：RadioButton 和 RadioGroup。

RadioButton：表示单个选项，用户可以选择或取消该选项。
RadioGroup：用来包含多个 RadioButton，确保同一组中的多个 RadioButton 中只能选择一个。

本文将详细讲解如何在 Android 中使用这两个组件，通过一个简单的例子来演示如何在 Java 中实现单选框功能。

二、基本概念

1. `RadioButton`

RadioButton 是一个用于单选的 UI 组件，通常被放置在一个 RadioGroup 中。RadioButton 在用户点击时会改变选中状态，并且只能在同一组中保持一个选项被选中。

2. `RadioGroup`

RadioGroup 是一个容器，用来组织多个 RadioButton。它的作用是保证同一组的 RadioButton 中只能选中一个。如果没有被选中的 RadioButton，则返回 -1。

三、实现步骤

下面，我们将通过一个简单的实例来展示如何在 Android 应用中使用 RadioButton 和 RadioGroup。

1. 布局文件

首先，我们需要在 XML 布局文件中定义 RadioGroup 和多个 RadioButton。

activity_main.xml：

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:orientation="vertical"
    android:padding="16dp">

    <!-- RadioGroup: 包含多个 RadioButton -->
    <RadioGroup
        android:id="@+id/radioGroup"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content">
        
        <!-- RadioButton 选项 1 -->
        <RadioButton
            android:id="@+id/radioButton1"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:text="Option 1" />

        <!-- RadioButton 选项 2 -->
        <RadioButton
            android:id="@+id/radioButton2"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:text="Option 2" />

        <!-- RadioButton 选项 3 -->
        <RadioButton
            android:id="@+id/radioButton3"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:text="Option 3" />
    </RadioGroup>

    <!-- 提交按钮 -->
    <Button
        android:id="@+id/buttonSubmit"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="Submit" />
</LinearLayout>

在这个布局文件中，我们定义了一个 RadioGroup，里面包含了三个 RadioButton 选项（Option 1, Option 2, Option 3）。此外，还有一个按钮 Submit，用于提交选中的选项。

2. Java 代码

接下来，我们需要编写 Java 代码来处理用户的选择，并在点击提交按钮时显示选中的选项。

MainActivity.java：

package com.example.radiobuttonexample;

import android.os.Bundle;
import android.view.View;
import android.widget.Button;
import android.widget.RadioButton;
import android.widget.RadioGroup;
import android.widget.Toast;
import androidx.appcompat.app.AppCompatActivity;

public class MainActivity extends AppCompatActivity {

    private RadioGroup radioGroup;
    private Button buttonSubmit;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        // 初始化控件
        radioGroup = findViewById(R.id.radioGroup);
        buttonSubmit = findViewById(R.id.buttonSubmit);

        // 设置按钮点击事件
        buttonSubmit.setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View v) {
                // 获取选中的RadioButton的ID
                int selectedId = radioGroup.getCheckedRadioButtonId();
                
                // 如果没有选中任何RadioButton
                if (selectedId == -1) {
                    Toast.makeText(MainActivity.this, "Please select an option", Toast.LENGTH_SHORT).show();
                } else {
                    // 根据选中的RadioButton的ID来获取对应的RadioButton
                    RadioButton selectedRadioButton = findViewById(selectedId);
                    // 获取选中RadioButton的文本
                    String selectedText = selectedRadioButton.getText().toString();
                    // 显示选中的选项
                    Toast.makeText(MainActivity.this, "You selected: " + selectedText, Toast.LENGTH_SHORT).show();
                }
            }
        });
    }
}

3. 代码解析

获取 RadioGroup 和 RadioButton：
使用 findViewById() 获取布局中的 RadioGroup 和按钮 Button 控件。
获取选中的 RadioButton：
调用 radioGroup.getCheckedRadioButtonId() 来获取当前选中的 RadioButton 的 ID。如果没有选中任何选项，返回 -1。
显示选中的选项：
如果用户选择了某个 RadioButton，我们根据其 ID 查找对应的 RadioButton，并通过 getText() 方法获取其文本内容。最后通过 Toast 显示选中的选项。
按钮点击事件：
buttonSubmit.setOnClickListener() 用于监听提交按钮的点击事件。当用户点击按钮时，我们检查是否有选项被选中。如果有选中项，则显示选中的文本；如果没有选中项，则弹出提示。