Kivy中MDSwiper内嵌垂直ScrollView后水平滚动失效如何解决

问题出在Kivy的触摸事件分发机制：内部垂直ScrollView默认会优先消费所有触摸事件，外层MDSwiper无法接收到水平滑动的事件输入，所以水平切换功能失效。

通过自定义MDSwiperItem的触摸事件分发逻辑，区分水平/垂直滑动手势，对应分发到不同组件处理即可，不需要修改官方源码。

1. 调整KV定义 #

<MySwiperItem@MDSwiperItem>
    width_mult: 1

    ScrollView:
        id: inner_scroll
        MDBoxLayout:
            orientation: 'vertical'
            adaptive_height: True
            # 此处可添加实际业务内容组件
<MySwiper@MDSwiper>
    items_spacing: 0
    do_scroll: True
    MySwiperItem:
    MySwiperItem:
    MySwiperItem:

2. 补充触摸事件判断逻辑 #

在Python代码中重写MySwiperItem的触摸事件处理方法：

from kivymd.uix.swiper import MDSwiperItem

class MySwiperItem(MDSwiperItem):
    def __init__(self, **kwargs):
        super().__init__(**kwargs)
        self.touch_start_x = 0
        self.touch_start_y = 0

    def on_touch_down(self, touch):
        if self.collide_point(*touch.pos):
            self.touch_start_x = touch.x
            self.touch_start_y = touch.y
        return super().on_touch_down(touch)

    def on_touch_move(self, touch):
        if self.collide_point(*touch.pos):
            dx = touch.x - self.touch_start_x
            dy = touch.y - self.touch_start_y
            # 水平滑动偏移大于垂直偏移时，将事件交给外层MDSwiper处理
            if abs(dx) > abs(dy):
                # 冻结内部ScrollView的滚动状态
                self.ids.inner_scroll.scroll_y = self.ids.inner_scroll.scroll_y
                # 事件传递给父级Swiper处理
                return self.parent.on_touch_move(touch)
        return super().on_touch_move(touch)

可选优化 #

可以根据交互习惯调整判断阈值，比如设置abs(dx) > abs(dy) + 10，增加滑动判定容错，避免小幅滑动触发误操作；如果内部有按钮、输入框等可交互组件，可额外加事件排除逻辑，不影响常规组件功能。

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