微信小程序开发教程(六)配置——app.json、page.json详解
2018-03-04 17:46
866 查看
全局配置:app.json
微信小程序的全局配置保存在app.json文件中。开发者通过使用app.json来配置页面文件(pages)的路径、窗口(window)表现、设定网络超时时间值(networkTimeout)以及配置多个切换页(tarBar)等。
首先看一个典型的全局配置app.json文件
1.pages配置项
接受一个数组,每一项都是字符串,来指定小程序由哪些页面组成。每一项代表对应页面的【路径+文件名】信息。
pages配置项要注意三点:
1)数组的第一项用于设定小程序的初始页面。
2)小程序中新
bc56
增/减少页面,都需要对pages数组进行修改。
3)文件名不需要写文件后缀。小程序框架会自动去寻找路径.json、.js、.wxml、.wxss这四类文件进行整合。
2.window配置项
用于设置小程序的状态栏、导航条、标题、窗口等对象的颜色、背景色、内容属性,非必填配置项。没有配置时将使用默认值。window可配置的对象见下表。
注:HexColor为十六进制颜色值类型,如“#ff00ff”
3.tarBar配置项
小程序可以是多标签页切换的应用,需要通过tarBar配置项来指定标签页的表现,及标签页切换时所显示的对应页面。
tarBar配置项接受多个对象的设定,其中的对象list是一个数组,用于配置标签页。最少配置2个、最多配置5个,标签页按数组的顺序排序。当设置 position 为 top 时,将不会显示 icon。
其中list接受数组值,数组中的每一项也都是一个对象,其属性值如下:
4.networkTimeout配置项
networkTimeout配置项用于设置各种网络请求对象的超时时间,非必须配置项。可设置的网络请求超时的相关对象有request、connectSocket、uploadFile、downloadFile。超时的单位均为毫秒。这些超市若不设置,则默认使用操作系统内核或遵循服务器WebServer的设定值。
5.debug配置项
debug配置项用于开启开发者工具的调试模式,他接受一个boolean值(默认是false)。开启后,页面(page)的注册、页面路由、数据更新、事件触发等调试信息将以info的形式,输出在“调试”功能的console面板上。
注意:正式发布时应当关闭此配置项开关。
页面配置:page.json
除了全局的app.json配置外,还可以用.json文件对小程序项目中的每一个页面进行配置,但只能设置本页面的window配置项的内容,页面.json文件中的window配置值将覆盖app.json中的配置值。
微信小程序的全局配置保存在app.json文件中。开发者通过使用app.json来配置页面文件(pages)的路径、窗口(window)表现、设定网络超时时间值(networkTimeout)以及配置多个切换页(tarBar)等。
首先看一个典型的全局配置app.json文件
{ "pages": [ "pages/index/index", "pages/logs/logs", "pages/demo/demo" ], "window": { "backgroundTextStyle": "light", "navigationBarBackgroundColor": "#fff", "navigationBarTitleText": "WeChat", "navigationBarTextStyle": "black" }, "tarBar": { "list": [{ "pagePath":"pages/index/index", "text": "首页" },{ "pagePath": "pages/logs/logs", "text": "日志" },{ "pagePath": "pages/demo/demo", "text": "demo" }] }, "networkTimeout": { "request": 20000, "connectSocket": 20000, "uploadFile": 20000, "downloadFile": 20000 }, "debug":true }全局配置项及描述如下表:
1.pages配置项
接受一个数组,每一项都是字符串,来指定小程序由哪些页面组成。每一项代表对应页面的【路径+文件名】信息。
pages配置项要注意三点:
1)数组的第一项用于设定小程序的初始页面。
2)小程序中新
bc56
增/减少页面,都需要对pages数组进行修改。
3)文件名不需要写文件后缀。小程序框架会自动去寻找路径.json、.js、.wxml、.wxss这四类文件进行整合。
2.window配置项
用于设置小程序的状态栏、导航条、标题、窗口等对象的颜色、背景色、内容属性,非必填配置项。没有配置时将使用默认值。window可配置的对象见下表。
注:HexColor为十六进制颜色值类型,如“#ff00ff”
3.tarBar配置项
小程序可以是多标签页切换的应用,需要通过tarBar配置项来指定标签页的表现,及标签页切换时所显示的对应页面。
tarBar配置项接受多个对象的设定,其中的对象list是一个数组,用于配置标签页。最少配置2个、最多配置5个,标签页按数组的顺序排序。当设置 position 为 top 时,将不会显示 icon。
其中list接受数组值,数组中的每一项也都是一个对象,其属性值如下:
4.networkTimeout配置项
networkTimeout配置项用于设置各种网络请求对象的超时时间,非必须配置项。可设置的网络请求超时的相关对象有request、connectSocket、uploadFile、downloadFile。超时的单位均为毫秒。这些超市若不设置,则默认使用操作系统内核或遵循服务器WebServer的设定值。
5.debug配置项
debug配置项用于开启开发者工具的调试模式,他接受一个boolean值(默认是false)。开启后,页面(page)的注册、页面路由、数据更新、事件触发等调试信息将以info的形式,输出在“调试”功能的console面板上。
注意:正式发布时应当关闭此配置项开关。
页面配置:page.json
除了全局的app.json配置外,还可以用.json文件对小程序项目中的每一个页面进行配置,但只能设置本页面的window配置项的内容,页面.json文件中的window配置值将覆盖app.json中的配置值。
相关文章推荐
- 微信小程序学习(4)-系统配置app.json详解
- 开发微信小程序(3)-全局配置app.json及底部导航栏实现
- wx.getImageInfo详解-图片-媒体API-微信小程序API-微信小程序开发教程
- 微信小程序app.json如何配置
- 微信小程序——wx.navigateTo中url无法跳转问题(app.json中配置的tabBar与wx.navigateTo中url引用相同页面导致)(2017/12)
- 微信小程序 app.json详解
- 微信小程序开发详解(六)---微信小程序配置
- 微信小程序一app.json配置
- 微信小程序开发教程(七)逻辑层——.js详解
- 微信小程序开发出现未找到入口 app.json 文件解决方法
- 详解微信小程序开发教程
- 微信小程序开发详解 1 : 初始小程序 2 :开发框架配置和逻辑层
- 微信小程序学习(4)-系统配置app.json
- 微信小程序开发简单教程---配置
- natapp 配置微信小程序开发需要的网络环境
- 详解微信小程序开发教程
- 微信小程序框架中的app.json配置(一)
- 微信小程序开发教程(基础篇)3-app.js 解析
- 微信小程序:wx.navigateTo中url无法跳转问题(app.json中配置的tabBar与wx.navigateTo中url引用相同页面导致)
- 微信小程序的app.json配置(三)