uni-app怎么取消页面左右滑动的默认手势-uni-app-PHP中文网

pages.json 是 ios 侧滑返回唯一可靠配置入口，仅支持 "close" 和 "none"；安卓需配合 onbackpress 拦截，弹窗场景须用 setstyle 动态控制，全局禁用应改 manifest.json 的 app-plus 节点。

uni-app怎么取消页面左右滑动的默认手势

pages.json 里配 `popGesture` 是唯一可靠入口

iOS 的侧滑返回是系统级行为，JS 层根本收不到事件，onBackPress 在 iOS 上压根不触发。想控制，只能从原生层关——而 pages.json 是 uni-app 提供的、最稳定且被官方文档确认的配置入口。

实测有效值只有两个："close" 和 "none"，其他如 "hide" 或大小写混用（如 "None"）均无效。

"close"：iOS 侧滑直接关闭当前 webview（等效调用 uni.navigateBack()），安卓下表现接近默认行为
"none"：彻底禁用侧滑，但注意——安卓设成这个后，物理返回键也会失效，必须额外加 plus.key.addEventListener('backbutton')

页面级配置示例（仅对详情页生效）：

{
  "path": "pages/detail/detail",
  "style": {
    "app-plus": {
      "popGesture": "none"
    }
  }
}

安卓必须配合 `onBackPress` 才算真正拦截

安卓平台所有返回动作（物理键、虚拟导航栏、侧滑手势）最终都会走到 onBackPress 生命周期钩子，但返回值决定是否拦截：

返回 true：表示“我拦住了”，原生返回逻辑终止
返回 false 或不返回：放行，继续走原生回退流程
options.from 可区分来源："backbutton"（物理键/侧滑）或 "navigateBack"（JS 主动调用）

典型写法（只拦物理返回和侧滑，放行 JS 调用）：

uni-app

uni-app 是基于 Vue 的跨端开发框架，适合开发 H5、App、小程序、鸿蒙和多端业务应用。

下载

onBackPress((options) => {
  if (options.from === 'backbutton') {
    return true;
  }
  return false;
})

弹窗场景必须运行时开关 `popGesture`

配置文件只能控制页面加载时的状态，弹窗出现/关闭这类动态场景，必须用 JS 实时控制 webview 样式，否则用户在弹窗里一划，直接退回上一页。

获取当前 webview 实例：this.$mp.page.$getAppWebview()（Vue2/Vue3 均适用）
弹窗打开时设 { popGesture: 'none' }，关闭时务必恢复为 { popGesture: 'close' }
setStyle 是异步操作，无回调，别依赖它立即生效；也不能只在 open 里关，漏掉 close 里的恢复，后续页面就再也侧滑不回去了

示例（弹窗组件内）：

open() {
  this.show = true;
  //#ifdef APP-PLUS
  const wv = this.$mp.page.$getAppWebview();
  wv.setStyle({ popGesture: 'none' });
  //#endif
},
close() {
  this.show = false;
  //#ifdef APP-PLUS
  const wv = this.$mp.page.$getAppWebview();
  wv.setStyle({ popGesture: 'close' });
  //#endif
}