微信小程序开发之——比较数字大小-配置文件(2.4)

一概述

小程序的每一个页面均可以使用json文件对页面的效果进行配置。页面配置分为页面级和应用级，在本项目中，pages/index/index.json是页面级配置文件，而app.json是应用级配置文件

二页面级配置文件

在页面级配置文件中可以更改页面的导航样式，控制页面是否允许上下滚动等。下面通过表2-5列举常用的页面级配置

属性	说明
navigationBarBackgroundColor	导航栏背景颜色，默认为#000000
navigationBarTextStyle	导航栏标题颜色，仅支持black、white(默认)
navigationBarTitleText	导航栏的标题文字内容
backgroundColor	窗口的背景色，默认为#ffffff
backgroundTextStyle	下拉loading的样式，仅支持dark(默认)、light
enablePullDownRefresh	是否全局开启下拉刷新，默认为false
onReachBottomDistance	页面上拉触底时页面底部距离(单位为px)，默认为50
disableScrol	默认为false。设置为true时，页面整体不能上下移动

在上表中，若将enablePullDownRefresh设为true，页面可以下拉刷新，当下拉刷新操作执行时，就会触发下拉刷新时间onPushDownRefresh，在pages/index/index.js文件中可以找到该事件的处理函数。

onReachBottomDistance主要用于开发自动加载更多的功能，也就是页面中的内容非常长的时候，为了加快加载速度，并不是一次性加载所有的数据，而是先加载一部分数据将页面填满，直到出现滚动条，页面可以向上滚动。当用户上拉时，如果快要到达底部了，就立即加载后面的数据。因此，onReachBottomDistance的值越大，加载的时机越提前。如果达到了给定的值，就会触发上拉触底事件onReachBottom，在pages/index/indes.s文件中可以找到该事件的处理函数。

接下来演示页面级配置的使用，打开pages/index/index.json文件，编写代码如下：

{
  "navigationBarTitleText": "数值比较",
  "navigationBarBackgroundColor": "#369"
}

上述代码设置了导航栏标题为”数值比较”，颜色为蓝色。运行结果为：

三应用级配置文件

项目根目录下app.json就是应用级配置文件，其常用配置如下表：

属性	说明
pages	页面路径列表
window	全局的默认窗口表现
tabBar	底部tab栏的表现
networkTimeOut	网络超时时间
debug	是否开启调试模式，默认为false
requireBackgroundModes	需要在后台使用的能力，如音乐播放
plugins	使用到的插件

在上述属性中，pages在前面已经用过；window的值是一个对象，可以将表中的配置写在window中，作为应用级配置使用，从而一次设置多个页面，且优先级低于页面级配置；tabBar、plugins和requiredBackgroundModes会在后面的章节进行讲解；debug开启后可以在控制台中输出调试信息，帮助开发者快速定位到一些常见的问题。

networkTimeout可以设置网络请求过程中的超时时间，详细内容如下表：

属性	类型	说明
request	Number	wx.request()的超时时间(ms)，默认为60000
connectSocket	Number	wx.connectSocket()的超时时间(ms)，默认为6000
uploadFile	Number	wx.uploadFile()的超时时间(ms)，默认为60000
downloadFile	Number	wx.downloadFile()的超时时间(ms)，默认为6000

在上表中，以wx.开头的是小程序中的API，如wx.request()用于发送网络请求，关于这些API的具体使用方法会在后面的章节中讲解

接下来演示应用级配置的使用，修改app.json文件，具体代码如下：

{
  "pages": [
    "pages/index/index"
  ],
  "window": {
    "navigationBarTitleText": "数值比较",
    "navigationBarBackgroundColor": "#369"
  },
  "debug": true
}

在上述代码中，navigationBarTitleText和navigationBarBackgroundColor配置了导航栏的标题和样式，如果将pages/index/index.json文件中的相同配置删除，则应用级配置会生效；debug开启了调试，运行程序后，会在控制台中输出调试信息。下图中可以看到小程序启动过程的信息