navigationBarTextStyle控制状态栏图标颜色，仅支持"white"或"black"，须配navigationStyle:"custom"且写在页面style下；H5端无效，小程序需基础库≥2.7.0，App端需plus.navigator.setStatusBarStyle配合。
pages.json里配navigationBarTextStyle是最直接生效的方式
只要页面启用了自定义导航栏（navigationStyle: "custom"），navigationBarTextStyle 就会控制状态栏图标（时间、信号、电量）和系统胶囊按钮的文字颜色——不是“标题文字”，而是最顶上那条系统栏的全部前景色。
它只接受两个值："white" 或 "black"，大小写敏感，其他值如 "#ffffff" 或 "light" 全部无效。
- 配置必须写在对应页面的
style下，全局tabBar或globalStyle里不生效 - H5 端完全忽略该字段，iOS 微信小程序需基础库 ≥ 2.7.0 才识别，App 端依赖原生层是否启用 UIViewControllerBasedStatusBarAppearance（iOS）或 windowLightStatusBar（Android）
- 真机测试时，小米/华为等厂商可能强制跟随系统深色模式，此时配置会被覆盖，需监听
wx.onThemeChange（小程序）或plus.navigator.getStatusBarStyle（App）做重设
App端调用plus.navigator.setStatusBarStyle才真正可控
navigationBarTextStyle 在 App 端只是声明式配置，实际生效靠的是 plus.navigator.setStatusBarStyle。这个 API 必须在页面就绪后调用，onLoad 太早，plus 对象可能未初始化。
正确写法：
onReady() {
// #ifdef APP-PLUS
setTimeout(() => {
plus.navigator.setStatusBarStyle('light'); // light = 白字，dark = 黑字
}, 100);
// #endif
}
-
'light'对应白色图标，'dark'对应黑色图标；注意和navigationBarTextStyle的值命名不一致，别混淆 - Android 需确保
android:windowLightStatusBar="true"已在AndroidManifest.xml中配置，否则即使 JS 调用成功，状态栏仍为白字（不可见） - iOS 必须在原生工程中确认
Info.plist的UIViewControllerBasedStatusBarAppearance为YES，否则此 API 完全无响应
微信小程序里navigationBarTextStyle生效但有兼容陷阱
小程序端 navigationBarTextStyle 确实能控制状态栏颜色，但前提是：整个应用的 app.json（或 manifest.json 对应字段）不能把 navigationStyle 设为 "default" —— 否则子页面单独配置会被忽略。
常见错误现象：
- 开发工具显示正常，真机（尤其 iOS）仍是白字：检查基础库版本，低于 2.7.0 不支持
custom下的该字段 - 部分安卓机（如 OPPO ColorOS）状态栏图标颜色与配置相反：这是系统级 bug，只能换背景色适配，无法通过 JS 修复
- 动态切换失败：该字段非响应式，改 data 不触发重绘，必须用
uni.reLaunch或条件编译 + 页面级重载
H5端没有API，别试uni.setNavigationBarColor
uni.setNavigationBarColor 只改导航栏背景色，对状态栏字体颜色零影响；H5 浏览器根本不暴露该能力，所有声称“H5 可改状态栏颜色”的方案，本质都是用 20px 高占位元素模拟视觉效果。
可行做法只有：
- 顶部加一个
<view class="status-bar-fake"></view>，高度硬编码为20px（iOS）或通过 UA 判断 - 该元素背景色必须和你的自定义导航栏一致，形成视觉连贯性
- 导航栏组件本身用
position: fixed; top: 20px;，而非top: 0，否则文字会被系统状态栏裁掉 - 务必在
<meta name="viewport">中加入viewport-fit=cover，否则 Safari 会额外留安全区，导致错位
所谓“API 调用”，在 H5 上就是个伪命题——浏览器没给口子，JS 再努力也绕不过去。
