配置

全局配置

app.json

小程序根目录下的 app.json 文件用来对微信小程序进行全局配置,决定页面文件的路径、窗口表现、设置网络超时时间、设置多 tab 等。

entryPagePath

指定小程序的默认启动路径(首页),常见情景是从微信聊天列表页下拉启动、小程序列表启动等。如果不填,将默认为 pages 列表的第一项。不支持带页面路径参数。

{
  "entryPagePath": "pages/index/index"
}

pages

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

window

用于设置小程序的状态栏、导航条、标题、窗口背景色。

  • navigationBarBackgroundColor 导航栏背景颜色

  • navigationBarTextStyle 导航栏标题颜色 两个参数“black”和“white”

  • navigationBarTitleText 导航栏标题文字内容

  • navigationStyle 导航栏样式仅支持default和custom

  • backgroundColor #ffffff

  • backgroundTextStyle 下拉 loading 的样式,仅支持 dark / light

  • backgroundColorTop 顶部窗口的背景色,仅 iOS 支持

  • backgroundColorBottom 底部窗口的背景色,仅 iOS 支持

  • onReachBottomDistance

  • enablePullDownRefresh 页面刷新,true or false

  • pageOrientation 页面旋转,拥有参数auto/portrait/landscape,其中auto是跟随系统旋转,landscape是固定横屏,portrait是固定竖屏,如果要支持ipad,则需要是使用如下的命令:

{
  "resizable": true
}

tap

如果小程序是一个多 tab 应用(客户端窗口的底部或顶部有 tab 栏可以切换页面),可以通过 tabBar 配置项指定 tab 栏的表现,以及 tab 切换时显示的对应页面。

其中 list 接受一个数组,只能配置最少 2 个、最多 5 个 tab。tab 按数组的顺序排序,每个项都是一个对象,其属性值如下:

networkTimeout

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

app.wxss

app.js

App(Object object)

注册小程序。接受一个 Object 参数,其指定小程序的生命周期回调等。

App() 必须在 app.js 中调用,必须调用且只能调用一次。不然会出现无法预期的后果。

参数

Object object

Sitemap.json

小程序根目录下的 sitemap.json 文件用来配置小程序及其页面是否允许被微信索引。

{
  "rules":[{
    "action": "allow",
    "page": "*"
  }]
}

Last updated