欢迎您的光临,本博所发布之文章皆为作者亲测通过,如有错误,欢迎通过各种方式指正。

文摘  微信小程序之配置文件app.json、page.json详解

小程序应用 本站 1188 0评论

微信小程序的全局配置保存在app.json文件中。开发者通过使用app.json来配置页面文件(pages)的路径、窗口(window)表现、设定网络超时时间值(networkTimeout)以及配置多个切换页(tarBar)等。


首先看一个典型的全局配置app.json文件

{
  "pages": [
    "pages/index/index",
    "pages/logs/logs",
    "pages/demo/demo"
  ],
  "window": {
    "navigationBarBackgroundColor": "#ff99bb",
    "navigationBarTextStyle": "black",
    "navigationBarTitleText": "小程序",
    "backgroundColor": "#c2f0f0",
    "backgroundTextStyle": "light",
    "enablePullDownRefresh": true
  },
"tabBar": {
    "color": "#ff99ff",
    "selectedColor": "#99bbff",
    "backgroundColor": "#ff4dd2",
    "borderStyle": "black",
    "position":"top",
    "list": [{
      "pagePath": "pages/index/index",
      "text": "首页",
      "iconPath": "img/1.png",
      "selectedIconPath": "img/3.png"
    },{
      "pagePath": "pages/vultr/vultr",
      "text": "科学",
      "iconPath": "img/2.png",
      "selectedIconPath": "img/3.png"
    }]
  },
"networkTimeout": {
    "request": 20000,
    "connectSocket": 20000,
    "uploadFile": 20000,
    "downloadFile": 20000
  },
"debug":true
}


结构分成4部分

· 页面注册

· 窗体设置

· 菜单栏设置

· 网络延迟设置


页面注册

· 所有页面的集合构成一个数组,第一个元素为首页,以此类推!

· 所有的页面必须在页面注册中注册!


窗体设置

· 设置内容为屏幕最上层部分,主要有导航栏、可拉动和拉动时背景设置

· 导航栏有三个属性

· 可拉动有一个

· 可拉动后的背景颜色设置


菜单栏设置

· 注意事项:若设置了 菜单栏 ,首页 必须是菜单栏的成员,否则菜单栏失效!


网络延迟设置

· 主要是对4种请求的延迟设置


一、App.json全局配置项列表


1.png


1.pages配置项

接受一个数组,每一项都是字符串,来指定小程序由哪些页面组成。每一项代表对应页面的【路径+文件名】信息。


pages配置项要注意三点:

1)数组的第一项用于设定小程序的初始页面。

2)小程序中新增/减少页面,都需要对pages数组进行修改。

3)文件名不需要写文件后缀。小程序框架会自动去寻找路径.json、.js、.wxml、.wxss这四类文件进行整合。

eg:

pages/index/index.wxml

pages/index/index.js


则需要在app.json中写

{
  "pages":[
    "pages/index/index",
    "pages/logs/logs"
  ]
}


2.window配置项

用于设置小程序的状态栏、导航条、标题、窗口等对象的颜色、背景色、内容属性,非必填配置项。没有配置时将使用默认值。window可配置的对象见下表。

2.png注:navigationStyle 只在 app.json 中生效。开启 custom 后,低版本客户端需要做好兼容。开发者工具基础库版本切到 1.7.0(不代表最低版本,只供调试用) 可方便切到旧视觉

如app.json :

{
  "window":{
    "navigationBarBackgroundColor": "#ffffff",
    "navigationBarTextStyle": "black",
    "navigationBarTitleText": "微信接口功能演示",
    "backgroundColor": "#eeeeee",
    "backgroundTextStyle": "light"
  }
}


3.tarBar配置项

小程序可以是多标签页切换的应用,需要通过tarBar配置项来指定标签页的表现,及标签页切换时所显示的对应页面。

3.pngtarBar配置项接受多个对象的设定,其中的对象list是一个数组,用于配置标签页。最少配置2个、最多配置5个,标签页按数组的顺序排序。当设置 position 为 top 时,将不会显示 icon。

其中list接受数组值,数组中的每一项也都是一个对象,其属性值如下:


4.networkTimeout配置项

networkTimeout配置项用于设置各种网络请求对象的超时时间,非必须配置项。可设置的网络请求超时的相关对象有request、connectSocket、uploadFile、downloadFile。超时的单位均为毫秒。这些超市若不设置,则默认使用操作系统内核或遵循服务器WebServer的设定值。

6.png


5.debug配置项

debug配置项用于开启开发者工具的调试模式,他接受一个boolean值(默认是false)。开启后,页面(page)的注册、页面路由、数据更新、事件触发等调试信息将以info的形式,输出在“调试”功能的console面板上。

注意:正式发布时应当关闭此配置项开关。


二、页面配置:page.json


除了全局的app.json配置外,还可以用.json文件对小程序项目中的每一个页面进行配置,但只能设置本页面的window配置项的内容,页面.json文件中的window配置值将覆盖app.json中的配置值。

7.png


页面的.json只能设置window相关的配置项,以决定本页面的窗口表现,所以无需写window这个键,如:

{
  "navigationBarBackgroundColor": "#ffffff",
  "navigationBarTextStyle": "black",
  "navigationBarTitleText": "微信接口功能演示",
  "backgroundColor": "#eeeeee",
  "backgroundTextStyle": "light"
}

工具配置project.config.json  通常大家在使用一个工具的时候都会针对各自喜好做一些个性配置,例如:界面颜色、编译配置等等。


关于配置文件更多信息请参考官网文档:

https://developers.weixin.qq.com/miniprogram/dev/framework/config.html#全局配置 


参考网址:

https://www.jb51.net/article/102830.htm 


转载请注明: ITTXX.CN--分享互联网 » 微信小程序之配置文件app.json、page.json详解

最后更新:2019-01-10 11:22:21

赞 (5) or 分享 ()
游客 发表我的评论   换个身份
取消评论

表情
(0)个小伙伴在吐槽