4.3.2 app.json全局配置
app.json用于进行全局配置,可设置页面文件的路径、窗口表现、网络超时时间及多tab等。
以下是一个包含部分配置选项的简单app.json全局配置示例:
app.json配置项如表4-3所示。
表4-3 app.json配置项
1.pages
app.json中的pages配置项是一个数组,数组中的每一项都是字符串,用于指定小程序的页面。每一项代表对应页面的路径信息,数组的第一项代表小程序的首页。页面路径不需要写.js后缀,框架会自动加载同名的.json、.js、.axml、.acss文件。
注意
当小程序中新增/减少页面时,都需要对pages数组进行修改。
如果开发目录为:
则需要在app.json中编写如下代码:
2.window
window配置项用于设置通用的状态栏、导航栏、标题、窗口背景颜色,其属性列表如表4-4所示。
表4-4 window属性列表
注意
● HexColor使用十六进制颜色值,如#FF00FF。
● 如果要开启下拉刷新事件,则需要将pullRefresh的值设置为true。
示例代码:
3.tabBar
如果你的小程序是一个多tab应用(客户端窗口的底部栏可以切换页面),那么可以通过tabBar配置项指定tab栏的表现,以及tab切换时显示的对应页面,其属性列表如表4-5所示。
表4-5 tabBar的属性列表
注意
通过页面跳转(dd.navigateTo)或者页面重定向(dd.redirectTo)所到达的页面,即使它是定义在tabBar配置中的页面,也不会显示底部的tab栏。另外,tabBar的第一个页面必须是首页。
items中每个item的属性配置如表4-6所示。
表4-6 item的属性配置
续表
说明
图标推荐大小为60px×60px,系统会对任意传入的图片进行非等比拉伸/缩放操作。
示例代码: