Kivy中如何优雅获取单选按钮组的选中项？

问题场景 #

我在体育赛事分析场景中搭建了一套用于选择主队的单选按钮系统，简化后的Kivy代码如下：

<NamingScreen>:
    GridLayout:
        cols: 3
        rows: 4

        Button:
            
        Button:
  
        Button:

        Label:
            text: 'HomeTeam?'

        CheckBox:
            id: team1_radio
            active: True
            group: "home deciders"
            allow_no_selection: False
            on_active:
                root.manager.get_screen('name_screen').ids.team1_selected.text = 'Selected as Home'
                root.manager.get_screen('name_screen').ids.team2_selected.text = ''

        Label:
            id: team1_selected
            text: 'Selected as Home'

    ######## team 2 buttons from here

        Button:
           
        Button:

        Button:

        Label:
            text: 'Home Team?'

        CheckBox:
            id: team2_radio
            group: "home deciders"
            allow_no_selection: False
            on_active:
                root.manager.get_screen('name_screen').ids.team2_selected.text = 'Selected as Home'
                root.manager.get_screen('name_screen').ids.team1_selected.text = ''

        Label:
            id: team2_selected
            text: ''

我希望找到一种优雅的方式获知哪个Checkbox被选中，比如类似group("home_deciders").selected这样直接返回选中项的方法，而不是逐个比较两个Checkbox的active值。

解决方案 #

Kivy的Checkbox组件本身没有直接通过组名获取选中项的内置方法，但可以通过以下两种方式实现优雅的获取逻辑：

1. 实时跟踪选中项（推荐） #

在NamingScreen类中添加一个属性，用于实时记录当前选中的单选框，避免后续遍历查找：

Python代码

from kivy.uix.screenmanager import Screen
from kivy.uix.checkbox import CheckBox

class NamingScreen(Screen):
    selected_home_team = None

    def on_kv_post(self, base_widget):
        # 初始化选中项（对应KV中默认激活的team1_radio）
        self.selected_home_team = self.ids.team1_radio

修改KV文件中的Checkbox事件

更新每个单选框的on_active事件，当自身被激活时更新跟踪属性：

CheckBox:
    id: team1_radio
    active: True
    group: "home deciders"
    allow_no_selection: False
    on_active:
        if self.active:
            root.selected_home_team = self
            root.ids.team1_selected.text = 'Selected as Home'
            root.ids.team2_selected.text = ''

CheckBox:
    id: team2_radio
    group: "home deciders"
    allow_no_selection: False
    on_active:
        if self.active:
            root.selected_home_team = self
            root.ids.team2_selected.text = 'Selected as Home'
            root.ids.team1_selected.text = ''

之后需要获取选中项时，直接访问self.selected_home_team（在NamingScreen类内部）或screen_instance.selected_home_team即可，还能通过selected_home_team.id拿到选中项的ID（如team1_radio）。

2. 遍历筛选同组选中项 #

如果不想修改原有事件绑定，可以编写一个工具方法，遍历屏幕内的所有组件，筛选出目标组中处于激活状态的单选框：

class NamingScreen(Screen):
    def get_selected_in_group(self, group_name):
        for widget in self.walk():
            if isinstance(widget, CheckBox) and widget.group == group_name and widget.active:
                return widget
        return None

调用示例：

# 在需要获取选中项的地方调用
selected_checkbox = self.get_selected_in_group("home deciders")
if selected_checkbox:
    print(f"选中的主队单选框ID: {selected_checkbox.id}")

内容的提问来源于stack exchange，提问作者Max Davies