navigationstyle: "custom" 后顶部点击失效，主因是原生导航栏逻辑未同步关闭，需在 pages.json 的 style 中同时配置 "navigationstyle": "custom" 和 "app-plus": {"titlenview": false"}；plus.navigator.setfullscreen(true) 必须在 onshow 中用 #ifdef app-plus 包裹调用，且真机 apk 调试才有效。
navigationStyle: "custom" 后顶部区域点击无响应
页面顶部区域（尤其是自定义导航栏）点击失效，不是 CSS 遮挡或 z-index 问题，而是原生层窗口标志未正确设置导致的触摸事件穿透或拦截。navigationStyle: "custom" 只是让前端接管渲染权，但若未同步关闭原生导航栏逻辑，系统仍会把状态栏区域当作“不可交互区”处理。
- 必须在对应页面的
pages.json的style节点下同时配置："navigationStyle": "custom""app-plus": {"titleNView": false} - 缺一不可：只设
navigationStyle时，titleNView默认为true，原生导航栏虽不可见，但其触摸上下文仍在，会吞掉顶部 24–44px 区域的点击事件 - 真机上部分厂商系统（如华为 EMUI、小米 HyperOS）对此更敏感，模拟器完全测不出该问题
plus.navigator.setFullscreen(true) 调用时机错误
调了 setFullscreen(true) 却没效果，或者只在部分机型生效，大概率是生命周期错位。
- 必须用
#ifdef APP-PLUS包裹，否则 H5 或小程序环境会报plus is not defined - 必须在
onShow或onLaunch中调用，不能放在mounted/created/onLoad：Vue 实例创建时plus环境尚未注入，调用静默失败 - 若页面有路由缓存（如
keep-alive），onShow是唯一可靠入口；onLoad在首次加载后不再触发，后续切换不会重置全屏状态
自定义导航栏内元素无法点击的 CSS 原因
即使原生层已放开，前端样式仍可能阻断事件流。
-
background-color: transparent是必须的，但若同时设置了opacity: 0.99或rgba(0,0,0,0.01)，某些 Android WebView 会将该层判定为“非完全透明”，从而拒绝透传点击 - 不要给导航栏容器加
pointer-events: none或父级设了该属性（常见于下拉刷新遮罩层残留） - 检查是否意外设置了
z-index: -1或position: fixed且top: 0但未设height，导致元素实际渲染高度为 0，视觉可见但点击区域为空 - 使用 Chrome DevTools 连真机调试时，用「Toggle device toolbar」→「Select element to inspect」点顶部，确认选中的是你的导航栏 DOM，而非空白
view或被覆盖的占位元素
状态栏占位后内容上移却点不到导航栏
用了 padding-top: var(--status-bar-height)，但导航栏本身在 padding 区域外，导致点击区实际悬空。
- 正确结构应是：根容器设
padding-top，导航栏作为子元素紧贴顶部（即margin-top: -var(--status-bar-height)或用绝对定位拉回） - 更稳妥做法是不用 padding，改用一个固定高度的占位
view：<view class="status-bar-placeholder" style="height: var(--status-bar-height);"></view>
再让导航栏position: relative或直接跟在其后，确保 DOM 顺序与视觉顺序一致 - 避免在导航栏内部嵌套
uni-nav-bar后又手动设position: absolute：它内部有多个 slot 和 fixed 定位逻辑，极易破坏事件捕获链
真机调试必须用正式打包的 APK，HBuilderX 模拟器不触发原生窗口 flags，也无真实触摸事件分发路径，所有点击问题在此环境下均不可复现。
