
本文详解如何在 kivy 应用中安全、可靠地访问 screen 子类中通过 `id` 定义的 ui 控件(例如 textinput),尤其在 `on_stop()` 等生命周期回调中读取用户输入,避免因对象未初始化或作用域失效导致的 attributeerror。
在 Kivy 中,跨类访问 UI 组件(如从 App 类访问 Screen 中的 TextInput)是一个常见但易出错的操作。核心问题在于:控件 ID 仅在对应 Widget 实例构建完成后才可用,且必须通过正确的引用链访问。直接使用 Screeen.ids.textinput 是错误的——Screeen 是类名,不是实例;ids 属于具体 Widget 实例,而非类本身。
✅ 正确做法是:
- 在 App.__init__() 中提前加载并保存根 Widget(如 ScreenManager)的引用;
- 通过 self.sm.current_screen 获取当前活跃的 Screen 实例;
- 利用 Screen 类中定义的 textinput: textinput 别名(即 ObjectProperty 绑定)安全访问子控件。
以下为完整可运行示例(已验证):
from kivy.app import App
from kivy.lang import Builder
from kivy.uix.screenmanager import ScreenManager, Screen
class Screeen(Screen):
pass
class Manager(ScreenManager):
pass
kv_string = '''
Manager:
Screeen:
:
name: "Screeen"
textinput: textinput # ← 关键:将 id="textinput" 绑定为实例属性
FloatLayout:
size: root.width, root.height
TextInput:
id: textinput
text: "hi"
size_hint: (.45, .1)
pos: root.width * 1 / 3 , root.height * 1 / 2
'''
class Ball(App):
def on_stop(self):
# ✅ 安全访问:应用关闭时读取当前屏幕的 TextInput 内容
if self.sm.current_screen and hasattr(self.sm.current_screen, 'textinput'):
print(f"Closing app. Last input: '{self.sm.current_screen.textinput.text}'")
def __init__(self, **kwargs):
super().__init__(**kwargs)
# ✅ 提前加载并持有 ScreenManager 实例引用
self.sm = Builder.load_string(kv_string)
def build(self):
return self.sm
def on_start(self):
# 调试提示:确认各层级对象类型与状态
print(f"Root widget: {type(self.root)}")
print(f"Current screen: {self.sm.current_screen}")
print(f"TextInput content: {self.sm.current_screen.textinput.text}")
if __name__ == "__main__":
Ball().run() ? 关键注意事项:
- 永远不要在 on_stop() 中假设 current_screen 非空——添加 if 检查或 try/except 更健壮;
- .kv 文件中的 textinput: textinput 是必需的“桥梁”,它将 id 映射为 Screen 实例的可访问属性(类似 self.textinput);
- 若使用外部 .kv 文件(如原题中的 plann.kv),只需将 Builder.load_string(...) 替换为 Builder.load_file("plann.kv"),逻辑完全一致;
- on_start() 是验证引用是否就绪的理想位置,而 on_stop() 是保存数据、清理资源的最后时机。
掌握这一模式后,你不仅能安全读取控件值,还可调用其方法(如 textinput.focus = True)、绑定事件,真正实现 App 与 UI 的松耦合交互。








