1、app.json的配置项
下面是微信官方给出的一个json配置文件。
{
"pages": [
"pages/index/index",
"pages/logs/index"
],
"window": {
"navigationBarTitleText": "Demo"
},
"tabBar": {
"list": [{
"pagePath": "pages/index/index",
"text": "首页"
}, {
"pagePath": "pages/logs/logs",
"text": "日志"
}]
},
"networkTimeout": {
"request": 10000,
"downloadFile": 10000
},
"debug": true
}
app.json配置项列表：
属性 | 类型 | 必填 | 描述 |
pages | Array | 是 | 设置页面路径 |
window | Object | 否 | 设置默认页面的窗口表现 |
tabBar | Object | 否 | 设置底部tab的表现 |
networkTimeout | Object | 否 | 设置网络超时时间 |
debug | Boolean | 否 | 设置 开启debug模式 |
⑴ pages
它的作用是配置小程序的页面,这个配置项是必填的,它接受一个数组,里面的每一项都是字符串,从上面给出的代码：
"pages": [
"pages/index/index",
"pages/logs/logs"
]
pages里每一项分别对应的都是文件的路径以及文件名。
⑵ window
window配置项是用来设置小程序的状态栏、导航条、、窗口背景色。
属性 | 类型 | 默认值 | 描述 |
navigationBarBackgroundColor | HexColor | #000000 | 导航栏背景颜色，如"#000000" |
navigationBarTextStyle | String | white | 导航栏颜色，仅支持 black/white |
navigationBarTitleText | String | 导航栏文字内容 | |
backgroundColor | HexColor | #ffffff | 窗口的背景色 |
backgroundTextStyle | String | dark | 下拉背景字体、loading 图的样式，仅支持 dark/light |
enablePullDownRefresh | Boolean | false | 是否开启下拉刷新，详见页面相关事件处理函数 |
注：HexColor（十六进制颜色值），如"#ff00ff"
⑶ tabBar
这个配置项是用来配置页面底部的tab栏。
属性 | 类型 | 必填 | 默认值 | 描述 |
color | HexColor | 是 | tab 上的文字默认颜色 | |
selectedColor | HexColor | 是 | tab 上的文字选中时的颜色 | |
backgroundColor | HexColor | 是 | tab 的背景色 | |
borderStyle | String | 否 | black | tabbar上边框的颜色，仅支持 black/white |
list | Array | 是 | tab的列表，详见list属性说明，最少2个、最多5个tab |
⑷ networkTimeout
可以设置各种网络请求的超时时间。
属性 | 类型 | 必填 | 说明 |
request | Number | 否 | wx.request的超时时间，单位毫秒 |
connectSocket | Number | 否 | wx.connectSocket的超时时间，单位毫秒 |
uploadFile | Number | 否 | wx.uploadFile的超时时间，单位毫秒 |
downloadFile | Number | 否 | wx.downloadFile的超时时间，单位毫秒 |
⑸ debug
可以在开发者工具中开启debug模式，在开发者工具的控制台面板，调试信息以 info 的形式给出，其信息有Page的注册，页面路由，数据更新，事件触发。可以帮助开发者快速定位一些常见的问题。
2、例子
看千遍不如做一遍。下面让我们做几个例子，加深对app.json配置项的理解。
Example1：window配置项
我们把window配置项修改成下面的代码，然后看界面的显示。
"window":{
"navigationBarBackgroundColor": "#ffffff",
"navigationBarTextStyle": "black",
"navigationBarTitleText": "微信接口功能演示",
"backgroundColor": "#eeeeee",
"backgroundTextStyle": "light"
}
点击微信开发者工具左边的“编译”后，弹出如下界面：
Example2：tabbar配置项
⑴ app.json中添加如下代码：
"tabBar":{
"color":"#dddddd",
"selectedColor":"#3cc51f",
"borderStyle":"white",
"backgroundColor":"#ffffff",
"list":[{
"pagePath":"pages/index/index",
"iconPath":"p_w_picpath/wechat.png",
"selectedIconPath":"p_w_picpath/wechatHL.png",
"text":"首页"
},{
"pagePath":"pages/logs/logs",
"iconPath":"p_w_picpath/wechat.png",
"selectedIconPath":"p_w_picpath/wechatHL.png",
"text":"日志"
}]
}
⑵ 创建p_w_picpath目录，并把图片放到这里目录里
其中的2个图片文件如下：
wechat.png
wechatHL.png
⑶ 点击微信开发者工具左边的“编译”后，弹出如下界面：
