如何在Kivy的.kv文件中为自定义Widget传递图片源与标签文本属性？

我来帮你搞定这个问题，你的核心需求是让CustomWidget的每个实例能通过kv文件传入自定义文本和图片源，并自动同步到内部的Label和Image控件里。目前代码的问题主要出在属性绑定的逻辑上，下面是具体的修正方案：

问题分析 #

你的代码里有两个关键问题：

1. Python代码的__init__方法里的绑定逻辑不仅语法错误（比如self.bind(self.updatedlabel.text=self.setter("labelText"))这种写法不符合Kivy的绑定规则），而且只是在初始化时给控件赋了一次值，后续属性变化时不会自动同步。
2. kv文件里没有把CustomWidget的自定义属性和内部控件的属性关联起来，导致外部传入的属性无法传递到内部的Label和Image。

解决方案 #

我们可以利用Kivy的Property自动通知特性，直接在kv文件里完成属性绑定，同时简化Python代码：

1. 修正Python代码 #

只保留属性定义即可，去掉__init__里错误的绑定逻辑——Kivy的StringProperty会自动触发属性变化通知，kv里的绑定会自动响应这些变化：

from kivy.app import App
from kivy.uix.widget import Widget
from kivy.properties import ObjectProperty, StringProperty

class CustomWidget(Widget):
    updatedlabel = ObjectProperty(None)
    customimage = ObjectProperty(None)
    # 定义用于外部传入的属性，默认值设为空字符串
    imageSource = StringProperty("")
    labelText = StringProperty("")

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

if __name__ == "__main__":
    MyApp().run()

2. 修正kv文件 #

在CustomWidget的规则中，直接将内部Image的source绑定到root.imageSource，Label的text绑定到root.labelText，这样外部设置的属性会自动同步到内部控件：

<CustomWidget@Widget>
    updatedlabel: updatedlabel
    customimage: customimage
    background_color: (0,0,0,0)
    background_normal: ''
    canvas.before:
        Color:
            rgba: (181/255,174/255,174/255,1)
        RoundedRectangle:
            size: self.size
            pos: self.pos
            radius: [28]
    GridLayout:
        canvas.before:
            Color:
                rgb: utils.get_color_from_hex("#ffffff")
            Rectangle:
                size: self.size
                pos: self.pos
        rows: 2
        cols: 1
        Image:
            id: customimage
            # 绑定到CustomWidget的imageSource属性
            source: root.imageSource
        Label:
            id: updatedlabel
            # 绑定到CustomWidget的labelText属性
            text: root.labelText

3. 使用示例（完全符合你的预期） #

现在你可以在kv里像这样创建CustomWidget实例，每个实例的文本和图片源都会独立生效：

FloatLayout:
    CustomWidget:
        pos_hint: {'x': 0.04, "top": 0.9}
        size_hint_x: 0.16
        size_hint_y: 0.3
        labelText: "I just wrote a text"
        imageSource: "icons/picture.PNG"
    
    # 可以添加多个独立实例，各自设置不同的属性
    CustomWidget:
        pos_hint: {'x': 0.22, "top": 0.9}
        size_hint_x: 0.16
        size_hint_y: 0.3
        labelText: "Another custom text"
        imageSource: "icons/another_pic.PNG"

额外说明 #

如果需要双向绑定（比如内部Label的文本修改后同步回labelText属性），可以把kv里的绑定改成双向语法：text: root.labelText, root.labelText = self.text，不过通常你的场景单向绑定就足够了。另外要确保图片路径是正确的，Kivy会从项目根目录开始查找资源文件。

这样修改后，每个CustomWidget实例的属性都会自动同步到内部控件，完全满足你的需求。

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