3-了解.json文件

发布时间：2019-08-18 13:19:54编辑：auto阅读（1989）

1、app.json的配置项

下面是微信官方给出的一个json配置文件。

{

  "pages": [

    "pages/index/index",

    "pages/logs/index"

  ],

  "window": {

    "navigationBarTitleText": "Demo"

  },

  "tabBar": {

    "list": [{

      "pagePath": "pages/index/index",

      "text": "首页"

    }, {

      "pagePath": "pages/logs/logs",

      "text": "日志"

    }]

  },

  "networkTimeout": {

    "request": 10000,

    "downloadFile": 10000

  },

  "debug": true

}

 

app.json配置项列表：

 

属性	类型	必填	描述
pages	Array	是	设置页面路径
window	Object	否	设置默认页面的窗口表现
tabBar	Object	否	设置底部tab的表现
networkTimeout	Object	否	设置网络超时时间
debug	Boolean	否	设置 开启debug模式

 

⑴ pages

    它的作用是配置小程序的页面,这个配置项是必填的,它接受一个数组,里面的每一项都是字符串,从上面给出的代码：

    "pages": [

 

        "pages/index/index",

        "pages/logs/logs"

    ]

pages里每一项分别对应的都是文件的路径以及文件名。

 

⑵ window

window配置项是用来设置小程序的状态栏、导航条、标题、窗口背景色。

属性	类型	默认值	描述
navigationBarBackgroundColor	HexColor	#000000	导航栏背景颜色，如"#000000"
navigationBarTextStyle	String	white	导航栏标题颜色，仅支持 black/white
navigationBarTitleText	String		导航栏标题文字内容
backgroundColor	HexColor	#ffffff	窗口的背景色
backgroundTextStyle	String	dark	下拉背景字体、loading 图的样式，仅支持 dark/light
enablePullDownRefresh	Boolean	false	是否开启下拉刷新，详见页面相关事件处理函数

注：HexColor（十六进制颜色值），如"#ff00ff"

 

⑶ tabBar

这个配置项是用来配置页面底部的tab栏。

属性	类型	必填	默认值	描述
color	HexColor	是		tab 上的文字默认颜色
selectedColor	HexColor	是		tab 上的文字选中时的颜色
backgroundColor	HexColor	是		tab 的背景色
borderStyle	String	否	black	tabbar上边框的颜色，仅支持 black/white
list	Array	是		tab的列表，详见list属性说明，最少2个、最多5个tab

 

⑷ networkTimeout

可以设置各种网络请求的超时时间。

属性	类型	必填	说明
request	Number	否	wx.request的超时时间，单位毫秒
connectSocket	Number	否	wx.connectSocket的超时时间，单位毫秒
uploadFile	Number	否	wx.uploadFile的超时时间，单位毫秒
downloadFile	Number	否	wx.downloadFile的超时时间，单位毫秒

 

⑸ debug

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

 

2、例子

看千遍不如做一遍。下面让我们做几个例子，加深对app.json配置项的理解。

 

Example1：window配置项

我们把window配置项修改成下面的代码，然后看界面的显示。

  "window":{

    "navigationBarBackgroundColor": "#ffffff",

    "navigationBarTextStyle": "black",

    "navigationBarTitleText": "微信接口功能演示",

    "backgroundColor": "#eeeeee",

    "backgroundTextStyle": "light"

  }

点击微信开发者工具左边的“编译”后，弹出如下界面：



Example2：tabbar配置项

⑴ app.json中添加如下代码：

"tabBar":{

    "color":"#dddddd",

    "selectedColor":"#3cc51f",

    "borderStyle":"white",

    "backgroundColor":"#ffffff",

    "list":[{

      "pagePath":"pages/index/index",

      "iconPath":"p_w_picpath/wechat.png",

      "selectedIconPath":"p_w_picpath/wechatHL.png",

      "text":"首页"

    },{

      "pagePath":"pages/logs/logs",

      "iconPath":"p_w_picpath/wechat.png",

      "selectedIconPath":"p_w_picpath/wechatHL.png",

      "text":"日志"

    }]

  }

⑵ 创建p_w_picpath目录，并把图片放到这里目录里



其中的2个图片文件如下：

 wechat.png

 wechatHL.png

⑶ 点击微信开发者工具左边的“编译”后，弹出如下界面：

关键字：