小程序配置

137 阅读2分钟

全局配置

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

  2. app.json 文件用来对微信小程序进行全局配置。文件内容为一个 JSON 对象,有以下属性:

  • pages:设置页面的路径列表
  • window:用来设置全局的窗口表现
`navigationBarTitleText`  导航栏标题文字内容
`backgroundColor`  窗口的背景色
`vbackgroundTextStyle` 下拉 loading 的样式,仅持 `dark` / `light`
  • style:指定使用升级后的 weui 样式
  • sitemapLocation:指明 sitemap.json 的位置
指明 `sitemap.json` 的位置;默认为 'sitemap.json' 
即在 app.json 同级目录下名字的 `sitemap.json`  文件

tabBar

  1. 如果小程序是一个多tab应用,可以通过tabBar 配置项指定tab栏的表现,以及tab切换时显示的对应页面。 可以设置tab页
必填: color               tab上的文字默认 颜色,仅支持十六 进制颜色
必填: selectedColor       tab 上的文字选中时的颜色,仅支持十六进制颜色
必填: backgroundColor     tab 的背景色,仅支持十六进制颜色 
必填: list                tab 的列表,详见 `list` 属性说明,最少 2 个、最多 5 个 tab
borderStyle tabbar       上边框的颜色, 仅支持 `black` / `white` 
  1. 其中 list 接受一个数组,只能配置最少 2 个、最多 5 个 tab。tab 按数组的顺序排序,每个项都是一个对象,其属性值如下:
必填: pagePath            页面路径,必须在 pages 中先定义
必填: text                tab 上按钮文字
iconPath            图片路径,icon 大小限制为 40kb,建议尺寸为 81px 

页面配置

app.json 中的部分配置,也支持对单个页面进行配置, 可以在页面对应的 .json 文件来对本页面的表现进行配置。

  • usingComponents 页面自定义组件配置
  • enablePullDownRefresh 是否开启当前页面下拉刷新。
  • backgroundTextStyle 下拉loading的样式,仅 支持dark / light