微信小程序学习笔记（1）-全局配置

全局配置

app.json文件用来对微信小程序进行全局配置，决定页面文件的路径、窗口表现、设置网络超时时间、设置多 tab 等。

名词解释：

pages  =>  页面路径列表

window  =>  全局的默认窗口表现

              backgroundTextStyle  =>  下拉 loading 的样式，仅支持 dark / light,默认值dark

              navigationBarBackgroundColor  =>  导航栏背景颜色，16进制，默认#000000

              navigationBarTitleText  =>  导航栏标题文字内容

              navigationBarTextStyle  =>  导航栏标题颜色，仅支持 black / white，默认为white

tabBar  =>  底部 tab 栏的表现

              color  =>  tab 上的文字默认颜色

              selectedColor  =>  tab上的文字选中时的颜色

              borderStyle  =>  tabbar上边框的颜色， 仅支持 black / white，默认为black

              list  =>  tab 的列表，详见 list 属性说明，最少2个、最多5个 tab

                     pagePath  =>  页面路径，必须在 pages 中先定义

                     text  =>  tab 上按钮文字

                    iconPath  =>  图片路径，icon 大小限制为40kb，建议尺寸为 81px * 81px，不支持网络图片。

                                            当 postion 为 top 时，不显示 icon。

                   selectedIconPath  =>  选中时的图片路径，icon 大小限制为40kb，建议尺寸为 81px * 81px，不支持网络图                                                                       片。当 postion 为 top 时，不显示 icon。

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

             request  =>  wx.request 的超时时间，单位毫秒。默认值60000

            downloadFile  =>  wx.downloadFile 的超时时间，单位毫秒。默认值60000

debug  =>  可以在开发者工具中开启 debug 模式，在开发者工具的控制台面板，调试信息以 info 的形式给出，其信息有Page的注册，页面路由，数据更新，事件触发等。可以帮助开发者快速定位一些常见的问题。

{
  "pages": [
    "pages/index/index",
    "pages/logs/logs",
    "pages/about/about",
    "pages/detail/detail",
    "pages/technician/technician",
    "pages/user/user"
  ],
  "window": {
    "backgroundTextStyle": "light", 
    "navigationBarBackgroundColor": "#d24a58",
    "navigationBarTitleText": "小程序学习", 
    "navigationBarTextStyle": "black" 
  },
  "tabBar": {
    "color": "#333", 
    "selectedColor": "#d24a58",
    "borderStyle": "white",
    "list": [
      {
        "pagePath": "pages/index/index", 
        "text": "首页", 
        "iconPath": "images/index_icon.png",
        "selectedIconPath": "images/index_icon_HL.png"
      },
      {
        "pagePath": "pages/detail/detail",
        "text": "技师",
        "iconPath": "images/skill_icon.png",
        "selectedIconPath": "images/skill_icon_HL.png"
      },
      {
        "pagePath": "pages/about/about",
        "text": "我的",
        "iconPath": "images/user_icon.png",
        "selectedIconPath": "images/user_icon_HL.png"
      }
    ]
  },
  "networkTimeout": {
    "request": 10000,
    "downloadFile": 10000
  },
  "debug": true
}

备注：json文件中，禁止使用注释，否则会出现报错。另外，除非有特殊说明，颜色均指十六进制颜色值。个人习惯，我通常把navigationBarBackgroundColor的颜色值与tabBar中的主体颜色值保持一致。

特别提示：该博客与官方文档基本一样，但其优点是，全局配置中包含了常规的设置项，可以直接复制使用，只需简单修改部分内容即可。