如何使用SwiftUI实现列表项长按手势且不与滑动删除操作冲突

冲突原因 #

SwiftUI 默认的长按手势识别优先级高于列表的滚动手势，手指按下时系统会优先判断是否触发长按，直接拦截了列表的滑动事件，导致滚动失效。

解决方案 #

通过调整长按手势的核心参数，平衡长按和滑动的识别逻辑即可解决问题，无需额外引入自定义手势或底层桥接代码。

核心修改点 #

给onLongPressGesture修饰器显式设置两个参数：

• minimumDuration：长按触发的最短时长，建议设置为0.3~0.8秒，避免和点击、滑动误触发
• allowableMovement：长按识别过程中允许手指移动的最大距离，建议设置为30~60点，超过这个距离系统会自动终止长按识别，将事件交还给列表处理滚动

完整代码示例 #

import SwiftUI

struct MailItem: Identifiable {
    let id = UUID()
    let title: String
    let content: String
}

struct MailListView: View {
    let mailItems: [MailItem] = [
        MailItem(title: "会议邀请", content: "本周三下午两点产品评审会"),
        MailItem(title: "账单通知", content: "您本月的信用卡账单已生成"),
        MailItem(title: "快递提醒", content: "您的包裹已放入代收点")
    ]
    
    var body: some View {
        NavigationStack {
            List {
                ForEach(mailItems) { item in
                    VStack(alignment: .leading, spacing: 4) {
                        Text(item.title)
                            .font(.headline)
                        Text(item.content)
                            .font(.subheadline)
                            .foregroundColor(.secondary)
                    }
                    // 长按手势配置
                    .onLongPressGesture(minimumDuration: 0.5, allowableMovement: 50) {
                        // 此处替换为你的自定义长按操作，比如弹出预览菜单
                        print("触发长按操作：\(item.title)")
                    }
                    // 左滑删除配置
                    .swipeActions(edge: .trailing, allowsFullSwipe: true) {
                        Button(role: .destructive) {
                            // 此处替换为你的删除逻辑
                            print("删除邮件：\(item.title)")
                        } label: {
                            Label("删除", systemImage: "trash")
                        }
                    }
                }
            }
            .navigationTitle("邮件")
        }
    }
}

效果验证 #

修改后即可实现和系统邮件App完全一致的交互逻辑：

• 上下拖动列表可以正常滚动浏览
• 条目左滑可以呼出删除按钮
• 按住条目不动超过0.5秒，且手指移动距离不超过50点时触发长按操作
  

注意事项 #

• 不要使用highPriorityGesture修饰长按手势，该修饰符会强制提升长按手势的优先级，必然会拦截列表的滚动事件
• 如果需要同时支持点击手势，无需额外设置优先级，系统会自动区分点击和长按

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