第2章 微信小程序框架分析
图2.10 小程序公共样式表
4.PROJECT.CONFIG.JSON小程序项目个性化配置文件 在使用微信小程序开发者工具时,开发者都会针对各自喜好做一
些个性化配置,例如界面颜色、编译配置等。当换了另外一台计算机 重新安装工具的时候,用户还要重新配置。因此,小程序开发者工具 在每个项目的根目录都会生成一个PROJECT.CONFIG.JSON文件,用户 在工具上做的任何配置都会写入这个文件。
表2.1 框架全局文件
1.APP.JS小程序逻辑文件 APP.JS文件用来定义全局数据和函数的使用,它可以指定微信小程序
的生命周期函数。 生命周期函数可以理解为微信小程序自己定义的函数,例如ONLAUNCH
(监听小程序初始化)、ONSHOW(监听小程序显示)、ONHIDE(监听小程 序隐藏)等,在不同阶段不同场景可以使用不同的生命周期函数。此外, APP.JS中还可以定义一些全局的函数和数据,其他页面引用APP.JS文件后 就可以直接使用,如图2.2所示。
3.APP.WXSS小程序公共样式表 APP.WXSS文件对CSS样式进行了扩展,和CSS的使用方式一样,类
选择器和行内样式的写法兼容大部分CSS样式,有一些CSS样式在这里 是不起作用的。APP.WXSS还形成了自己的风格,是对所有页面定义的 一个全局样式。
只要页面有全局样式里的CLASS,就可以渲染全局样式里的效果; 但如果页面又重新定义了这个CLASS样式,则会把全局的覆盖掉,使 用自己的样式,如图2.10所示。
图2.4 自动创建页面
(2)配置窗口表现。如图2.5所示。
图2.5 窗口表现
(3)配置标签导航。标签导航是很多移 动APP都会采用的一种导航方式,微信小 程序同样可以实现这样的效果,如图2.6 所示。
图2.6 猫眼电影App标签导航
怎么制作标签导航呢?我们需要在APP.JSON文件里配置TABBAR属 性。
2.1 微信小程序目录结构介绍
微信小程序目录结构可以分为3 个部分——框架全局文件、工具类 文件和框架页面文件,如图2.1所示。
图2.1 微信小程序框架目录
2.1.1 框架全局文件
框架全局文件必须放在项目的根目录中。 框架全局文件包括4个文件:APP.JS小程序逻 辑文件(定义全局数据以及定义函数文件)、 APP.JSON小程序公共设置文件、APP.WXSS小程 序公共样式表、PROJECT.CONFIG.JSON小程序 项目个性化配置文件。它们对所有页面都有效, 如表2.1所示。
表2.2 框架页面文件
微信小程序的框架页面文件, 都放置在PAGES文件夹下面,如图 2.12所示。
图2.12 页面文件
每个页面都有一个独立的文件夹,比如日志页面LOGS文件夹,它 的下面放置5个文件:LOGS.JS进行业务路径处理;LOGS.JSON进行页面 配置,可以覆盖全局APP.JSON配置;LOGS.WXML配置页面结构,负责渲 染页面;WXS(WEIXIN?SCRIPT)是小程序的一套脚本语言,LOGS.WXS 结合WXML文件,可以构建出页面的结构;LOGS.WXSS是针对LOGS.WXML 页面的样式文件。
图2.7 猫眼电影微信小程序标签导航配置
(4)配置网络超时。可以配置网络请求、文件上传、文件下载时最 大的请求时间,超过这个时间,则不再请求。 (5)配置DEBUG模式。配置DEBUG模式可方便微信小程序开发者调试 开发程序,如图2.8和图2.9所示为没有开启DEBUG模式和开启DEBUG模 式的调试信息对比。
图2.8 没有开启debug模式
图2.9 开启debug模式
从图2.8和图2.9可以看出,开启DEBUG模式后,可以看到每一步 的调用情况、访问路径以及错误信息,这样更加方便开发者进行调试 工作。
APP.JSON作为全局配置文件就是提供配置页面路径、配置窗口的 表现、配置底部标签导航.2 app.js小程序逻辑
2.APP.JSON小程序公共设置文件 APP.JSON文件可以对5个功能进行设
置:配置页面路径、配置窗口表现、配 置标签导航、配置网络超时、配置DEBUG 模式。具体如图2.3所示。
图2.3 app.json的5个功能
(1)配置页面路径。页面路径定义了一个数组,存放多个页面的访 问路径,它是进行页面访问的必要条件。如果在这里没有配置页面访 问路径,页面被访问时就会报错;在这里定义了页面访问路径,微信 小程序框架就可以在页面文件夹下建立相应名称的文件夹以及文件, 免去用户手动添加文件夹和文件的痛苦,如图2.4所示。
微信小程序开发图解案例教程 (附精讲视频)(第2版)
刘刚 著
第2章 微信小程序框架分析
微信小程序目录结构介绍 ■ 微信小程序注册程序应用 ■ 微信小程序注册页面的使用 ■ 微信小程序如何绑定数据 ■ 微信小程序条件渲染 ■ 微信小程序列表渲染 ■ 微信小程序定义模板 ■ 微信小程序的引用功能 ■ WXS小程序脚本语言 ■ 沙场大练兵:仿香哈菜谱微信小程序 ■ 小结 ■
重新安装工具或者换计算机工作时,用户只要载入同一个项目的 代码包,开发者工具就会自动恢复到当时开发项目时的个性化配置, 其中包括编辑器的颜色、代码上传时自动压缩等一系列选项。
2.1.2 工具类文件
在微信小程序框架目录里有一个UTILS文件夹,它用来存放工具 栏的JS函数,例如可以放置一些日期格式化的函数、时间格式化的函 数等一些常用的函数。
定义完这些函数后,要通过MODULE.EXPORTS将定义的函数名称注 册进来,在其他的页面才可以使用,图2.11所示为时间格式化工具类 文件。
图2.11 utils.js工具类文件
2.1.3 框架页面文件
一个小程序框架页面文件由5个 文件组成,分别是JS页面逻辑、JSON 页面配置、WXML页面结构、WXS小程 序脚本语言、WXSS页面样式表,如表 2.2所示。
TABBAR是一个对象,它可以配置标签导航文字的默认颜色、选中 颜色,标签导航背景色以及上边框颜色。
上边框颜色可以配置两种颜色:BLACK/WHITE。 标签导航存放到LIST数组里面,LIST里的每个对象对应一个标签 导航,每个对象里可以配置标签导航的路径、导航名称、默认图标以 及选中图标,如图2.7所示。