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

新建页面page
(1)手动创建:
①右键单击 [pages] 文件夹,在弹出的菜单中选择“新建目录”
②右键单击新建的目录,在弹出的菜单中选择“新建Page”
(2)自动创建:
直接在app.json文件的pages选项中将新页面的路径写好,系统自动创建对应四个文件page.wxml模板文件、page.wxss样式文件、page.json配置文件、page.js逻辑文件。
微信小程序(JSON配置文件)_第1张图片微信小程序(JSON配置文件)_第2张图片
删除页面page
手动删除:鼠标右键点击需要删除的页面文件夹,在弹出的菜单中选择“删除”。
配置文件
后缀:.json,文件格式遵循JSON语法规范
作用:对微信小程序进行全局配置,设置页面文件的路径、窗口表现、设置网络超时时间、设置多 tab 切换页等
分类:小程序全局配置文件app.json和页面配置文件page.json。
小程序配置文件app.json
(1)小程序配置文件
微信小程序(JSON配置文件)_第3张图片
(2)小程序/全局配置文件
小程序根目录下的app.json文件用来对微信小程序进行全局配置。
文件内容本质就是一个JSON对象
在这里插入图片描述
(3)小程序/全局配置文件—pages属性
作用:用于指定小程序由哪些页面组成,都一 一对应页面的路径信息。文件名不需要写后缀,框架会自动寻找并进行处理(.json、.js、.wxml、wxss)
注意:数组的第一项代表小程序的首页。
微信小程序(JSON配置文件)_第4张图片
(4)小程序/全局配置文件—window属性
作用:用于设置小程序的状态栏、导航栏、标题、窗口背景色。
微信小程序(JSON配置文件)_第5张图片
(5)小程序/全局配置文件—window属性–>下拉刷新
新建一个空白页,例如myself,建好后myself.js文件中已经写好各个阶段钩子函数。
发现onPullDownRefresh下拉函数,添加验证代码,输出验证。
微信小程序(JSON配置文件)_第6张图片
这时会发现下拉无效,因为下拉功能需要
配置
,即enablePullDownRefresh设置为true
微信小程序(JSON配置文件)_第7张图片
下拉loading的样式:
下拉刷新时,可以看到顶部三个小点闪烁的动画
light为浅色点,改为dark深色点
微信小程序(JSON配置文件)_第8张图片微信小程序(JSON配置文件)_第9张图片

微信小程序(JSON配置文件)_第10张图片
窗口背景色:因为窗口背景色是白色,由于颜色缘故,三个点闪烁的动画看不到,因此背景需要进行配置:
微信小程序(JSON配置文件)_第11张图片
backgroundColor:类型:16进制色、默认值:#ffffff、描述:窗口的背景色
(6)真机下拉bug
发现进入刷新状态,无法停止,可以使用wx.stopPullDownRefresh这个api
设置1.5s后恢复到原来状态
微信小程序(JSON配置文件)_第12张图片

(7)小程序/全局配置文件------>sitemapLocation属性

作用:指明 sitemap.json 的位置;默认为 ‘sitemap.json’ 即在 app.json 同级目录下名字的 sitemap.json 文件
sitemap.json为小程序收录设置文件,默认所有页面都能被索引,开发中一般不用进行相关配置

小程序/全局配置文件------>小结
①pages字段:描述当前小程序所有页面路径,便于让微信客户端知道当前小程序页面定义在哪个目录。
②window字段:小程序的状态栏、导航条、标题、窗口背景色
③sitemapLocation字段:指明小程序收录设置文件sitemap.json的位置
页面配置文件page.json
例如:logs.json
在这里插入图片描述
作用:对本页面的窗口表现进行配置,文件内容本质为一个JSON
特性:覆盖性,即每一个小程序页面可以使用同名 .json 文件来对本页面的窗口表现进行配置,但页面中配置项会覆盖 app.json 的 window 中相同的配置项。

常用配置项属性:
微信小程序(JSON配置文件)_第13张图片
微信小程序(JSON配置文件)_第14张图片
(1)页面page配置文件
配置项属性—navigationStyle导航栏样式
微信小程序(JSON配置文件)_第15张图片
微信小程序(JSON配置文件)_第16张图片
注意:①最低版本要求:微信客户端 7.0.0),客户端 7.0.0 以下版本,navigationStyle 只在 app.json 中生效
②图片存储:本地图片过大会有限制提示,一般本地只存项目所用图标即可,如果是大图片,在开发里可以用链接指向图片位置。
图片测试:
在根目录下新建images文件存放图片,这里存放的1.jpg,图片大小限制为2048kb。否则会让‘请删除文件后重试’。
微信小程序(JSON配置文件)_第17张图片
微信小程序(JSON配置文件)_第18张图片
微信小程序(JSON配置文件)_第19张图片
(2)配置项属性—disbleScroll页面滚动
在这里插入图片描述
微信小程序(JSON配置文件)_第20张图片
微信小程序(JSON配置文件)_第21张图片
原理:最外层元素设置超出隐藏
在这里插入图片描述
json语法结构
(1)优点
①简单易读:易于人的阅读和编写,通常不需要特殊的工具,就能读懂和修改
②轻量:是一种轻量级的数据交换格式
(2)格式
JSON文件都是被包裹在一个大括号中 {},通过key-value的方式表达数据
微信小程序(JSON配置文件)_第22张图片
(3)JSON的key不必须用双引号包裹(单引号也不行),否则会报错。
微信小程序(JSON配置文件)_第23张图片
(4)数据格式限制
JSON的值只能是以下数据格式:
微信小程序(JSON配置文件)_第24张图片
其他格式都会报错(例如js中的undefined)
微信小程序(JSON配置文件)_第25张图片
(5)注释限制
JSON文件中无法使用注释,添加注释会引发报错
微信小程序(JSON配置文件)_第26张图片
别名:小程序配置也叫全局配置,页面配置也叫局部配置。
重点:
①覆盖性:页面配置文件相关设置会覆盖小程序配置文件中已有配置
②书写格式:页面配置中只能设置 app.json 中 window 对应的配置项,以决定本页面的窗口表现,所以无需写 window 这个属性
③JSON语法格式及相关限制

你可能感兴趣的:(微信小程序(JSON配置文件))