全局配置
window
这一部分用于设置小程序的状态栏、导航条、标题以及窗口背景色。以下是核心属性的说明:
- navigationBarBackgroundColor (HexColor)
默认
#000000。设置导航栏的背景颜色。 - navigationBarTextStyle (String)
默认
white。仅支持black或white,控制导航栏标题文字的颜色。 - navigationBarTitleText (String) 导航栏标题的文字内容。
- navigationStyle (String)
导航栏样式,可选值:
default:默认样式。custom:自定义导航栏,只保留右上角胶囊按钮。
- backgroundColor (HexColor)
默认
#ffffff。窗口的背景色。
这里有个容易踩的坑:当我们在 app.json 中设置 backgroundColor 时,在电脑模拟器上往往看不到效果。这是因为该属性指的是'窗体'背景色(即下拉刷新或上拉加载时露出的区域),而非页面内容的背景色。由于电脑模拟器通常不模拟这种滑动交互,所以视觉上会误以为配置无效。
- backgroundTextStyle (String)
下拉 Loading 的样式,仅支持
dark或light。 - backgroundColorTop (String)
默认
#ffffff。顶部窗口的背景色,仅 iOS 支持(微信客户端 6.5.16+)。 - backgroundColorBottom (String)
默认
#ffffff。底部窗口的背景色,同样仅 iOS 支持。
框架特定注意事项
如果你在使用 Wepy 框架开发,需要注意:不能直接在 app.json 的全局配置里设置某些样式,需要在具体使用的页面里单独配置,否则可能不会生效显示。这属于框架层面的限制,实际运行时务必留意。
调试建议
遇到背景色不生效的情况,别急着改代码。先在真机上测试下拉或上拉动作,确认是否是因为模拟器无法渲染窗体背景导致的视觉误差。

