微信小程序全局配置及常用配置项详解
作者:未及545
一、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.页面配置中常用的配置项
到此这篇关于微信小程序全局配置及常用配置项详解的文章就介绍到这了,更多相关小程序全局配置 内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!