4.小程序配置文件

⼀个⼩程序应⽤程序会包括最基本的两种配置⽂件。⼀种是全局的
app.json
和
⻚⾯⾃⼰的 page.json 注意：配置文件中不能出现注释

• 1.全局配置 app.json
• 2.tabbar
• 3.页面配置 page.json
• 4.sitemap
  配置-了解即可

1.全局配置 app.json

app.json
是当前⼩程序的全局配置，包括了⼩程序的所有⻚⾯路径、界⾯表现、⽹络超时时间、底 部
tab
等。普通快速启动项⽬⾥边的
app.json 配置

{  
  "pages":[    
  	"pages/index/index",   
  	"pages/logs/logs"  
  ],  
  "window":{    
    "backgroundTextStyle":"light",    
    "navigationBarBackgroundColor": "#fff",    
    "navigationBarTitleText": "WeChat",    
    "navigationBarTextStyle":"black"  
  } 
}

字段的含义

1. pages 字段
   ⸺
   ⽤于描述当前⼩程序所有⻚⾯路径，这是为了让微信客⼾端知道当前你的⼩程序 ⻚⾯定义在哪个⽬录。

2. window 字段
   ⸺
   定义⼩程序所有⻚⾯的顶部背景颜⾊，⽂字颜⾊定义等。

3. 完整的配置信息请参考
   app.json配置 (opens new window)

2.tabbar (opens new window)

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

  "tabBar": {
    "color":"",
    "selectedColor":"",
    "backgroundColor":"",
    "position":"bottom",
    "borderStyle":"black",
    "list": [
      {
        "pagePath": "pages/index/index",
        "text": "首页",
        "iconPath": "icon/_home.png",
        "selectedIconPath": "icon/home.png"
      },
      {
        "pagePath": "pages/img/img",
        "text": "图片",
        "iconPath": "icon/_img.png",
        "selectedIconPath": "icon/img.png"
      },
    ]
  },

其中 list 接受一个数组, 只能配置最少 2 个、最多 5 个 tab

3.页面配置 page.json (opens new window)

这⾥的
page.json
其实⽤来表⽰⻚⾯⽬录下的
page.json
这类和⼩程序⻚⾯相关的配置。 开发者可以独⽴定义每个⻚⾯的⼀些属性，如顶部颜⾊、是否允许下拉刷新等等。 ⻚⾯的配置只能设置
app.json
中部分 window
配置项的内容，⻚⾯中配置项会覆盖
app.json 的
window
中相同的配置项

属性	类型	默认值	描述
navigationBarBackgroundColor	HexColor	#000000	导航栏背景颜⾊，如 #000000
navigationBarTextStyle	String	white	导航栏标题颜⾊，仅⽀持 black / white
navigationBarTitleText	String		导航栏标题⽂字内容
backgroundColor	HexColor	#ffffff	窗⼝的背景⾊
backgroundTextStyle	String	dark	下拉 loading 的样式，仅⽀持 dark / light
enablePullDownRefresh	Boolean	false	是否全局开启下拉刷新。 详⻅ Page.onPullDownRefresh (opens new window)
onReachBottomDistance	Number	50	⻚⾯上拉触底事件触发时距⻚⾯底部距离，单位为px。 详⻅ Page.onReachBottom (opens new window)
disableScroll	Boolean	false	设置为 true 则⻚⾯整体不能上下滚动；只在⻚⾯配置中有 效，⽆法在 app.json 中设置该项

4.sitemap
配置-了解即可 (opens new window)

⼩程序根⽬录下的
sitemap.json ⽂件⽤于配置⼩程序及其⻚⾯是否允许被微信索引