集成Parchment搭配折叠头部出现异常滚动问题的排查咨询

异常触发的核心原因 #

• 单标签页场景下的内置滚动手势冲突
  Parchment承载横向分页内容的内置scrollView，在仅存在1个可切换页面时，默认不会自动禁用垂直方向的手势监听。该组件位于整个交互响应链的中间层，会优先截获垂直方向的触摸动作，直接带动分页容器整体产生垂直偏移，最终表现为下拉刷新动作刚触发时，分页区域出现无预期的抬升/下落，打断正常的刷新流程。这也是单标签页下异常表现更突出的直接原因。
• 折叠头部联动逻辑覆盖不全
  现有折叠头的实现仅将子页面UITableView的滚动偏移作为头部位置调整的唯一触发源，没有对Parchment自带的菜单collectionView、内置分页scrollView的垂直偏移做兜底判定。当下拉动作落在非tableView的响应区域时，偏移量计算会出现断档，直接造成视图位置跳变。
• 自定义层配置引发的响应判定异常
  代码中为菜单collectionView设置了contentInset、修改了指示器层级与内边距，这些调整会改变菜单视图的响应区域边界。单页场景下菜单本身无水平可滚动距离，会将垂直方向的触摸事件直接向下转发给分页内容区，进一步放大手势冲突的影响。另外代码中为菜单collectionView设置masksToBounds = true的同时添加阴影效果，不仅会导致阴影完全无法渲染，还会裁剪掉视图边界外的响应区域，加剧手势判定的偏差。

对应修复方向 #

• 单标签页场景做针对性适配
  在数据源返回页面数为1的分支中，获取Parchment内置的横向分页scrollView，设置isScrollEnabled = false，从根源上阻断该组件对垂直手势的消费。
• 明确手势响应优先级
  为Parchment的内置scrollView配置手势代理，在手势判定逻辑中明确：仅响应水平方向的滚动事件，所有垂直方向的触摸动作全部透传给子页面的滚动视图与其绑定的下拉刷新控件。
• 补全折叠头联动的偏移统计逻辑
  将Parchment菜单视图、内置分页容器的垂直偏移全部纳入折叠头的位置计算逻辑，避免单组件单独偏移造成的动画跳变，保证下拉刷新与折叠头展开、折叠动作的连贯性。
• 修正图层配置的矛盾设置
  若需要给菜单collectionView添加阴影效果，需移除masksToBounds = true的配置，避免边界裁剪导致的阴影失效与响应区域异常。

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