以下是示例配置文件 app.json

    app.json 配置项列表

    pages

    用于指定小程序由哪些页面组成,每一项都对应一个页面的 路径+文件名 信息,pages 数组的第一项代表小程序的首页,增加或减少页面,都需要对 pages 数组进行手动增加或减少,值得注意的是,pages 数组中的项目不能重复。

    如开发目录为:

    则需要在 app.json 中写

    window

    用于设置小程序全局的状态栏、标题、窗口表现等。

    属性类型默认值描述
    navigationBarBackgroundColorHexColor(十六进制颜色值)#000000导航栏背景颜色,如 #000000
    navigationBarTextStyleStringwhite导航栏标题颜色,目前仅支持 black / white
    navigationBarTitleTextString导航栏标题文字内容,字数不宜过多
    navigationStyleStringdefault导航栏样式,仅支持以下值:1. default(默认样式), 2. custom(自定义导航栏,只保留右上角按钮)
    backgroundColorHexColor#ffffff窗口的背景色
    backgroundTextStyleStringdark下拉 loading 的样式,仅支持 dark / light
    backgroundColorTopString#ffffff顶部窗口的背景色,仅 iOS 支持
    backgroundColorBottomString#ffffff底部窗口的背景色,仅 iOS 支持

    1. 只在 app.json 中生效,请勿在页面的json中配置
    示例如下:

    tabBar

    tabBar 用来配置小程序底部或者顶部的 tab 导航栏的样式以及跳转的页面等;详细配置项如下:

    其中 list 是数组类型,只能配置最少2个、最多5个 tab。tab 按数组的顺序排序,每个项都是一个独立的对象,其可配置值如下:

    属性类型必填说明
    pagePathString页面路径,必须在 pages 数组中先定义
    textStringtab 上按钮文字
    iconPathString图片路径,icon 大小限制为40kb,建议尺寸为 81px * 81px,不支持网络图片。当 postion 为 top 时,不显示 icon。
    selectedIconPathString选中时的图片路径,要求同 iconPath

    配置 - 图2

    networkTimeout

    网络请求的超时时间,单位均为毫秒。

    debug

    布尔类型,当配置为时,扫码后,小程序中会增加一个信息查看按钮,可以查看 Page 的注册,页面路由,事件触发,console 等信息,可以帮助开发者快速定位问题。

    页面配置

    每一个小程序页面也可以使用.json文件来对本页面的窗口表现进行配置。

    页面的配置只能设置 app.json 中部分 window 配置项的内容,页面中配置项会覆盖 app.jsonwindow 中相同的配置项,可配置的选项如下:

    属性类型默认值描述
    navigationBarBackgroundColorHexColor#000000导航栏背景颜色,如 #000000
    navigationBarTextStyleStringwhite导航栏标题颜色,仅支持 black、white
    navigationBarTitleTextString导航栏标题文字内容
    backgroundColorHexColor#ffffff窗口的背景色
    backgroundTextStyleStringdark下拉 loading 的样式,仅支持 dark、light
    disableScrollBooleanfalse设置为 true 则页面整体不能上下滚动;仅在页面配置中有效,