微信小程序全局配置及常用配置项详解

一、window常用配置

1.小程序根目录下的app.json文件时小程序的全局配置文件。常用配置项如下：

① pages

记录当前小程序所有页面的存放路径

② window

全局设置小程序窗口的外观

③ tabBar

设置小程序底部的tabBar效果

④ style

是否启用新版的组件样式

2.window常用配置项

3.设置导航栏的标题

设置步骤：app.json->window->navigationBarTitleText 修改保存即可，导航栏背景颜色修改只支持十六进制。

注意：navigationBarTextStyle的可选值只支持black和white。

4.全局开启下拉刷新功能

设置步骤：app.json->window->把enablePullDownRefresh的值设为true

注意：在app.json中启用下拉刷新功能，会作用于每个小程序页面。

5.设置下拉刷新时窗口的背景颜色

当全局开启下拉刷新功能之后，默认的窗口背景为白色。如果自定义下拉刷新窗口背景色，设置步骤为：app.json->window->为backgroundColor指定16进制的颜色值。

6.设置下拉刷新时loading的样式

当全局开启下拉刷新功能之后，默认窗口的loading样式为白色，如果要更改loading样式的效果，设置步骤为：app.json->window->为backgroundTextStyle指定dark值（注意：可选值只有light和dark两个）。

7.设置上拉触底的距离

上拉触底是移动端的专有名词，通过手指在屏幕上的上拉滑动操作，从而加载更多数据的行为。

设置步骤：app.json->window->为onReachBottomDistance设置新的值（注意：默认距离为50px，没有特殊需求，建议使用默认）

二、tabBar全局配置

1.什么是tabBar

tabBar是移动端应用常见的页面效果，用于实现多页面的快速切换，小程序中通常分为底部tabBar和顶部tabBar。

注意：

tabBar中只能配置最少2个，最多5个tab页签

当渲染顶部tabBar时，不显示icon图标，只显示文本

2.tabBar的6个组成部分

① backgroundColor:tabBar的背景色

② selectedIconPath:选中时的图片路径

③ borderStyle:tabBar上边框的颜色

④ iconPath:未选中时的图片路径

⑤ selectedColor:tab上的文字选中时的颜色

⑥ color:tab上文字的默认（未选中）颜色

3.tabBar节点配置项

每个tab项的配置选项

window节点平级定义tabBar节点：

"tabBar": {
    "list": [
      {
        // 定义的页面路径
        "pagePath": "pages/list/list",
        "text": "首页"
      },
      {
        "pagePath": "pages/test/test",
        "text": "我的"
      }
    ]
  },

注意：tabPage页面的组件要放到pages节点内部最前面，否则页面没效果。

三、页面配置文件

1.页面配置文件的作用

小程序中，每个页面都有自己的.json配置文件，用来对当前页面的窗口外观，页面效果等进行配置。

2.页面配置和全局配置的关系

小程序中，app.json中的window节点，可以全局配置小程序中每个页面的窗口表现。如果某些小程序页面想要拥有特殊的窗口表现，此时，页面的.json配置文件就可以实现这种需求。

注意：当页面配置与全局配置冲突时，根据就近原则，最终的效果以页面配置为准。

3.页面配置中常用的配置项