ScrollView嵌套MDSwiper时滑动缩放动画失效问题求解

问题原因 #

该问题由ScrollView与MDSwiper的触摸事件冲突导致，不属于KivyMD框架原生bug：

• ScrollView作为滚动容器，默认会先拦截所有滑动类触摸事件，判断是否要触发自身的滚动逻辑
• 当你在MDSwiper上滑动时，触摸事件优先被外层ScrollView消费，MDSwiper无法拿到完整的滑动偏移量参数，也就无法计算和触发内置的图片缩放动画
• 当MDSwiper放在ScrollView外时，没有上层滚动容器拦截事件，因此动画可以正常触发

解决方案 #

方案1：重写MDSwiper的触摸事件，主动请求事件消费权限 #

在main.py中添加自定义MDSwiper子类：

from kivymd.uix.swiper import MDSwiper

class CustomMDSwiper(MDSwiper):
    def on_touch_down(self, touch):
        # 判断触摸点是否落在当前MDSwiper区域内
        if self.collide_point(*touch.pos):
            # 告诉ScrollView暂时不要拦截后续触摸事件
            self.parent.parent.scroll_timeout = 0
            return super().on_touch_down(touch)
        return super().on_touch_down(touch)
    
    def on_touch_up(self, touch):
        if self.collide_point(*touch.pos):
            # 触摸结束后恢复ScrollView的滚动能力
            self.parent.parent.scroll_timeout = 250
            return super().on_touch_up(touch)
        return super().on_touch_up(touch)

然后修改main.kv中所有的MDSwiper标签替换为CustomMDSwiper即可：

# 替换前
MDSwiper:
    id: swiper_1
# 替换后
CustomMDSwiper:
    id: swiper_1

方案2：固定ScrollView滚动方向（适配仅纵向滚动场景） #

如果你的ScrollView只需要纵向滚动，不需要横向滚动能力，直接在ScrollView标签中添加配置即可，实现最简单：

ScrollView:
    do_scroll_x: False # 禁止横向滚动

禁用横向滚动后ScrollView不会再拦截横向滑动事件，MDSwiper即可正常接收手势触发动画。

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