App端标题栏透明滚动渐变必须用custom导航栏+onPageScroll实现，pages.json的titleNView仅支持静态背景；需动态计算alpha、联动statusBarStyle、节流更新并处理下拉刷新异常。
App端（iOS/Android）能用原生能力实现标题栏透明滚动渐变，但必须分两层处理：顶部状态栏 + 底部导航栏。不能只靠 pages.json 配置或纯 CSS，否则要么不生效，要么滚动卡顿、文字发虚。
titleNView + backgroundImage 只管背景图，不负责滚动逻辑
App 端唯一能直接控制原生标题栏背景的路径是 pages.json 中的 app-plus → titleNView 节点：
-
backgroundImage支持两种值：本地图片路径（如"static/nav-bg.png"）或 CSS 渐变字符串（如"linear-gradient(to right, #ff0000, #0000ff)"） - 该配置仅在 App 端生效，小程序/H5 完全忽略；且它「静态」生效——页面一加载就渲染，不随滚动变化
- 想实现「滚动中渐变」，必须放弃纯
titleNView，改用自定义导航栏 +onPageScroll动态控制 - 渐变字符串里不能有空格或换行，否则 iOS 端解析失败，回退为默认灰底
custom 导航栏 + onPageScroll 是唯一稳定方案
启用 "navigationStyle": "custom" 后，你完全接管导航栏 DOM，滚动渐变才可控：
- 必须在
pages.json对应页面设"navigationStyle": "custom"，否则onPageScroll不触发 - 导航栏容器用
height: calc(var(--status-bar-height) + 44px)，顶部留白靠padding-top: var(--status-bar-height)，不是 JS 算高度 - 监听
onPageScroll，用scrollTop计算透明度：const alpha = Math.min(1, Math.max(0, e.scrollTop / 120))（120 是推荐临界距离） - 背景不要只用
rgba()插值：iOS 对半透色渲染差，建议组合background-image: url(...)+background: linear-gradient(rgba(255,255,255,0), rgba(255,255,255,${alpha})) - 避免在
onPageScroll里频繁调this.$forceUpdate()或this.setData()，加节流（如 16ms 一次）或用requestAnimationFrame合并更新
iOS 状态栏文字颜色必须手动切，且要联动
用了 navigationStyle: "custom"，uni.setNavigationBarColor 就彻底失效——它只作用于原生栏。iOS 状态栏文字颜色由系统独立控制：
- 必须用
uni.setStatusBarStyle('dark')或'light'主动切换 - 切换时机不能只在
onLoad，得和渐变同步：当alpha < 0.3且背景偏亮时，调uni.setStatusBarStyle('dark') - 加平台判断：
if (uni.getSystemInfoSync().platform === 'ios')，避免在 Android 上白调用 - 注意：Android 不支持
setStatusBarStyle，状态栏文字色由主题色决定，无需也不该干预
最易被忽略的是下拉刷新场景：开启 "enablePullDownRefresh": true 后，webview 整体下拉，透明导航栏下的内容会顶入状态栏区域，导致 Android 黑屏、iOS 闪烁。必须在 onPullDownRefresh 时临时关闭透明效果（比如加 nav-transparent class 控制），并在 stopPullDownRefresh 后恢复。
