赞
踩
app.json是小程序配置文件,编写时要严格遵循json的格式规范。app.json在程序加载时加载,负责对小程序的全局配置,其配置项有:□pages:设置页面路径,必填项。□window:设置默认页面的窗口表现。□tabBar:设置tab的表现。□networkTimeout:设置网络超时时间。□debug:设置是否开启debug模式,默认关闭。app.json文件内容整体结构如下:
1.pages配置pages负责注册小程序页面,必须填写,value值为一个包含页面路径的数组,用来指定小程序由哪些页面构成,每一项由页面“路径+文件名”组成,如下所示:pages数组中页面路径不需要填写文件后缀名,渲染页面时框架会自动寻找路径.json, . js, .wxml,.wxss四个文件进行整合,如上文配置中“mypages/index/index”路径,页面加载时框架会自动匹配寻找“mypages/index/index.json”、“mypages/index/index.js”、“mypages/index/index.wxml”、“mypages/index/index.wxss”这四个文件,路径中的文件名可以和目录名不一致,但在项目过程中,为了便于管理,建议文件名和目录名保持一致。pages配置数组第一项代表小程序的初始页面。小程序中增加、删除页面,都需要对pages进行修改,并且重启项目。2.window配置window负责设置小程序状态栏、导航条、标题、窗口背景色等系统级样式。属性有:□navigationBarBackgroundColor:导航栏背景颜色,值为HexColor(十六进制颜色值),如:“#ff83fa”,默认值为#000000。□navigationBarTextStyle:导航栏标题颜色,仅支持black/white,默认值为white。□navigationBarTitleText:导航栏标题文字内容。□backgroundColor:窗口背景色,值为HexColor(十六进制颜色值),如:“#ff83fa”,默认值为#ffffff。□backgroundTextStyle:下拉背景字体、Loading图的样式,仅支持dark/light。□enablePullDownRefresh:是否开启下拉刷新,默认为false,开启后,当用户下拉时会触发页面onPullDownRefresh事件。配置项目如图2-5所示。3.tabBar配置当程序顶部或底部需要菜单栏时,我们可以通过配置tabBar快速实现,tabBar是个非必填项目。可配置属性如下:□color:tab上的文字默认颜色,值为HexColor(十六进制颜色值),必填项。□selectedColor:tab上的文字选中时的颜色,值为HexColor(十六进制颜色值),必填项。□backgroundColor:tab的背景色,值为HexColor(十六进制颜色值),必填项。□borderStyle:tabbar上边框的颜色,仅支持black/white,默认值为black。□list:tab的列表,必填项,其值为一个数组,最少2个、最多5个tab,数组中每一项是一个对象,代表一个tab的相关配置,每项的相关配置如下:● pagePath:页面路径,必须在pages中先定义,必填项。● text:tab上按钮的文字,必填项。● iconPath:tab上icon图片的相对路径,icon大小限制为40kb,必填项。● selectedIconPath:选中时图片的相对路径,icon大小限制为40kb,必填项。● position:tab在顶部或底部显示,可选值为bottom、top,默认值为bottom。示例代码见代码清单2-1。配置后页面效果如图2-6所示。4.networkTimeout配置小程序中各种网络请求API的超时时间只能通过networkTimeout统一设置,不能在API中单独设置,具体的网络请求API可参考后面章节,networkTimeout支持的属性有:□request:设置wx.request的超时时间,单位毫秒。□connectSocket:设置wx.connectSocket的超时时间,单位毫秒。□uploadFile:设置wx.uploadFile的超时时间,单位毫秒。□downloadFile:设置wx.downloadFile的超时时间,单位毫秒。示例代码如下:5.debug配置此配置项控制是否开启debug模式,默认是关闭的。开启debug模式后,在开发者工具的控制面板,调试信息以info的形式输出,如图2-7所示。其中信息有Page的注册、页面路由、数据更新、事件触发,可以帮助开发者快速定位一些常见问题。示例代码如下:以上便是app.json的5类配置项,这些配置项都是全局的,小程序中除了app.json这种全局配置文件还有页面配置文件,当路由到对应页面时,页面配置文件的配置项将会覆盖全局配置,页面配置文件将在后续内容中进行详细介绍。
Copyright © 2003-2013 www.wpsshop.cn 版权所有,并保留所有权利。