企业数字化转型:钉钉小程序开发权威指南
上QQ阅读APP看本书,新人免费读10天
设备和账号都新为新人

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,系统会对任意传入的图片进行非等比拉伸/缩放操作。

示例代码: