全局配置~app.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
}
配置项 | 类型 | 必填 | 描述 |
---|---|---|---|
pages | Array | 是 | 设置页面路径 |
window | Object | 否 | 设置默认页面的窗口表现 |
tabBar | Object | 否 | 设置底部tab的表现 |
networkTimeout | Object | 否 | 设置网络超时时间 |
debug | Boolean | 否 | 设置是否开启debug模式 |
1.pages配置项
pages配置项接受一个数组,用来指定小程序由哪些页面组成,是必需的配置项。数组的每一项都是字符串,代表对应页面的“路径+文件名”信息。
pages配置项要注意三点:
1)数组的第一项用于设定小程序的初始页面,即小程序启动页。
2)小程序中新增/减少页面,都需要对pages数组进行修改。
3)文件名不需要写文件后缀。小程序框架会自动去寻找路径.json、.js、.wxml、.wxss这四类文件进行整合。
{
"pages":[
"pages/index/index" ,
"pages/logs/logs"
]
}
2.window配置项
window配置项接受对象值,用来设置小程序的状态栏、导航条、标题、窗口等对象的颜色、背景色、内容属性,非必填配置项。没有配置时将使用默认值。
{
"window":{
"navigationBarBackgroundColor": "#ffffff", "navigationBarTextStyle": "black",
"navigationBarTitleText": "微信接口功能演示",
"backgroundColor": "#eeeeee",
"backgroundTextStyle": "light" }
}
对象 | 类型 | 默认值 | 描述 |
---|---|---|---|
navigationBarBackgroundColor | HexColor | #000000 | 导航栏背景颜色 |
navigationBarTextStyle | String | white | 导航栏标题颜色 |
navigationBarTitleText | String | ... | 导航栏标题文字内容 |
backgroundColor | HexColor | #ffffff | 窗口的背景色 |
backgroundTextStyle | String | dark | 下拉背景字体、loading图的样式,仅支持dark/light |
enablePullDownRefresh | Boolean | false | 是否开启下拉刷新 |
3.tabBar配置项
小程序可以是多标签页切换的应用,这种情况下,就需要通过tabBar配置项来指定标签页的表现,及标签页切换时所显示的对应页面;
对象 | 类型 | 必填 | 默认值 | 描述 |
---|---|---|---|---|
color | HexColor | 是 | ... | 标签上的文字默认颜色 |
selectedColor | HexColor | 是 | ... | 标签页上的文字选中时的颜色 |
backgroundColor | HexColor | 是 | ... | 标签页的背景色 |
borderStyle | String | 否 | black | 标签条上的框线颜色,仅支持black/white |
list | Array | 是 | ... | 标签页列表,支持最少2个,最多5个标签页 |
position | String | 否 | bottom | 可选值bottom、top |
对象 | 类型 | 必填 | 描述 |
---|---|---|---|
pagePath | String | 是 | 页面路径,必须在pages中先定义 |
text | String | 是 | 标签页上的按钮文字 |
iconPath | String | 是 | 标签上icon图片路径,icon图片大小限制为40KB |
selectedIconPath | String | 是 | 选中标签时的icon图片路径,icon图片大小限制为40KB |
tabBar配置项接受多个对象的设定,其中的对象list(列表)是一个数组,用于配置标签页。
注意:
1).只能配置最少2个、最多5个标签页。标签页按数组的顺序排序。
2).list(列表)接受数组值,数组中的每一项也都是一个对象。
对象的数据值说明如下:
对象 | 类型 | 必填 | 描述 |
---|---|---|---|
pagePath | String | 是 | 页面路径,必须在pages中先定义 |
text | String | 是 | 标签页上的按钮文字 |
iconPath | String | 是 | 标签上icon图片路径,icon图片大小限制为40KB |
selectedIconPath | String | 是 | 选中标签时的icon图片路径,icon图片大小限制为40KB |
代码:
{ "tabBar":
{ "color":"#dddddd",
"selectedColor":"#3cc51f",
"borderStyle":"black",
"backgroundColor":"#ffffff",
"list": [{ "pagePath": "pages/components ",
"iconPath": "pages/images/components.png", "selectedIconPath": "pages/images/componentsHL.png",
"text": "组件" },
{ "pagePath": "pages/interface",
"iconPath": "pages/images/interface.png",
"selectedIconPath": "pages/images/interfaceHL.png",
"text": "接口" }]
}
}
4.networkTimeout配置项
networkTimeout配置项用于设置各种网络请求对象的超时时间,非必须配置项。可设置的网络请求超时的相关对象有request、connectSocket、uploadFile、downloadFile。超时的单位均为毫秒。这些超时若不设置,则默认使用操作系统内核或遵循服务器WebServer的设定值。
对象 | 类型 | 必填 | 描述 |
---|---|---|---|
request | Number | 否 | wx.request的超时时间,单位为ms |
connectSocket | Number | 否 | wx.connectSocket的超时时间,单位为ms |
uploadFile | Number | 否 | wx.uploadFile的超时时间,单位为ms |
downloadFile | Number | 否 | wx.downloadFile的超时时间,单位为ms |
代码:
{
"networkTimeout": { "request":30000,
"connectSocket":30000,
"uploadFile":30000,
"downloadFile":30000 }
}
5.debug配置项
debug配置项用于开启开发者工具的调试模式,它接受一个boolean值(默认值是false)。开启后,页面(page)的注册、页面路由、数据更新、事件触发等调试信息将以info的形式,输出在“调试”功能的console(控制台)面板上。
比如,以下配置为打开调试模式:
{ "debug": true }
页面配置~page.json
页面.json文件配置比app.json配置简单得多,只能设置window配置项的内容。显然页面.json文件中的window配置值将覆盖app.json中的配置值。
{ "navigationBarBackgroundColor": "#ffffff",
"navigationBarTextStyle": "black",
"navigationBarTitleText": "微信接口功能演示",
"backgroundColor": "#eeeeee",
"backgroundTextStyle": "light" }