微信小程序的全局配置

微信小程序配置

小程序根目录下的 app.json 文件用来对微信小程序进行全局配置。文件内容为一个 JSON 对象。
全局配置官方参考文档：
https://developers.weixin.qq.com/miniprogram/dev/reference/configuration/app.html

{
  "pages": [
    "pages/index/index",
    "pages/logs/logs"
  ],
  "window": {
    "backgroundTextStyle": "light",
    "navigationBarBackgroundColor": "#fff",
    "navigationBarTitleText": "WeChat",
    "navigationBarTextStyle": "black"
  },
  "sitemapLocation": "sitemap.json"
}

1. pages: 配置页面路径列表

• 添加新页面
  在微信开发中工具中自带的编辑器里面为pages数组添加新的路径，微信开发者工具会自动为其创建对应的文件目录，例如添加一个页面logs2：

"pages": [
    "pages/index/index",
    "pages/logs/logs",
    "pages/logs2/logs2"
  ],

会自动创建页面目录和文件

• 首页
  哪个页面的路径在pages数组的最前面，小程序启动时就显示哪个页面

2.window：配置全局默认窗口表现

• “enablePullDownRefresh”:是否开启全局的下拉刷新，默认false

• “backgroundTextStyle”：下拉 loading 的样式，仅支持 dark / light

3.TabBar

如果小程序是一个多 tab 应用（客户端窗口的底部或顶部有 tab 栏可以切换页面），可以通过 tabBar 配置项指定 tab 栏的表现，以及 tab 切换时显示的对应页面。（在自带的编辑器里面输入tabBar时会有代码提示，回车会自动有模版代码写入）

• list:tab 的列表,它是一个数组，里面的每个对象就是一个tab标签，最少要有2个tab

"tabBar": {
    "list": [
         {
         "pagePath": "页面路径",
         "text": "tab 上按钮文字",
        "iconPath": "icon图片路径",
         "selectedIconPath": "选中时的图片路径"
        },
        {
         "pagePath": "页面路径",
         "text": "tab 上按钮文字",
         "iconPath": "icon图片路径",
         "selectedIconPath": "选中时的图片路径"
        }
    ]
}

• 其他属性
  color: tab的文字颜色，只能是16进制的颜色
  selectedColor: 同上，被选中的文字颜色
  backgroundColor： 背景色，只能是16进制的颜色
  borderStyle: 边框颜色 仅支持 black / white
  position： tabBar 的位置，仅支持 bottom / top

4.networkTimeout

各类网络请求的超时时间，单位均为毫秒。

属性	必填	默认	写法	单位
requestNumber	否	60000	wx.request	毫秒
connectSocketNumber	否	60000	wx.connectSocket	毫秒
uploadFileNumber	否	60000	wx.uploadFile	毫秒
downloadFileNumber	否	60000	wx.downloadFile	毫秒

5.生命周期

小程序的生命周期分为两种：全局生命周期和页面生命周期。

• 全局生命周期
  onLaunch：小程序初始化完成时，全局只触发一次
  onShow：小程序启动，或者后台进入前台时
  onHide：小程序隐藏，小程序从前台进入后台时
  onError：错误监听函数。小程序发生脚本错误，或者 api 调用失败时触发，会带上错误信息。
  onPageNoFound：小程序要打开的页面不存在时触发，会带上页面信息回调该函数
• 页面生命周期
  onLoad：监听页面加载
  onReady：监听页面初次渲染完成
  onShow：监听页面显示
  onHide：监听页面隐藏
  onUnload：监听页面卸载
  onPullDownRefresh：监听用户下拉动作
  onReachBottom：页面上拉触底事件的处理函数
  onShareAppMessage：用户点击右上角转发
  onPageScroll：页面滚动触发事件的处理函数
  onResize：页面尺寸改变时触发
  onTabItemTap：当前是 tab 页时，点击 tab 时触发
  viewTap：任意的函数，在页面的函数中用 this 可以访问
  customData：任意数据，在页面的函数中用 this 可以访问

---