配置文件

104 阅读3分钟

1.配置文件介绍

1.JSON 是一种轻量级的数据格式,常用于前后端数据的交互,但是在小程序中,JSON 扮演的配置项的角色,用于配置项目或者页面属性和行为,每个页面或组件也都有一个对应的json 文件。
2.小程序中常见的配置文件有以下几种:
    1.app.json:小程序全局配置文件,用于配置小程序的一些全局属性和页面路由。
    2.页面.json:小程序页面配置文件,也称局部配置文件,用于配置当前页面的窗口样式、页面标题等
    3.project.confg.json:小程序项目的配置文件,用于保存项目的一些配置信息和开发者的个人设置
    4.sitemap.json:配置小程序及其页面是否允许被微信索引,提高小程序在搜索引擎搜索到的概率

2.全局配置-pages 配置

1.pages 字段:用来指定小程序由哪些页面组成,用于让小程序知道由哪些页面组成以及页面定义在哪个目录,每一项都对应一个页面的 路径信息。
2.在配置 pages 字段时,有以下 注意事项:
    1.页面路由不需要写文件后缀,框架会自动去寻找对应位置的四个文件进行处理
    2. 小程序中新增/减少页面,都需要对 pages 数组进行修改
    3.未指定 entryPagePath 时,数组的第一项代表小程序的初始页面(首页)

3.全局配置-window 配置

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

4.全局配置-tabbar 配置

tabBar 字段:定义小程序顶部、底部 tab 栏,用以实现页面之间的快速切换可以通过 tabBar 配置项指定 tab 栏的表现,以及 tab 切换时显示的对应页面。
  注意事项:tab 按数组的顺序排序,list 配置最少2个、最多5个tab

5.页面配置

小程序的页面配置,也称局部配置,每一个小程序页面也可以使用自己的 .json 文件来对本页面的窗口表现进行配置需要注意的是:页面配置文件的属性和 全局配置文件中的 window 属性几乎一致,只不过这里不需要额外指定 window 字段,因此如果出现相同的配置项,页面中配置项 会覆盖全局配置文件中相同的配置项。

6. sitemap.json 文件

1.sitemap.ison 文件:配置小程序及其页面是否允许被微信索引,提高小程序在微信内部被用户搜索到的概率
2.微信现已开放小程序内搜索,开发者可以通过 sitemap.json 配置来设置小程序页面是否允许微信索引。当开发者允许微信索引时,微信会通过爬中的形式,为小程序的页面内容建立索引。当用户的搜索词条触发该索引时,小程序的页面将可能展示在搜索结果中
  注意事项:
      1. 注:没有 sitemap.json 则默认所有页面都能被索引
      2.{"action":"allow","page":"*“}是优先级最低的默认规则,未显式指明"disallow" 的都默认被索引