微信小程序原生仅支持light/dark状态栏文字色,uni-app的navigationBarTextStyle在navigationStyle: custom时失效;需手写导航栏并用CSS控制文字颜色,配合statusBarHeight适配安全区。
因为微信小程序原生不支持直接修改状态栏文字颜色(仅支持 light / dark 两种模式),而 uni-app 的 navigationBarTextStyle 实际只是透传给微信的 navigationStyle: default 下的配置,**仅在页面级配置且未开启自定义导航栏时才生效**。一旦你用了 navigationStyle: custom(即隐藏原生导航栏、手写标题栏),navigationBarTextStyle 就完全失效。
必须放弃依赖 navigationBarTextStyle,改用 CSS 控制你手写的标题区域文字颜色。常见做法是:在页面根节点上加 class,配合 statusBarHeight 做安全区适配,并手动设置文字颜色。
pages.json 中该页面配置设为:"navigationStyle": "custom"
<template> 中,用 <view class="nav-bar"><text class="title">我的页面</text></view>
uni.getSystemInfoSync().statusBarHeight 获取状态栏高度,在 onLoad 或 onShow 中赋值给 data,驱动样式.title { color: #ffffff; }(深色背景配白字)或 #000000(浅色背景配黑字)uni.getSystemInfoSync().statusBarHeight 在真机上返回正常,但在微信开发者工具中可能返回 0 或错误值(尤其旧版本工具)。更稳妥的方式是:优先读取 uni.getMenuButtonBoundingClientRect() 推算,或 fallback 到固定值 44px(iPhone X+ 系列典型值)。
uni.getMenuButtonBoundingClientRect() 返回对象含 top 和 height,状态栏高度 ≈ top - statusBarHeight(需结合机型判断)statusBarHeight: 44,并用 @supports (padding-top: env(safe-area-inset-top)) 做兼容created 钩子中调用,微信小程序生命周期里此时 uni API 可能未就绪,建议放 onLoad
微信小程序本身不提供「深色模式下自动翻转文字色」的 API,uni-app 也没有封装该能力。如需跟随系统,只能手动监听并判断:
wx.onThemeChange(基础库 2.11.0+ 支持),在回调中更新 titleColor datawx.getSystemInfoSync().theme 获取当前主题(返回 light 或 dark)#ifdef MP-WEIXINwx.onThemeChange && wx.onThemeChange(res => { this.titleColor = res.theme === 'dark' ? '#ffffff' : '#000000'})#endif
微信小程序的“状态栏文字颜色”本质是系统级控制,uni-app 能做的只是模拟视觉效果;真正要稳定呈现,得靠自己画标题栏 + 主动管理颜色 + 安全区适配。别指望配置项一键生效。