微信小程序云开发教程-微信小程序的JSON配置
发布于 4 年前 作者 panjie 772 次浏览 来自 分享

  同学们大家好,我是小伊同学,今天我们继续来学习微信小程序云开发教程。今天主要给大家讲解一下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文件中都可以配置一些信息,这里给大家介绍三个常用配置项,这三个是在全局配置和页面配置中都能够使用的,当然不是所有的配置项都能在这两个文件中使用,大家可以通过开发者文档查看和学习更多内容。

回到顶部