我的微信小程序第三篇(app.json)
前言
端午节回家了,所以好多天没有更新,只想说还是待在家里舒服呀,妈妈各种做好吃的,小侄子侄女各种粘着我在室外玩,导致我三天下来不仅胖了一圈,还黑了一圈,上班第一天有同事就说我晒黑了,哭~~~,为了防止自己的"懒癌"症复发,赶紧打开电脑敲敲字,废话不多说,我们就回到今天的主题,今天给大家介绍下微信小程序框架主体文件中的配置文件(app.json),其实我们在上一篇《我的微信小程序第二篇》中已经对app.json做过简单的描述,在此篇中,我们将对其进行详细的介绍。
正文
app.json是小程序的全局配置文件,编写时需严格遵循json的格式规范,app.json在程序加载时加载,负责全局配置,其配置项有:
-
pages:设置页面路径,必填
-
window:设置默认页面的窗口表现
-
tabBar:设置tab的表现
-
networkTimeOut:设置网络超时时间
-
debug:设置是否开启debug模式,默认关闭false
app.json文件内容整体结构如下;
-
pages配置
pages负责注册小程序页面,必须填写,值为一个包含页面路径的数组,用来指定小程序由哪些页面构成,如下所示:
//页面路径设置
"pages":[
"pages/index/index",
"pages/logs/logs"
]
pages中不需要填写文件后缀名,渲染页面时框架会自动寻找路径.json,.js,.wxml,.wxss四个文件进行整合,建议文件名和目录名保持一致,便于管理,pages配置中第一项代表小程序的初始页面,小程序增加或者修改,删除页面都需要对pages进行相应的调整。
2.window配置
Window负责小程序状态栏,导航条,标题,窗口背景色等系统级样式。属性有:
-
navigationBarBackgroundColor:导航栏背景色,默认值为#fff
-
navigationBarTextStyle:导航栏标题颜色,仅支持black/white,默认值为black
-
navigationBarTitleText:导航栏标题文字内容
-
backgroundTextStyle:下拉背景字体,loading图样式,仅支持dark/light
-
backgroundColor:窗口背景色,默认值为#ffffff
-
enablePullDownRefresh:是否开启下拉刷新,默认为false,开启后,当用户下拉时会触发页面onPullDownRefresh事件
3.TabBar配置
当程序顶部或者底部需要菜单栏时,我们可以通过tabbar设置,非必填,属性如下:
-
color:tab上文字默认颜色,默认值为#000000
-
selectedColor:tab上文字选中时的颜色,默认值为#000000
-
backgroundColor:tab背景色
-
borderStyle:tabbar上边框颜色,仅支持black\white,默认值为black
-
list:tab的列表,必填项,其值为一个数组,最少2个,最多5个,数组中每一个项是一个对象,代表一个tab的相关配置,配置如下:
-
pagepath:页面路径,必须在pages中先定义,必填项
-
text:tab上按钮的文字
-
iconpath:tab上icon的相对路径,icon大小限制在40kb
-
selectedIconPath:选中图片的相对路径,,icon大小限制在40kb
-
position:在顶部或者底部显示,可选值为bottom/top,默认值为bottom
4.networkTimeout配置
小程序中各种请求API的超时时间只能通过networktimeout统一设置,不能在api中单独设置,属性如下:
-
request:设置wx.request的超时时间,单位毫秒
-
connectSocket:设置wx.connectSocket的超时时间,单位毫秒
-
uploadFile:设置wx.uploadFile的超时时间,单位毫秒
-
downloadFile:设置wx.downloadFile的超时时间,单位为毫秒
5.debug配置
-
此配置项控制是否开启debug模式,默认是关闭的,当开启debug模式时,在开发者工具面板,调试信息以info形式输出,有page注册,页面路由,数据更新,事件触发,可以帮助开发者快速定位一些问题。
相关推荐:《微信小程序开发入门及案例详解》---李骏
欢迎关注我的个人微信公众号