Kivy RecycleView初始化先于数据设置，引发尺寸重置等问题

问题概述 #

使用Kivy的RecycleView组件，自定义viewclass为继承自Button的InventoryIngredientButton，运行时遇到两个问题：

• 初始化数据中的inventory_ingredient未正常显示，仅使用了默认值
• 按钮尺寸被重置为默认的(100, 100)，而非代码中设置的(200, 200)

相关代码 #

Python 代码 #

class InventoryIngredientButton(Button):
    count = NumericProperty(None)
    display_count = StringProperty(None)

    def __init__(self, inventory_ingredient: InventoryIngredient = ing1, **kwargs):
        print("init is being called")
        super().__init__(
            background_normal=inventory_ingredient.ingredient.icon_img,
            text=inventory_ingredient.ingredient.display_name,
            size_hint=(None, None),
            size=(200, 200),
            **kwargs)

    def use(self):
        self.count -= 1
        self.display_count = str(self.count)

    def on_count(self, instance, value):
        print("count is %s and size is %s" % (value, self.size))
        if value == 0:
            self.disabled = True
    
    def on_size(self, instance, value):
        print("Size changed to value %s for button %s" % (value, self.count))

class RV(RecycleView):
    def __init__(self):
        super().__init__()
        self.data = [{'inventory_ingredient': ing2, 'count': 6}, {'count': 3, 'inventory_ingredient': ing1}]

class RecycleTutorialApp(App):
    def build(self):
        return RV()

if __name__ == "__main__":
    Builder.load_file('tutorial_listview.kv')
    RecycleTutorialApp().run()

KV 文件（tutorial_listview.kv） #

<InventoryIngredientButton>
  pos: self.x, self.y
  pos_hint: None, None
  count: 1
  on_press: root.use()

  Label:
    text: str(root.count)
    pos: root.x-10,root.y-10
    pos_hint: None, None

<RV>:
  viewclass: 'InventoryIngredientButton'
  RecycleBoxLayout:
    rows: 2
    cols: 5
    size_hint: 1, 1
    pos_hint: 0, 0

日志信息 #

init is being called and type is Lemon (Lemon is the default)
Size changed to value [200, 200] for button None
count is 1 and size is [200, 200]
count is 0 and size is [200, 200]
Size changed to value [100, 100] for button 0
init is being called and type is Lemon
Size changed to value [200, 200] for button None
count is 1 and size is [200, 200]
Size changed to value [100, 100] for button 1

问题根源 #

1. inventory_ingredient未正常显示：RecycleView的核心逻辑是复用组件实例，__init__仅在组件首次创建时调用，后续数据更新是通过Kivy的属性系统直接设置组件属性实现的。由于inventory_ingredient不是Kivy属性，无法被RecycleView从data中传递并更新，只能使用__init__中的默认值。
2. 尺寸被重置：
   • KV文件的配置优先级高于Python代码中__init__的设置，当前KV中未明确指定按钮尺寸，导致后续布局计算时被RecycleBoxLayout的默认规则重置为(100,100)
   • RecycleView的布局管理器会在组件复用或布局刷新时重新计算尺寸，若未通过属性或KV固定尺寸，会被覆盖

解决方案 #

1. 修复inventory_ingredient数据传递问题 #

将inventory_ingredient定义为Kivy的ObjectProperty，并通过属性变更事件更新UI，确保RecycleView能正确从data中传递值：

class InventoryIngredientButton(Button):
    count = NumericProperty(1)
    inventory_ingredient = ObjectProperty(None)  # 改为ObjectProperty
    display_count = StringProperty(None)

    def __init__(self, **kwargs):
        print("init is being called")
        # 初始化时仅设置基础布局属性
        super().__init__(size_hint=(None, None), size=(200, 200), **kwargs)

    # 当inventory_ingredient属性变更时更新UI
    def on_inventory_ingredient(self, instance, value):
        if value:
            self.background_normal = value.ingredient.icon_img
            self.text = value.ingredient.display_name

    def use(self):
        self.count -= 1
        self.display_count = str(self.count)

    def on_count(self, instance, value):
        print("count is %s and size is %s" % (value, self.size))
        if value == 0:
            self.disabled = True
    
    def on_size(self, instance, value):
        print("Size changed to value %s for button %s" % (value, self.count))

注：即使不需要监听属性变更，也必须使用Kivy属性类型，RecycleView才能通过data字典正确传递对应值。

2. 固定按钮尺寸 #

在KV文件中明确设置InventoryIngredientButton的尺寸，确保优先级高于布局默认规则：

<InventoryIngredientButton>
  pos: self.x, self.y
  pos_hint: None, None
  size_hint: None, None  # 禁用尺寸自动适配
  size: 200, 200         # 固定尺寸
  count: 1
  on_press: root.use()

  Label:
    text: str(root.count)
    pos: root.x-10,root.y-10
    pos_hint: None, None

<RV>:
  viewclass: 'InventoryIngredientButton'
  RecycleBoxLayout:
    rows: 2
    cols: 5
    size_hint: 1, 1
    pos_hint: 0, 0

额外说明 #

• 无需担心ObjectProperty的自动监听器：若不需要处理后续变更，仅实现一次on_inventory_ingredient初始化UI即可，不会产生额外性能开销
• 不要尝试在RV.__init__中先设置data再调用super：RecycleView的初始化逻辑依赖super调用后的布局构建，提前设置data无效

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