pages.json配置popGesture是最稳的入口，因iOS侧滑返回是系统级行为，JS无法捕获；实测有效值仅"close"（iOS侧滑关闭webview）和"none"（禁用侧滑但安卓物理键也失效）。
pages.json 里配 popGesture 是最稳的入口
iOS 真机侧滑返回根本不会触发 onBackPress，因为那是系统级导航行为，JS 层收不到事件。想拦截？得先关掉原生手势，把控制权拿回来。pages.json 就是唯一可靠入口，不是写 JS，是改配置。
每个页面单独控制，全局配置只影响新打开的页面，已加载的页面不会动态生效。实测有效值只有 "close" 和 "none"：
-
"close"：iOS 侧滑时直接关闭当前 webview（等效于调用close()），安卓下表现接近默认行为 -
"none"：彻底禁用侧滑，但安卓设成这个后，物理返回键也会失效，必须额外监听plus.key.addEventListener('backbutton')
示例（仅对详情页禁用）：
{
"path": "pages/detail/detail",
"style": {
"popGesture": "close"
}
}
安卓平台 onBackPress 返回 true 才算真正拦截
安卓的侧滑/返回键都会进 onBackPress，但返回值有讲究：return true 表示“我拦住了”，return false 或不返回，等于放行，继续走原生逻辑。
options.from 可区分来源，常见值只有两个：
-
"backbutton"：来自物理返回键、虚拟导航栏返回键、或安卓侧滑手势 -
"navigateBack"：来自 JS 主动调用uni.navigateBack()
所以常规写法是：
onBackPress((options) => {
if (options.from === 'backbutton') {
return true // 拦住所有安卓返回动作
}
return false // 允许 navigateBack 正常执行
})
iOS 页面级动态开关要用 $getAppWebview().setStyle()
配置文件只能控制页面初始状态，弹窗、Tab 切换等场景需要运行时开关。iOS 弹窗出现时要禁用侧滑，关闭后得立刻恢复，否则用户点左上角返回会失灵。
关键点：
- 必须用
this.$mp.page.$getAppWebview()获取当前页面 webview 实例（Vue2/Vue3 均适用） - 设
{ popGesture: 'none' }禁用，设{ popGesture: 'close' }恢复 - 不能只在
open()里关，必须在close()里重新开，否则后续页面无法侧滑返回
注意：setStyle 是异步操作，无回调，别依赖它立即生效。
自定义手势动画别碰 left 或 margin
关掉原生侧滑只是第一步，真要做自定义滑动退出，动画性能很关键。iOS WebView 对重排敏感，用 left 或 margin 触发 layout，卡顿明显。
正确做法是纯 CSS transform：
- 给容器加
transform: translateX(-100%)+transition: transform 0.3s ease-out - 手势过程中务必加
touch-action: pan-y，否则 iOS 会抢走横向 touch 事件 - 判断是否从左侧边缘触发：只响应
touches[0].clientX < 40的滑动，避免误触列表滚动
还有个隐形坑：别在 onBackPress 里直接调 uni.navigateBack()，此时页面还在退场动画中，会冲突卡死。正确姿势是 return true，自己做动画，再用 setTimeout(() => uni.navigateBack({ delta: 1 }), 300)。
