我的微信小程序第三篇(app.json)

前言

端午节回家了,所以好多天没有更新,只想说还是待在家里舒服呀,妈妈各种做好吃的,小侄子侄女各种粘着我在室外玩,导致我三天下来不仅胖了一圈,还黑了一圈,上班第一天有同事就说我晒黑了,哭~~~,为了防止自己的"懒癌"症复发,赶紧打开电脑敲敲字,废话不多说,我们就回到今天的主题,今天给大家介绍下微信小程序框架主体文件中的配置文件(app.json),其实我们在上一篇《我的微信小程序第二篇》中已经对app.json做过简单的描述,在此篇中,我们将对其进行详细的介绍。

正文

app.json是小程序的全局配置文件,编写时需严格遵循json的格式规范,app.json在程序加载时加载,负责全局配置,其配置项有:

  • pages:设置页面路径,必填

  • window:设置默认页面的窗口表现

  • tabBar:设置tab的表现

  • networkTimeOut:设置网络超时时间

  • debug:设置是否开启debug模式,默认关闭false

app.json文件内容整体结构如下;

  1. pages配置

    pages负责注册小程序页面,必须填写,值为一个包含页面路径的数组,用来指定小程序由哪些页面构成,如下所示:

      //页面路径设置

      "pages":[

        "pages/index/index",

        "pages/logs/logs"

      ]

    pages中不需要填写文件后缀名,渲染页面时框架会自动寻找路径.json,.js,.wxml,.wxss四个文件进行整合,建议文件名和目录名保持一致,便于管理,pages配置中第一项代表小程序的初始页面,小程序增加或者修改,删除页面都需要对pages进行相应的调整。

2.window配置

Window负责小程序状态栏,导航条,标题,窗口背景色等系统级样式。属性有:

  • navigationBarBackgroundColor:导航栏背景色,默认值为#fff

  • navigationBarTextStyle:导航栏标题颜色,仅支持black/white,默认值为black

  • navigationBarTitleText:导航栏标题文字内容

  • backgroundTextStyle:下拉背景字体,loading图样式,仅支持dark/light

  • backgroundColor:窗口背景色,默认值为#ffffff

  • enablePullDownRefresh:是否开启下拉刷新,默认为false,开启后,当用户下拉时会触发页面onPullDownRefresh事件

3.TabBar配置

当程序顶部或者底部需要菜单栏时,我们可以通过tabbar设置,非必填,属性如下:

  • color:tab上文字默认颜色,默认值为#000000

  • selectedColor:tab上文字选中时的颜色,默认值为#000000

  • backgroundColor:tab背景色

  • borderStyle:tabbar上边框颜色,仅支持blackwhite,默认值为black

  • list:tab的列表,必填项,其值为一个数组,最少2个,最多5个,数组中每一个项是一个对象,代表一个tab的相关配置,配置如下:

  • pagepath:页面路径,必须在pages中先定义,必填项

  • text:tab上按钮的文字

  • iconpath:tab上icon的相对路径,icon大小限制在40kb

  • selectedIconPath:选中图片的相对路径,,icon大小限制在40kb

  • position:在顶部或者底部显示,可选值为bottom/top,默认值为bottom

    4.networkTimeout配置

    小程序中各种请求API的超时时间只能通过networktimeout统一设置,不能在api中单独设置,属性如下:

  • request:设置wx.request的超时时间,单位毫秒

  • connectSocket:设置wx.connectSocket的超时时间,单位毫秒

  • uploadFile:设置wx.uploadFile的超时时间,单位毫秒

  • downloadFile:设置wx.downloadFile的超时时间,单位为毫秒

    5.debug配置

  • 此配置项控制是否开启debug模式,默认是关闭的,当开启debug模式时,在开发者工具面板,调试信息以info形式输出,有page注册,页面路由,数据更新,事件触发,可以帮助开发者快速定位一些问题。

相关推荐:《微信小程序开发入门及案例详解》---李骏

欢迎关注我的个人微信公众号

原文地址:https://www.cnblogs.com/yixuanhan/p/6950437.html