uni.setnavigationbarcolor 仅在 app 端和部分小程序平台生效，h5 端完全不支持；app 需开启 custom 导航栏，小程序需同时传 frontcolor 和 backgroundcolor，h5 须用 动态控制。
uni.setNavigationBarColor 在 APP、小程序、H5 各端是否生效
直接说结论：uni.setNavigationBarColor 仅在 App 端（iOS/Android）和微信/支付宝等部分小程序平台有效，H5 端完全不支持，调用即报 undefined is not a function 错误。
常见错误现象包括：H5 控制台报错、App 端设了 backgroundColor 但状态栏仍是透明或系统默认色、小程序里只传 frontColor 导致背景色不生效。
- App 端：必须关闭原生导航栏（即
"navigationStyle": "custom"），否则该 API 只影响导航栏区域，不控制状态栏 - 微信小程序：
frontColor和backgroundColor必须同时传，缺一不可；且仅对当前页面生效，路由跳转后需重新调用 - H5 端：API 未实现，任何调用都无效；别加
#ifdef H5包裹去“兼容”，写了也是白跑
pages.json 中 statusbar.background 配置的适用范围
这个配置只在 App 端真正起作用，且有隐藏副作用：它会让系统自动把状态栏区域“撑高”，导致页面内容上移 —— 你不用手动加占位 view，但原有布局可能被顶出可视区。
常见误用是把它当全局主题开关：在 globalStyle 下配了 app-plus.statusbar.background，结果夜间模式切换时颜色无法动态更新，只能重启页面。
- 推荐写法：按页面级配置，例如
{"path":"pages/home/index","style": {"app-plus": {"statusbar": {"background":"#1e40af"}}}} - 若同时设了
"immersed": false，状态栏会“收进”顶部，background配置直接被忽略 - 小程序和 H5 完全无视该字段，不要指望它跨端生效
自定义导航栏下状态栏背景色怎么画出来
一旦启用 "navigationStyle": "custom"，状态栏就变成“透明窗口”，所有颜色控制权交还给页面自身 —— 此时你得靠 CSS + statusBarHeight 手动画一个。
关键不是“设颜色”，而是“占对位置、透得自然”。纯 linear-gradient 在 iOS 微信里容易断裂，在 Android 某些 WebView 中直接不可见，根本原因是模拟状态栏的 view 缺乏原生合成层级权限。
- 稳定方案是双层
view嵌套：outer设height: {statusBarHeight}px+overflow: hidden，inner用transform: translateY(-{offset}px)向上偏移，让渐变“透出” - 渐变方向统一用
linear-gradient(to bottom, #6a11cb, #2575fc)，避免to top在部分 Android WebView 中反向渲染 - H5 端不能依赖
uni.getSystemInfoSync().statusBarHeight（返回常为 0），iOS 必须用env(safe-area-inset-top)或硬编码 20px
H5 端 iOS 地址栏颜色唯一可控方式
iOS Safari 不认 uni.setNavigationBarColor，也不解析 pages.json 的 statusbar 配置。唯一能影响顶部地址栏颜色的，只有 <meta name="theme-color"> 标签，但它有三道硬门槛。
最易被忽略的是：SPA 路由切换不会触发重载，Safari 不会自动读取新 content 值 —— 所以 onload/onShow 都得写，且必须清空再重设，延迟至少 100ms。
-
<meta>必须在index.html的中，且带id="themeColor" - 颜色值必须是十六进制（如
#1e40af），rgb()或变量名无效 - 动态修改必须分两步：
meta.setAttribute('content', '')→setTimeout(() => meta.setAttribute('content', '#xxx'), 100)
