同学们大家好,我是小伊同学,今天我们继续来学习微信小程序云开发教程。今天主要给大家讲解一下json配置部分的知识。
JSON 是一种数据格式,并不是编程语言,在小程序中,JSON扮演的静态配置的角色。
JSON文件的内容都是一个JSON对象,被包裹在一个大括号中{},通过key-value的方式来表达数据。
大家在前面的教程中已经学过了js的基本语法,那么js对象在配置文件中的区别就是这里的key是固定的,小程序框架已经指定了我们能配置哪些key,key的具体内容是什么,我们只需要查阅文档根据我们的需要填写value即可。
需要注意的是:
•JSON的Key必须包裹在一个双引号中,单引号或者其他都不可以使用
•JSON文件中无法使用注释
在微信小程序中,一共有四种json配置文件,下面按照重要程度依次给大家讲解。
首先就是之前提到的全局配置,app.json中描述了当前小程序的全局配置,包括了小程序的所有页面路径、界面表现、网络超时时间、底部tab等。
app.json文件通常存放在根目录下,在后面的讲解中,如果没有特殊说明,根目录都前端的根目录,即对于使用云开发的小程序为miniprogram文件夹,对于不使用云开发的小程序直接就是项目根目录。
pages字段用于描述当前小程序所有页面的路径,这是为了让微信客户端知道当前你的小程序页面定义在哪个目录。其中,第一条页面路径为首页。如果我们想把某一页设置为首页,就需要在这里第一个写该页面的路径。其次,window字段定义小程序所有页面的顶部背景颜色,文字颜色定义等。
右图展示的就是一个最基本的小程序的app.json文件内容,我们可以在pages字段看到,这个小程序有两个页面,每一行表示一个页面,页面的路径地址和实际在工程目录中的位置对应,即:pages文件夹下的index文件夹下的index页面,第一行的这个页面也代表了首页。如果我们想要创建一个新的页面,只需要在这里加上一行,按照格式写明页面的路径及名称,重新编译运行,系统会自动为我们创建出该页面的文件夹及四个描述文件。
除了全局配置,每个页面下还会有针对该页面的页面配置文件即文件名为页面名称的json文件,其中独立定义每个页面的一些属性,例如顶部颜色、是否允许下拉刷新等等。
页面配置的json文件存放在页面文件夹中,例如“根目录/pages/index/index.json”文件描述了index页面的配置。这里就是我们之前提到的描述一个页面的四个文件之一。
此外,在页面配置文件中的配置信息具有更高优先级,也就是说,如果在全局配置app.json 的 window 中和本页面配置文件中有相同的配置项,则按照页面配置中的配置执行。
项目根目录下的project.config.json就是工具配置,是对微信开发者工具这个IDE的配置。通常大家在使用一个工具的时候,都会针对各自喜好做一些个性化配置,例如界面颜色、编译配置等,这些配置会保存在此文件中。
此外,前端根目录下还会有sitemap配置,用于配置小程序及其页面是否允许被微信索引。
这两个配置文件通常由开发工具自动帮我们创建,在本教程中我们不必过多关注。
之前我们提到在app.json文件的window字段和页面配置的json文件中都可以配置一些信息,这里给大家介绍三个常用配置项,这三个是在全局配置和页面配置中都能够使用的,当然不是所有的配置项都能在这两个文件中使用,大家可以通过开发者文档查看和学习更多内容。