如何在Kivy的RecycleView中强制指定项显示为选中状态

核心问题原因 #

选中样式不触发是三个硬伤导致的：

• 没有给SelectableRecycleBoxLayout配置key_selection属性，RecycleView的选择追踪逻辑无法识别自定义的选中字段
• 手动修改rv.data里的selected字段不会触发布局的选择状态更新，LayoutSelectionBehavior是通过内部维护的选中节点集合管理状态，直接改data属性不会同步到视图
• apply_selection里写的全局变量判断逻辑用了比较运算符==而非赋值运算符=，且后续直接用传入的is_selected覆盖自定义判断结果，逻辑完全失效；另外每次选中都新建定时器会导致多个定时任务叠加，切歌速度会越来越快。

修复步骤 #

1. 修正KV布局配置，给选择布局加上必填的选择键配置，关闭多选（切歌是单选中场景），统一列表项高度避免滚动偏移：

<RV>:
    viewclass: 'SongLinkButton'
    SelectableRecycleBoxLayout:
        id: recycle_grid2
        key_selection: 'selected'
        multiselect: False
        default_size: None, dp(80)
        default_size_hint: 1, None
        size_hint_y: None
        height: self.minimum_height
        orientation: 'vertical'
        spacing: dp(2)

2. 简化NextSong逻辑，不要手动遍历修改data里的selected字段，直接调用布局的选择API完成选中，同时把定时器初始化挪到RV类的初始化方法里，避免重复创建：

class RV(RecycleView):
    def __init__(self, **kwargs):
        super(RV, self).__init__(**kwargs)
        self.data = [{'textinfo.text': x, 'selected': False} for x in songDict.values()]
        # 仅初始化一次定时器，禁止放在选中回调中重复创建
        Clock.schedule_interval(self.NextSong, 1)

    def scroll_to_index(self, index):
        box = self.children[0]
        pos_index = (box.default_size[1] + box.spacing) * index
        scroll = self.convert_distance_to_scroll(
            0, pos_index - (self.height * 0.5))[1]
        scroll = max(0.0, min(1.0, scroll))
        self.scroll_y = 1.0 - scroll

    def NextSong(self, *args):
        layout = self.ids.recycle_grid2
        # 清空已有选中状态
        if layout.selected_nodes:
            for node in layout.selected_nodes:
                layout.deselect_node(node)
        # 生成随机目标索引
        randPickInt = randint(0, len(self.data)-1)
        # 调用布局原生API触发选中，自动同步data字段和视图状态
        layout.select_node(randPickInt)
        # 更新顶部歌曲标题
        target_text = self.data[randPickInt]['textinfo.text']
        App.get_running_app().root.get_screen('selectscreen').ids.songlistid.ids.songtitle.text = target_text
        # 滚动到目标歌曲位置
        self.scroll_to_index(randPickInt)

3. 精简SongLinkButton的apply_selection逻辑，删掉无效的全局变量判断，只保留状态同步即可：

def apply_selection(self, rv, index, is_selected):
    self.selected = is_selected
    # 此处仅需处理选中后的附加逻辑，不要重复绑定定时器

额外说明 #

• 手动改data后调用refresh_from_data()只会刷新视图属性，不会触发选择布局的选中逻辑，必须通过select_node/deselect_node方法操作选中状态，这是RecycleView选择行为的设计要求
• 原代码中default_size写的dp(120)和SongLinkButton实际高度dp(80)不一致，会导致滚动位置计算偏移，修复代码里已经统一高度值
• 全局变量curSelectedSong可以完全删掉，选中状态直接通过布局的selected_nodes属性就能拿到，不需要额外维护全局变量

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