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

桃扇骨 2021-09-16 05:26 392阅读 0赞

## 全局配置 ##

`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中的主体颜色值保持一致。

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