微信小程序(json文件配置)

新建页面 新建页面page
(1)手动创建
①右键单击 [pages] 文件夹,在弹出的菜单中选择“新建目录”
②右键单击新建的目录,在弹出的菜单中选择“新建Page”
(2)自动创建
直接在app.json文件的pages选项中将新页面的路径写好,系统会自动创建所对应的四个文件page.wxml模板文件、page.wxss样式文件、page.json配置文件、page.js逻辑文件
删除页面 【微信小程序(json文件配置)】删除页面page
手动删除
鼠标右键单击需要删除的页面文件夹,在弹出的菜单中选择“删除”
配置文件 后缀:.json,文件格式遵循JSON语法规范
作用:对微信小程序进行全局配置,设置页面文件的路径、窗口表现、设置网络超时时间、设置多 tab 切换页等
分类:小程序全局配置文件app.json和页面配置文件page.json
小程序配置 微信小程序(json文件配置)
文章图片

小程序/全局配置文件
小程序根目录下的 app.json 文件用来对微信小程序进行全局配置
文件内容本质就是一个 JSON 对象。
微信小程序(json文件配置)
文章图片

小程序/全局配置文件------>pages属性
作用:用于指定小程序由哪些页面组成,每一项都对应一个页面的 路径(含文件名) 信息。文件名不需要写文件后缀,框架会自动去寻找对于位置的 .json, .js, .wxml, .wxss 四个文件进行处理。
注意:数组的第一项代表小程序的初始页面(首页)。小程序中新增/减少页面,都会对 pages 数组自动进行修改。
微信小程序(json文件配置)
文章图片

作用:用于设置小程序的状态栏、导航条、标题、窗口背景色
微信小程序(json文件配置)
文章图片

小程序/全局配置文件------>window属性~下拉刷新
(1)新建一个空白页,例如home页,建好后会发现home.js文件中已经写好各个阶段钩子函数。
观察后发现onPullDownRefresh下拉函数,这里添加验证代码,输出验证。
微信小程序(json文件配置)
文章图片

(2)下拉无效
然而下拉后发现触发不了js回调,因为下拉功能需要配置,才可以支持下拉功能,即enablePullDownRefresh设置为true
微信小程序(json文件配置)
文章图片

(3)下拉 loading 的样式
通过前面已经知道,可以在app.json中进行全局配置,使所有页面都带有下拉刷新功能;也可以在需要下拉刷新功能的page对应的json中配置。
还有一点点不完美的地方,别人的小程序,下拉刷新时,可以看到顶部有三个点闪烁的动画,而此时小程序顶部一片空白。
微信小程序(json文件配置)
文章图片

(4)窗口背景色
因为背景是白色的,由于颜色的缘故,三个点闪烁的动画看不到,因此背景需要进行以下配置:
微信小程序(json文件配置)
文章图片

(5)loading样式
之前设置的下拉loading样式backgroundTextStyle为light浅色点,接下来可以改为dark深色点体验下
微信小程序(json文件配置)
文章图片

(6)真机下拉bug
经过之前步骤,已经可以在模拟器实现下拉效果,但真机测试后容易出现不缩回的现象,这时可以在下拉监听事件中添加手动缩回的代码。
方案:微信小程序还提供了停止下拉刷新效果的api,如果发现进入刷新状态,无法停止,可以使用wx.stopPullDownRefresh这个api
微信小程序(json文件配置)
文章图片

小程序/全局配置文件------>sitemapLocation属性
作用:指明 sitemap.json 的位置;默认为 ‘sitemap.json’ 即在 app.json 同级目录下名字的 sitemap.json 文件
sitemap.json为小程序收录设置文件,默认所有页面都能被索引,开发中一般不用进行相关配置
页面配置文件page.json 接下来介绍下页面page配置文件page.json
例如logs.json 微信小程序(json文件配置)
文章图片

页面配置文件page.json

作用:对本页面的窗口表现进行配置,文件内容本质为一个 JSON 对象 场景:如果整个小程序的风格是蓝色调,那么在 app.json 里边声明顶部颜色是蓝色即可。实际情况可能不是这样,可能 你小程序里边的每个页面都有不一样的色调来区分不同功能模块,因此小程序提供了 page.json,让开发者可以独立定义 每个页面的一些属性,例如顶部颜色、是否允许下拉刷新等等。 简单理解:就是对单个小程序页面的配置,可以覆盖全局配置app.json。 特性:覆盖性,即每一个小程序页面可以使用同名 .json 文件来对本页面的窗口表现进行配置,但页面中配置项会覆盖 app.json 的 window 中相同的配置项。

常用配置项属性
微信小程序(json文件配置)
文章图片

微信小程序(json文件配置)
文章图片

页面page配置文件
配置项属性—navigationStyle导航栏样式
微信小程序(json文件配置)
文章图片

微信小程序(json文件配置)
文章图片

配置项属性—disableScroll页面滚动
微信小程序(json文件配置)
文章图片

微信小程序(json文件配置)
文章图片

接下来介绍下页面page配置文件
配置项属性—navigationStyle导航栏样式
注意:
①最低版本要求:微信客户端 7.0.0),客户端 7.0.0 以下版本,navigationStyle 只在 app.json 中生效
②图片存储:本地图片过大会有限制提示,一般本地只存项目所用图标即可,如果是大图片,在开发里可以用链接指向图片位置。
json语法结构
(1)优点
①简单易读:易于人的阅读和编写,通常不需要特殊的工具,就能读懂和修改
②轻量:是一种轻量级的数据交换格式
(2)格式
JSON文件都是被包裹在一个大括号中 {},通过key-value的方式表达数据
微信小程序(json文件配置)
文章图片

(3)注意事项
json格式看起来和js的对象表达方式十分相似,但是有所不同
JSON的Key必须包裹在一个双引号中,编写 JSON 的时候,忘了给 Key 值加双引号或者是把双引号写成单引号是常见错误
微信小程序(json文件配置)
文章图片

(4)数据格式限制
JSON的值只能是以下几种数据格式:
微信小程序(json文件配置)
文章图片

其他任何格式都会触发报错,例如 JS中的 undefined
微信小程序(json文件配置)
文章图片

(5)注释限制
JSON 文件中无法使用注释,添加注释将会引发报错
微信小程序(json文件配置)
文章图片

    推荐阅读