ArkTS 鸿蒙全局侧滑返回、手势冲突拦截解决方案

import { Navigation, NavPathStack, NavigationMode } from '@kit.ArkUI'// 全局路由管理类 + 侧滑配置export class NavigationUtil {  // 路由栈  static navStack: NavPathStack = new NavPathStack();  /**   * 设置页面侧滑返回状态   * @param isCanBack 是否允许侧滑返回   * @param sensitivity 灵敏度 1-20（默认8）   */  static setSwipeBackEnable(isCanBack: boolean, sensitivity: number = 8) {    // 获取当前路由栈最顶层页面    const topPage = this.navStack.getAllPathName().pop();    if (!topPage) return;    // 控制侧滑开关 + 滑动灵敏度    Navigation.setNavigationMode(topPage, {      mode: NavigationMode.Stack,      swipeBackEnabled: isCanBack,      edgeSlipSensitivity: sensitivity    })  }  // 页面跳转  static pushPage(path: string, param?: Object) {    this.navStack.pushPath({ name: path, param: param })  }  // 页面返回  static popPage() {    this.navStack.pop();  }  // 清空栈并跳转  static replacePage(path: string) {    this.navStack.clear();    this.navStack.pushPath({ name: path });  }}

import { NavigationUtil } from './utils/NavigationUtil'@Entry@Componentstruct Index {  build() {    // 全局导航根容器    Navigation(NavigationUtil.navStack) {      Column({ space: 15, justifyContent: FlexAlign.Center }) {        Button("进入手势冲突测试页面")          .width("80%")          .onClick(() => {            NavigationUtil.pushPage("SwipeConflictPage")          })        Button("进入禁止侧滑页面")          .width("80%")          .backgroundColor("#ff6b6b")          .onClick(() => {            NavigationUtil.pushPage("DisableSwipePage")          })      }      .width('100%')      .height('100%')      .backgroundColor("#f5f7fa")    }    .title("首页")    // 全局默认开启侧滑、灵敏度适中    .navigationMode({      mode: NavigationMode.Stack,      swipeBackEnabled: true,      edgeSlipSensitivity: 9    })  }}

import { NavigationUtil } from './utils/NavigationUtil'@Componentexport struct SwipeConflictPage {  // 模拟横向列表数据  @State dataList: number[] = [1, 2, 3, 4, 5, 6, 7, 8];  aboutToAppear() {    // 当前页面提高灵敏度，扩大侧边触发范围    NavigationUtil.setSwipeBackEnable(true, 12);  }  build() {    Column({ space: 20 }) {      Text("横向列表-手势冲突优化")        .fontSize(18)        .fontWeight(FontWeight.Bold)        .margin({ top: 20 })      // 横向滚动列表      List() {        ForEach(this.dataList, (item: number) => {          ListItem() {            Text(`卡片${item}`)              .width(120)              .height(180)              .backgroundColor("#e8f3ff")              .borderRadius(12)              .textAlign(TextAlign.Center)          }        })      }      .listDirection(Axis.Horizontal)      .height(200)      // 关键：手势优先级高于页面侧滑，解决冲突      .gesturePriority(GesturePriority.High)      Button("返回上一页")        .onClick(() => NavigationUtil.popPage())    }    .width('100%')    .height('100%')    .padding(15)  }}

import { NavigationUtil } from './utils/NavigationUtil'@Componentexport struct DisableSwipePage {  aboutToAppear() {    // 禁用当前页面侧滑返回    NavigationUtil.setSwipeBackEnable(false);  }  build() {    Column({ justifyContent: FlexAlign.Center, space: 20 }) {      Text("当前页面已禁用侧滑返回")        .fontSize(18)        .fontColor("#ff3333")      Text("只能点击按钮返回，防止误触退出")        .fontSize(14)        .fontColor("#666")      Button("确认返回")        .backgroundColor("#ff6b6b")        .onClick(() => NavigationUtil.popPage())    }    .width('100%')    .height('100%')  }}