小程序的配置文件

小程序的配置文件

• 小程序的很多开发需求被规定在了配置文件中

常见的配置文件

project.config.json项目配置文件(较少修改)

• 项目配置文件
• 不同的项目开发者开发一个项目的时候能保持一个配置文件

sitemap.json小程序搜索相关的(较少修改)

• 所有页面都会被微信索引（默认情况）

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

• 规则文档地址
  • https://developers.weixin.qq.com/miniprogram/dev/framework/sitemap.html

app.json全局配置

• 文档地址
  • https://developers.weixin.qq.com/miniprogram/dev/framework/config.html#全局配置

较为重要的属性

属性	类型	必填	描述
pages	string[]	是	页面路径列表
window	Object	否	全局的默认窗口表现
tabBar	Object	否	底部tab栏的表现

• pages页面路径列表

  • 用于指定小程序由哪些页面组成，每一项对应也面的路径信息
  • 小程序中所有的页面都是必须在pages中进行注册的

  {
  "pages": [
    "pages/home/home",
    "pages/about/about"
   ]
  }
  

• window全局的默认窗口表现

  • 用户指定窗口如何展示，其中还包含了很多其它的属性
  • 以下是默认生成的配置,写window自动生成

  "window": {
  "navigationBarBackgroundColor": "#ffffff",//导航背景颜色，值不能写单词
  "navigationBarTextStyle": "black",//导航文本样式，值只有black和white
  "navigationBarTitleText": "小程序",//标题文本
  "backgroundColor": "#eeeeee",//背景颜色，下拉刷新的空白区域
  "backgroundTextStyle": "light",//下拉刷新三个点的样式，值只有light和dark
  "enablePullDownRefresh": false//是否下拉刷新
  }
  

• tabBar底部tab栏的表现

  • 以下是默认生成的配置,写tabBar自动生成

    "tabBar": {
   "list": [{//tabBar的item由数组的个数决定，需至少包含 2 项
     "pagePath": "pagePath",//路由映射，把页面的路径写进去
     "text": "text",//图标上显示的文字
     "iconPath": "iconPath",//未选中的默认图标，将图片的路径写进去
     "selectedIconPath": "selectedIconPath"//选中后的图标，将图片的路径写进去
   }]
  }
  

page.json页面配置‘

• 每一个小程序也可以使用.json文件来对本页面的窗口表现进行配置
  • 页面中配置项在当前页面会覆盖app.json的window中相同的配置项
  • 不用写window，直接写属性即可