MAUI中CollectionView侧滑SwipeItem触发点击及iOS崩溃问题

一、侧滑时触发Item点击事件的修复 #

CollectionView结合SwipeView时，侧滑动作会误触Item点击，核心原因是手势事件冒泡导致的，可通过以下两种方式解决：

方法1：用状态标记区分侧滑与点击 #

1. 在页面ViewModel中添加布尔属性IsSwiping，标记当前是否处于侧滑状态
2. 给SwipeView绑定SwipeStarted和SwipeEnded事件：

   <SwipeView SwipeStarted="SwipeView_SwipeStarted" SwipeEnded="SwipeView_SwipeEnded">
       <!-- 你的SwipeItem集合与Item内容布局 -->
   </SwipeView>
   

3. 在代码后台更新状态：

   private void SwipeView_SwipeStarted(object sender, SwipeStartedEventArgs e)
   {
       ViewModel.IsSwiping = true;
   }
   
   private void SwipeView_SwipeEnded(object sender, SwipeEndedEventArgs e)
   {
       ViewModel.IsSwiping = false;
   }
   

4. 在Item的点击事件（如TapGestureRecognizer的Tapped事件、CollectionView的SelectionChanged事件）中判断状态：

   private void Item_Tapped(object sender, EventArgs e)
   {
       if (ViewModel.IsSwiping) return;
       // 执行原本的Item点击逻辑
   }
   

方法2：阻止SwipeView的手势冒泡 #

给SwipeView添加TapGestureRecognizer，并将事件标记为已处理，避免触发上层Item的点击：

<SwipeView>
    <SwipeView.GestureRecognizers>
        <TapGestureRecognizer Tapped="SwipeView_Tapped" />
    </SwipeView.GestureRecognizers>
    <!-- 你的SwipeItem集合与Item内容布局 -->
</SwipeView>

private void SwipeView_Tapped(object sender, EventArgs e)
{
    e.Handled = true;
}

二、iOS 17模拟器中CollectionView冻结崩溃的修复 #

该问题属于MAUI与iOS 17的兼容性问题，可尝试以下解决方案：

• 升级MAUI版本：将项目升级到.NET 7.0.400+或.NET 8正式版，微软在后续版本中修复了多个iOS 17相关的CollectionView渲染崩溃问题
• 禁用虚拟化缓存：在CollectionView中设置CachingStrategy="RetainElement"，避免虚拟化逻辑引发的异常：

  <CollectionView CachingStrategy="RetainElement">
      <!-- 你的ItemTemplate与布局配置 -->
  </CollectionView>
  

• 调整ItemsLayout：改用明确的线性布局，避免自定义布局的兼容性问题：

  <CollectionView.ItemsLayout>
      <LinearItemsLayout Orientation="Vertical" />
  </CollectionView.ItemsLayout>
  

• 修改iOS项目配置：在iOS项目的Info.plist中添加以下配置，禁用iOS 17的间接输入事件特性：

  <key>UIApplicationSupportsIndirectInputEvents</key>
  <false/>
  

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