Kivy动态类未定义报错：TripButton名称未找到求助

错误原因 #

1. 动态类命名空间不兼容：在kv文件中用<TripButton@Button>定义的动态类仅存在于Kivy的kv语言命名空间中，而on_release中的代码是作为Python表达式执行的，Python命名空间里并没有TripButton这个类，因此抛出NameError。
2. 父控件层级不可靠：root.parent.parent的写法依赖固定的界面挂载结构，实际运行时可能指向非预期的控件，而且一旦界面布局调整就会失效。

解决方法 #

方法一：在Python中定义TripButton类 #

将kv动态类转为Python类，让Python命名空间中存在该类，kv和Python代码都能直接引用：

修改Python文件，添加TripButton类：

from kivy.app import App
from kivy.uix.screenmanager import ScreenManager, Screen
from kivy.uix.popup import Popup
from kivy.uix.button import Button 

class TripButton(Button):
    pass 

class FirstScreen(Screen):
    pass

class MyPopup(Popup):
    pass

class MyApp(App):
    def build(self):
        sm = ScreenManager()
        sm.add_widget(FirstScreen(name='first'))
        sm.current = 'first'
        return sm

    def open_popup(self):
        p = MyPopup()
        p.open()

修改kv文件中的TripButton定义，去掉@Button：

#:kivy 1.11.1

<TripButton>:
    size_hint: (0.15,0.15)
    pos_hint: {'y':0.84}
    text:"Test Text"

# 其余kv代码保持不变

方法二：使用Factory调用kv动态类 #

如果不想在Python中定义类，可通过Kivy的Factory获取kv中定义的动态类：

在kv文件开头导入Factory：

#:kivy 1.11.1
#:import Factory kivy.factory.Factory

<TripButton@Button>:
    size_hint: (0.15,0.15)
    pos_hint: {'y':0.84}
    text:"Test Text"

修改Submit按钮的on_release代码：

Button:
    text: 'Submit'
    on_release:
        root.parent.parent.add_widget(Factory.TripButton(text=trip_name.text, size_hint=(1,0.1)))
        root.dismiss()

方法三：通过App方法添加控件（更健壮） #

避免在kv中直接操作父控件，改为调用App的方法，并给目标容器添加ID确保准确寻址：

修改FirstScreen的kv代码，给要添加按钮的BoxLayout加ID：

<FirstScreen>:
    name: 'first'
    FloatLayout:

        BoxLayout:
            size_hint: (0.95, 0.95)
            pos_hint: {'center_x':0.5, 'center_y':0.5}
            orientation: "vertical"

            canvas.before:
                Color:
                    rgba: (1, 0, 0, 1) # Red color
                Rectangle:
                    pos: self.pos
                    size: self.size
            BoxLayout:
                id: trip_container 
                TripButton:

            # 其余代码不变

修改MyApp的add_button方法：

class MyApp(App):
    # 其余方法不变

    def add_button(self, text):
        screen = self.root.get_screen('first')
        container = screen.ids.trip_container
        from kivy.factory import Factory
        new_btn = Factory.TripButton(text=text, size_hint=(1,0.1))
        container.add_widget(new_btn)

修改Submit按钮的on_release代码：

Button:
    text: 'Submit'
    on_release:
        app.add_button(trip_name.text)
        root.dismiss()

这种方法彻底摆脱了对父控件层级的依赖，代码更健壮，符合Kivy的最佳实践。

内容的提问来源于stack exchange，提问作者magic-chef