一、window常用配置
1.小程序根目录下的app.json文件时小程序的全局配置文件。常用配置项如下:
① pages
记录当前小程序所有页面的存放路径
② window
全局设置小程序窗口的外观
③ tabBar
设置小程序底部的tabBar效果
④ style
是否启用新版的组件样式
2.window常用配置项
3.设置导航栏的标题
设置步骤:app.json->window->navigationBarTitleText 修改保存即可,导航栏背景颜色修改只支持十六进制。
注意:navigationBarTextStyle的可选值只支持black和white。
4.全局开启下拉刷新功能
设置步骤:app.json->window->把enablePullDownRefresh的值设为true
注意:在app.json中启用下拉刷新功能,会作用于每个小程序页面。
5.设置下拉刷新时窗口的背景颜色
当全局开启下拉刷新功能之后,默认的窗口背景为白色。如果自定义下拉刷新窗口背景色,设置步骤为:app.json->window->为backgroundColor指定16进制的颜色值。
6.设置下拉刷新时loading的样式
当全局开启下拉刷新功能之后,默认窗口的loading样式为白色,如果要更改loading样式的效果,设置步骤为:app.json->window->为backgroundTextStyle指定dark值(注意:可选值只有light和dark两个)。
7.设置上拉触底的距离
上拉触底是移动端的专有名词,通过手指在屏幕上的上拉滑动操作,从而加载更多数据的行为。
设置步骤:app.json->window->为onReachBottomDistance设置新的值(注意:默认距离为50px,没有特殊需求,建议使用默认)
二、tabBar全局配置
1.什么是tabBar
tabBar是移动端应用常见的页面效果,用于实现多页面的快速切换,小程序中通常分为底部tabBar和顶部tabBar。
注意:
tabBar中只能配置最少2个,最多5个tab页签
当渲染顶部tabBar时,不显示icon图标,只显示文本
2.tabBar的6个组成部分
① backgroundColor:tabBar的背景色
② selectedIconPath:选中时的图片路径
③ borderStyle:tabBar上边框的颜色
④ iconPath:未选中时的图片路径
⑤ selectedColor:tab上的文字选中时的颜色
⑥ color:tab上文字的默认(未选中)颜色
3.tabBar节点配置项
每个tab项的配置选项
window节点平级定义tabBar节点:
"tabBar": {
"list": [
{
// 定义的页面路径
"pagePath": "pages/list/list",
"text": "首页"
},
{
"pagePath": "pages/test/test",
"text": "我的"
}
]
},
注意:tabPage页面的组件要放到pages节点内部最前面,否则页面没效果。
三、页面配置文件
1.页面配置文件的作用
小程序中,每个页面都有自己的.json配置文件,用来对当前页面的窗口外观,页面效果等进行配置。
2.页面配置和全局配置的关系
小程序中,app.json中的window节点,可以全局配置小程序中每个页面的窗口表现。如果某些小程序页面想要拥有特殊的窗口表现,此时,页面的.json配置文件就可以实现这种需求。
注意:当页面配置与全局配置冲突时,根据就近原则,最终的效果以页面配置为准。
3.页面配置中常用的配置项