Java单选按钮（JRadioButton）[编辑 | 编辑源代码]

Java单选按钮（JRadioButton）是Swing GUI组件库中用于实现单选功能的控件，它允许用户从一组互斥选项中选择一个且只能选择一个选项。通常与ButtonGroup类配合使用，确保同一组的单选按钮具有排他性。

基本概念[编辑 | 编辑源代码]

单选按钮属于JToggleButton的子类，具有两种状态：选中（true）和未选中（false）。其核心特性包括：

互斥选择：同一组内的单选按钮只能有一个被选中
事件驱动：通过ActionListener或ItemListener响应状态变化
可视化反馈：默认显示圆形选择标记和文本标签

基本用法[编辑 | 编辑源代码]

创建单选按钮[编辑 | 编辑源代码]

基本构造方法：

// 创建未选中的单选按钮
JRadioButton radio1 = new JRadioButton("选项1");
// 创建默认选中的单选按钮
JRadioButton radio2 = new JRadioButton("选项2", true);

分组管理[编辑 | 编辑源代码]

使用ButtonGroup实现互斥：

ButtonGroup group = new ButtonGroup();
group.add(radio1);
group.add(radio2);

完整示例[编辑 | 编辑源代码]

以下是一个包含事件处理的完整示例：

import javax.swing.*;
import java.awt.*;
import java.awt.event.ActionEvent;
import java.awt.event.ActionListener;

public class RadioButtonExample {
    public static void main(String[] args) {
        JFrame frame = new JFrame("单选按钮示例");
        frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
        frame.setSize(300, 200);
        
        // 创建面板和布局
        JPanel panel = new JPanel(new GridLayout(0, 1));
        
        // 创建单选按钮
        JRadioButton option1 = new JRadioButton("Windows");
        JRadioButton option2 = new JRadioButton("macOS");
        JRadioButton option3 = new JRadioButton("Linux");
        
        // 设置默认选择
        option2.setSelected(true);
        
        // 创建按钮组
        ButtonGroup group = new ButtonGroup();
        group.add(option1);
        group.add(option2);
        group.add(option3);
        
        // 添加事件监听器
        ActionListener listener = new ActionListener() {
            public void actionPerformed(ActionEvent e) {
                System.out.println("已选择: " + e.getActionCommand());
            }
        };
        
        option1.addActionListener(listener);
        option2.addActionListener(listener);
        option3.addActionListener(listener);
        
        // 添加组件到面板
        panel.add(new JLabel("请选择操作系统:"));
        panel.add(option1);
        panel.add(option2);
        panel.add(option3);
        
        frame.add(panel);
        frame.setVisible(true);
    }
}

输出结果示例：当用户选择不同选项时，控制台会输出类似信息：

已选择: Windows
已选择: Linux

高级特性[编辑 | 编辑源代码]

自定义外观[编辑 | 编辑源代码]

可以通过继承BasicRadioButtonUI或实现RadioButtonUI接口来自定义外观：

UIManager.put("RadioButton.background", Color.LIGHT_GRAY);
UIManager.put("RadioButton.foreground", Color.BLUE);

与数据绑定[编辑 | 编辑源代码]

结合数据模型使用：

ButtonModel model = radio1.getModel();
model.addActionListener(e -> {
    if (model.isSelected()) {
        // 处理选中逻辑
    }
});

状态图[编辑 | 编辑源代码]

单选按钮的状态转换可通过以下mermaid图表示：

实际应用场景[编辑 | 编辑源代码]

1. 设置对话框：如IDE的主题选择、字体大小设置 2. 问卷调查：单项选择题目的回答 3. 配置向导：安装程序中的组件选择 4. 数据筛选：报表中的过滤条件选择

数学表示[编辑 | 编辑源代码]

单选按钮组可以形式化表示为： $G = {b_{1}, b_{2}, . . ., b_{n}} 其中 \sum_{i = 1}^{n} s (b_{i}) = 1$ 其中 $s (b_{i})$ 表示按钮 $b_{i}$ 的选中状态（1为选中，0为未选中）。

最佳实践[编辑 | 编辑源代码]

始终将相关单选按钮放入同一个ButtonGroup
提供默认选择以改善用户体验
对于重要选择，考虑添加确认机制
在移动端界面中适当增大点击区域
遵循平台的人机界面指南

常见问题[编辑 | 编辑源代码]

为什么我的多个单选按钮可以同时选中？[编辑 | 编辑源代码]

可能原因： 1. 忘记将它们添加到同一个ButtonGroup 2. 在不同的容器中创建了按钮组 3. 意外创建了多个按钮组实例

如何获取当前选中的按钮？[编辑 | 编辑源代码]

遍历按钮组检查选中状态：

Enumeration<AbstractButton> buttons = group.getElements();
while (buttons.hasMoreElements()) {
    AbstractButton button = buttons.nextElement();
    if (button.isSelected()) {
        System.out.println("选中: " + button.getText());
    }
}

参见[编辑 | 编辑源代码]

注意：本文档假设使用Java 8或更高版本，对于旧版本可能需要调整部分语法。