微信小程序_5 全局配置

小程序根目录下的app.json是小程序的全局配置文件,常用配置如下:

1.pages

记录当前小程序所有页面的存放路径

2.windows全局配置小程序窗口的外观

3.tabBar设置小程序底部的tabBar效果

4.style是否启用新版的组件样式

window:

小程序窗口的组成部分:

了解window节点常用的配置项:

以navigationBar开头的是控制标题栏的以background开头的就是控制背景色之类的剩下两个就是控制页面事件的

设置标题栏的文字:

app.json->window->navigationBarTitleText

设置导航栏的背景色:

app.json->window->navigationBarBackgroundColor

修改导航栏文字颜色:

app.json->window->navigationBarTextStyle

注意这里的可选值只有black/white

开启全局下拉刷新:

概念:下拉刷新是移动端的专有名词,指的是通过手指在屏幕上的下拉滑动操作,从而重新加载页面数据的行为

app.json->window->enablePullDownRefresh的值设置为true

"enablePullDownRefresh": true

注意:在app.json中开启下拉刷新的功能,它会作用在每个小程序页面

注意:此时在模拟器上下拉刷新之后会自动合上,但是在真机上面并不会,所以在开发中不要过于相信模拟器的运行效果

设置下拉刷新的窗口背景色:

当全局开启下拉刷新功能之后,默认的窗口背景为白色,如果自定义下拉刷新窗口的背景色:

app.json->window->backgroundColor:

设置下拉刷新时loading的样式:

当全局开启下拉刷新功能之后,默认窗口的loading样式为白色,如果要更改loading样式的效果,设置步骤:

app.json->window->backgroundTextStyle

设置上拉触底的距离:

概念:上拉触底是移动端的专有名词,通过手指在屏幕上的下拉滑动操作,从而加载更多数据的行为

app.json->window->onReachBottomDistance

注意:默认距离为50px,如果没有特殊需求,建议使用默认值即可:

tabBar

什么是tabBar:

tabBar是移动端应用常见的页面效果,用于实现多页面的快速切换,小程序中通常将其分为:

底部tabBar顶部tabBar

注意:

tabBar中只能配置最少2个,最多5个tab标签当渲染顶部tabBar时,不显示icon,只显示文本

tabBar的6个组成部分:

backgroundColor:tabBar的背景色selectedIconPath:选中时的图片路径borderStyle:tabBar上边框的颜色iconPath:未选中时的图片路径selectedColor:tab上的文字选中时的颜色color:tab上文字的默认(未选中)颜色

tabBar节点的配置项:

每个tab项的配置选项:

如(看tabBar的配置):

app.json:

{"pages": ["pages/person/person","pages/usekey/usekey","pages/for/for","pages/hidden/hidden","pages/block/block","pages/if/if","pages/fuzhi/fuzhi","pages/chuancan/chuancan","pages/bindtap/bindtap","pages/mustache/mustache","pages/img/img","pages/button/button","pages/text/text","pages/swiper/swiper","pages/list/list","pages/index/index","pages/logs/logs"],"window": {"backgroundTextStyle": "dark","navigationBarBackgroundColor": "#b70509","navigationBarTitleText": "微信小程序开发","navigationBarTextStyle": "white","enablePullDownRefresh": true,"backgroundColor": "#8eed97","onReachBottomDistance": 200},"tabBar": {"list": [{"pagePath": "pages/index/index","text": "index","iconPath": "/images/index.png","selectedIconPath": "/images/indexSelected.png"},{"pagePath": "pages/person/person","text": "person","iconPath": "/images/person.png","selectedIconPath": "/images/personSelected.png"}]},"style": "v2","sitemapLocation": "sitemap.json"}

运行:

配置tabBar:

步骤一:拷贝图标资源

1.把资料目录中的images文件夹,拷贝到小程序项目跟目录中

2.将需要用到的小图标分为3组,每组两个,其中:

图片名称中包含-active的是选中之后的图标名字中不包含-active的是默认图标

步骤二:新建三个对应的tab页面:

通过app.json文件的pages节点,快速新建3个对应的tab页面,示例代码如下:

"pages": ["pages/person/person","pages/usekey/usekey","pages/for/for",]

注意,tabBar中的页面必须放在app.json的page中的最前面,否则tab页签会无法正常显示,如:

app.json:

{"pages": ["pages/index/index","pages/person/person","pages/usekey/usekey","pages/for/for","pages/hidden/hidden"],"window": {"backgroundTextStyle": "dark","navigationBarBackgroundColor": "#b70509","navigationBarTitleText": "微信小程序开发","navigationBarTextStyle": "white","enablePullDownRefresh": true,"backgroundColor": "#8eed97","onReachBottomDistance": 200},"tabBar": {"list": [{"pagePath": "pages/index/index","text": "index","iconPath": "/images/index.png","selectedIconPath": "/images/indexSelected.png"},{"pagePath": "pages/person/person","text": "person","iconPath": "/images/person.png","selectedIconPath": "/images/personSelected.png"}]},"style": "v2","sitemapLocation": "sitemap.json"}

tabBar中的index,person,在pages中也要放在前面

如果觉得《微信小程序_5 全局配置》对你有帮助，请点赞、收藏，并留下你的观点哦！