如何通过KV文件为Kivy自定义组件传递自定义属性？

你遇到的核心问题是Kivy属性的赋值时机：当你在TestWidget的__init__方法里打印self.test_property时，KV文件中设置的属性值还没有被应用到实例上。Kivy的组件初始化流程是先调用__init__创建实例，之后才会解析KV文件并完成属性值的绑定。

解决方案 #

这里提供几种可行的解决思路，你可以根据需求选择：

1. 使用属性的on_回调方法（推荐） #

Kivy的属性系统支持自动触发on_<property_name>格式的回调方法，当属性值发生变化时（包括KV中首次赋值），这个方法会被调用。修改你的TestWidget类如下：

class TestWidget(Widget):
    test_property = StringProperty()
    
    def on_test_property(self, instance, value):
        # instance是当前组件实例，value是属性的新值
        print('Test OUTPUT:', value)

这样就能在KV完成属性赋值时，准确打印出你设置的'Test Property'。

2. 延迟执行打印操作 #

如果需要在初始化阶段获取属性值，可以用Clock.schedule_once延迟执行代码，确保KV的属性已经被应用：

from kivy.clock import Clock

class TestWidget(Widget):
    test_property = StringProperty()
    
    def __init__(self, **kwargs):
        super(TestWidget, self).__init__(**kwargs)
        # 延迟1帧执行，确保属性已被赋值
        Clock.schedule_once(self.print_property)
    
    def print_property(self, dt):
        print('Test OUTPUT:', self.test_property)

3. 在KV中直接绑定属性到方法 #

你也可以直接在KV文件里通过绑定语法触发打印操作：

<TestWidget>:
    # 当test_property变化时，调用组件的print_property方法
    on_test_property: self.print_property(self.test_property)

然后在TestWidget类中添加对应的方法：

class TestWidget(Widget):
    test_property = StringProperty()
    
    def print_property(self, value):
        print('Test OUTPUT:', value)

完整修正代码示例（使用第一种方法） #

from kivy.app import App
from kivy.uix.gridlayout import GridLayout
from kivy.uix.widget import Widget
from kivy.lang import Builder
from kivy.properties import StringProperty

Builder.load_string("""
<TestGrid>:
    Button:
    TestWidget:
        test_property: 'Test Property'
""")

class TestWidget(Widget):
    test_property = StringProperty()
    
    def on_test_property(self, instance, value):
        print('Test OUTPUT:', value)

class TestGrid(GridLayout):
    pass

class MyApp(App):
    def build(self):
        return TestGrid()

MyApp().run()

为什么原来的代码不生效？ #

在你的原始代码中，__init__方法在实例创建时立即执行，而KV文件中的属性赋值是在实例创建后，由Kivy的属性系统异步完成的。所以此时test_property还保持着StringProperty的默认值（空字符串），自然无法打印出你期望的内容。

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