3-了解.json文件

2023-01-31 02:01:10

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"

  }

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

wKiom1gDkQiAw9-_AAD7-iXWv1s984.png-wh_50

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目录,并把图片放到这里目录里

wKiom1gDkS-TfkveAAA0zw4BbEE409.png-wh_50

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

wKioL1gDkVaTpC00AAADt7Px2Yc566.png-wh_50 wechat.png

wKioL1gDkVbQtn-GAAAG0u1sLmM068.png-wh_50 wechatHL.png

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

wKiom1gDkd6izrDfAABWT88KO8s415.png-wh_50

相关文章