KivyMD：Python无法访问KV文件内Screen子组件ID的问题解决

问题根源 #

1. KV规则中的ID作用范围错误：
   • 你在<DataScreen>规则里设置的id: data_screen，这个ID无法被组件自身的self.ids识别，ScreenManager识别屏幕需要用name属性而非该ID。
   • <DataScreenBody@MDBoxLayout>规则里的id: data_screen_body属于组件内部ID，仅能在DataScreenBody类自身访问，父组件DataScreen无法通过self.ids获取。
2. 组件初始化时机问题：即便使用Clock.schedule_once，也可能因屏幕未完成挂载导致self.ids为空，正确的访问时机应该是屏幕进入时的生命周期方法。

修正步骤 #

1. 调整KV文件 #

修改后的KV代码：

<DataScreen>:
    name: "data_screen"  # 用name属性让ScreenManager识别该屏幕
    canvas.before:
        Color:
            rgba: rgba("#F0F5F0") # White
        Rectangle:
            pos: self.pos
            size: self.size
    MDBoxLayout:
        orientation: "vertical"
        DataScreenTopBar:
        DataScreenBody:
            id: data_screen_body  # 将ID放在DataScreen的子组件定义中，而非自定义组件内部

<DataScreenBody@MDBoxLayout>:
    orientation: "horizontal"
    size_hint: 1, 0.875
    canvas.before:
        Color:
            rgba: rgba("#F0F5F0") # White
        Rectangle:
            pos: self.pos
            size: self.size

2. 修正Python代码 #

使用屏幕的on_enter生命周期方法访问ID，此时组件已完全初始化：

from kivy.clock import Clock
from kivymd.app import MDApp
from kivymd.uix.screen import MDScreen
from kivy.uix.screenmanager import ScreenManager

class GameShotApp(MDApp):
    def build(self):
        self.title = "Game Shot"
        self.icon  = "./icon/favicon.png"
        return WindowManager()

class MainScreen(MDScreen):
    def btnClick(self):
        print("Btn Click")

class DataScreen(MDScreen):
    def on_enter(self, *args):
        # 屏幕进入时，子组件已初始化完成
        print("\nHere B:")
        print(self.ids)  # 现在可以获取到data_screen_body
        print(self.ids.data_screen_body)  # 直接访问目标组件

class WindowManager(ScreenManager):
    pass

GameShotApp().run()

关键说明 #

• name属性：ScreenManager通过name属性识别不同屏幕，必须给每个Screen设置name，而非在KV规则里设id。
• ID的作用范围：父组件要访问子组件的ID，必须在父组件的KV结构中给子组件设置id，不能在自定义组件的内部规则里设置。
• 生命周期方法：on_enter是屏幕切换完成后触发的方法，此时所有子组件都已加载完成，能确保self.ids包含所需组件。

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