5.1 全局配置

微信小程序的全局配置都要在 app.json 文件中进行。这些配置可以决定页面文件的路径、窗口表现、设置网络超时时间、设置多 tab 等。 app.json 配置项列表，如表5-1所示：

表5-1

pages 接受一个数组值，每一项都是字符串，用来指定小程序由哪些页面组成。每一项代表对应页面的【路径+文件名】信息。

注意：

代码示例如图5-1所示：

图5-1 pages配置项

window 接受对象值，用来设置小程序的状态栏、导航条、窗口页面等对象的基本样式属性。 window 配置的对象都有默认值且非必填，可配置的对象，如表5-2所示：

表5-2

属性名	类型	默认值	说明
navigationBarBackgroundColor	HexColor	#000000	导航栏背景颜色，如"#000000"
navigationBarTextStyle	String	white	导航栏标题颜色，仅支持 black/white
navigationBarTitleText	String		导航栏标题文字内容
backgroundColor	HexColor	#ffffff	窗口的背景色
backgroundTextStyle	String	dark	下拉背景字体、loading 图的样式，仅支持 dark/light
enablePullDownRefresh	Boolean	false	设置是否开启下拉刷新

代码示例如图5-2所示：

图5-2 window配置项

tabBar 接受一个数组值，用来设置 tab 底部标签栏的样式表现，以及 tab 切换时显示的对应页面。 tabBar 所包含的属性，如表5-3所示：

表5-3

属性名	类型	必填	说明
color	HexColor	是	tab 上的文字默认颜色
selectedColor	HexColor	是	tab 上的文字选中时的颜色
backgroundColor	HexColor	是	tab 的背景色
borderStyle	String	否	tabbar上边框的颜色，仅支持 black/white，默认为black
list	Array	是	tab 的列表，详见 list 属性说明，最少2个、最多5个 tab
position	String	否	可选值 bottom、top，默认为bottom

其中 list 接受一个数组，数组中的每个项都是一个对象，其属性值如表5-4所示：

表5-4

属性名	类型	必填	说明
pagePath	String	是	页面路径，必须在 pages 中先定义
text	String	是	tab 上按钮文字
iconPath	String	是	图片路径，icon 大小限制为40kb，建议尺寸为 81px * 81px
selectedIconPath	String	是	选中时的图片路径，icon 大小限制为40kb，建议尺寸为 81px * 81px

代码示例如图5-3所示：

图5-3 tabBar配置项

注意：

tabBar 只能配置最少2个、最多5个 tab，tab 按数组的顺序排序。
通过页面跳转（wx.navigateTo）或者页面重定向（wx.redirectTo）所到达的页面，即使它是定义在 tabBar 配置中的页面，也不会显示底部的 tab 栏。

networkTimeout 接受对象值。用来设置各种网络请求对象超时时间。超时时间单位为毫秒，默认为60000。 networkTimeout 所包含的属性，如表5-5所示：

表5-5

属性名	类型	必填	说明
request	Number	否	wx.request的超时时间，单位毫秒，默认为：60000
connectSocket	Number	否	wx.connectSocket的超时时间，单位毫秒，默认为：60000
uploadFile	Number	否	wx.uploadFile的超时时间，单位毫秒，默认为：60000
downloadFile	Number	否	wx.downloadFile的超时时间，单位毫秒，默认为：60000

代码示例如图5-4所示：

图5-4 networkTimeout配置项

debug 接收一个Boolean值，用于设置开启开发者工具的调试模式。默认是false，开启后，在开发者工具的控制台面板，调试信息以 info 的形式给出，其信息有Page的注册，页面路由，数据更新，事件触发。这样可以帮助开发者快速定位一些常见问题，但是，在正式发布时应当关闭此配置项。

代码示例如图5-5所示：

图5-5 debug配置项

results matching ""