文档开发者中心
我的
|

HarmonyOS 5

如何禁止侧滑返回上一级

已解决
启动应用时阅读隐私政策后返回,隐私弹窗消失,无法先同意隐私政策再进入应用,那如何禁止侧滑返回上一级或者有什么拦截事件可以实现吗?
点赞
收藏
回复
4
分享
举报
浏览1344 发布于2025-08-29 09:04广东
全部评论
最多点赞
最新发布
最早发布
|
采纳答复

【背景知识】

  • 自定义弹窗 (CustomDialog)通常用于在保持当前的上下文环境时,临时展示用户需关注的信息或待处理的操作,用户在弹出框内完成需要进行交互的任务。
  • 组件导航(Navigation)主要用于实现页面间以及组件内部的页面跳转,同时可以用@component组件模拟弹窗。

【解决方案】
方案一:通过onWillDismiss进行拦截。
当用户执行点击遮障层关闭、左滑/右滑、三键back、键盘ESC关闭交互操作时,如果注册该回调函数,则不会立刻关闭弹窗,可在回调函数中得到阻拦关闭弹窗的操作类型,从而根据原因选择是否能关闭弹窗,当满足条件时可使用dismissDialogAction.dismiss()关闭弹窗。具体可以参考以下代码:

收起
自动换行
深色代码主题
复制
@CustomDialog
struct CustomDialogPage {
  controller: CustomDialogController

  build() {
    Column() {
      Button('关闭弹窗')
        .onClick(() => {
          this.controller.close()
        })
    }
    .height(200)
    .justifyContent(FlexAlign.Center)
    .alignItems(HorizontalAlign.Center)
  }
}

@Entry
struct Index {
  dialogController: CustomDialogController = new CustomDialogController({
    builder: CustomDialogPage(),
    onWillDismiss: (dismissDialogAction: DismissDialogAction) => {
      // 参数说明
      // PRESS_BACK为点击三键back、左滑/右滑、键盘ESC退出。
      // TOUCH_OUTSIDE为点击遮障层退出。
      // CLOSE_BUTTON为点击关闭按钮退出。
      // SLIDE_DOWN为下拉关闭(适用于半模态转场)
      if (dismissDialogAction.reason == DismissReason.PRESS_BACK) {
        // ...
        // 可使用dismiss方法可关闭弹窗,dismissDialogAction.dismiss()
      }
    },
  })

  build() {
    Column() {
      Button('打开弹窗')
        .onClick(() => {
          this.dialogController.open()
        })
    }
  }
}

方案二:通过Navigation相关能力,用@component组件模拟弹窗,再利用onBackPress去拦截。
通过设置函数onBackPress返回true,使页面自己处理返回逻辑,不进行页面路由,从而实现拦截效果。具体可以参考以下代码:

收起
自动换行
深色代码主题
复制
@Component
struct CustomDialogPage {
  @Consume('pageInfos') pageInfos: NavPathStack

  build() {
    NavDestination() {
      Column() {
        Button('关闭弹窗')
          .onClick(() => {
            this.pageInfos.pop()
          })
      }
      .height(200)
      .justifyContent(FlexAlign.Center)
      .alignItems(HorizontalAlign.Center)
    }
    .hideTitleBar(true)
    .title('CustomDialogPage')
    .onBackPressed((): boolean => {
      return true;
    })
  }
}

@Entry
struct Index {
  @Provide('pageInfos') pageInfos: NavPathStack = new NavPathStack()

  @Builder
  CustomDialogPageMap(name: string) {
    if (name === 'CustomDialogPage') {
      CustomDialogPage()
    }
  }

  build() {
    Navigation(this.pageInfos) {
      Column() {
        Button('打开弹窗')
          .onClick(() => {
            this.pageInfos.pushPathByName('CustomDialogPage', undefined)
          })
      }
    }.title('Index').navDestination(this.CustomDialogPageMap)
  }
}
展开全部
3楼回复于2025-09-01 03:35 来自广东
当界面执行返回操作时,会触发自定义组件的生命周期回调函数onBackPress。​若设置该函数返回true,​则表示页面自行处理返回逻辑,​阻止​默认的页面路由行为,从而实现​​返回操作​​拦截效果。
4楼回复于2025-09-01 05:51 来自广东

✅ 方案一:通过弹窗属性禁止遮罩层点击关闭(适用于弹窗本身)

在隐私弹窗的配置中,设置 autoCancel: false,这样点击遮罩层不会关闭弹窗,但需注意:此设置仅针对遮罩层点击,不拦截手势返回或物理返回键。

适用接口/属性(来自文档):

  • autoCancel(promptAction、CustomDialog 等组件):
    设置为 false 后,点击遮罩层不会关闭弹窗。
    示例(以 promptAction 为例):
    收起
    自动换行
    深色代码主题
    复制
    promptAction.showDialog({
      // ...其他配置
      autoCancel: false, // 禁止点击遮罩层关闭
    });
    

✅ 方案二:拦截系统返回事件(全局拦截)

通过重写 onBackPressed() 方法或注册返回事件监听,在隐私弹窗显示时拦截返回操作。

1. 在UIAbility中拦截返回事件(来自 js-apis-app-ability-uiAbility.md):

收起
自动换行
深色代码主题
复制
import { UIAbility } from '@kit.AbilityKit';

export default class EntryAbility extends UIAbility {
  onBackPressed(): boolean {
    // 判断当前是否在隐私弹窗页面
    if (需要拦截返回) {
      return true; // 拦截返回,不销毁UIAbility
    }
    return false; // 允许返回
  }
}

2. 在页面或组件中拦截返回键(来自 ts-basic-components-search.md):

收起
自动换行
深色代码主题
复制
Button('隐私同意')
  .stopBackPress(true) // 阻止返回键事件传递

✅ 方案三:使用弹窗的交互式关闭拦截(onWillDismiss)

通过注册 onWillDismiss 回调,在用户尝试通过手势返回、点击遮罩层、物理返回键等方式关闭弹窗时进行拦截,并自定义处理逻辑(例如:必须点击“同意”按钮才能关闭)。

适用接口(来自 js-apis-promptAction.md):

收起
自动换行
深色代码主题
复制
promptAction.showDialog({
  // ...其他配置
  autoCancel: false, // 建议同时设置
  onWillDismiss: (reason: DismissDialogAction) => {
    // 根据关闭原因判断是否允许关闭
    if (reason === DismissReason.BACK_PRESS || reason === DismissReason.TOUCH_OUTSIDE) {
      // 不允许关闭,弹窗保持显示
      return false; 
    }
    return true; // 允许关闭
  }
});

✅ 方案四:禁用全局手势返回(适用于应用内)

通过以下接口禁用应用内的侧滑返回功能(来自 arkts-apis-uicontext-uicontext.md):

收起
自动换行
深色代码主题
复制
// 在UI上下文环境中禁用侧滑返回
getUIContext().enableSwipeBack(false);

✅ 推荐组合方案

  1. 设置弹窗属性:
    autoCancel: false(禁止遮罩层点击关闭)。
  2. 拦截返回事件:
    在UIAbility或页面中通过 onBackPressed() 或 stopBackPress(true) 拦截返回键。
  3. 启用弹窗关闭拦截:
    通过 onWillDismiss 回调拦截所有关闭行为,仅允许通过“同意”按钮关闭。
展开全部
2楼回复于2025-08-29 13:39 来自广东

如果你使用的是 Navigation 作为导航。

onBackPressed(callback: () => boolean)

当与Navigation绑定的导航控制器中存在内容时,此回调生效。当点击返回键时或侧滑返回,触发该回调。

返回值为true时,表示重写返回键逻辑,返回值为false时,表示回退到上一个页面。

收起
自动换行
深色代码主题
复制
NavDestination() {
  Column() {
  }
}
.hideTitleBar(true)
.onBackPressed(() => {
  return true  //拦截返回
})
1楼回复于2025-08-29 11:33 来自四川
写回答
新增插入模板功能
一键使用模板,快速填写内容,轻松发帖~
知道了
  • 为了保障您的信息安全,请勿上传您的敏感个人信息(如您的密码等信息)和您的敏感资产信息(如关键源代码、签名私钥、调试安装包、业务日志等信息),且您需自行承担由此产生的信息泄露等安全风险。
  • 如您发布的内容为转载内容,请注明内容来源。

我要提问题

了解社区公约,与您携手共创和谐专业的开发者社区。