微信小程序文件以及包含信息
1、project.config.json文件
这个json文件中包含了小程序的一些基本信息,其中有一项为libVersion,这是关于小程序对应的版本号,右上方有一个详情,在里面可以找到小程序更详细的信息,要注意项目设置里面有一个调试基础库,里面可以选择不同的版本,我们要选择用户占比比较高的,这样有利于兼容性处理。同时修改了这里的信息,在json文件的代码中也会相应的改变。
2、app.json文件
app.json文件用来对微信小程序进行全局配置,决定页面文件的路径、窗口表现、设置网络超时时间、设置多tab等。
一、pages配置项
{
"pages":[
"pages/index/index",
"pages/logs/logs"
],
"window":{
"backgroundTextStyle":"light",
"navigationBarBackgroundColor": "#fff",
"navigationBarTitleText": "WeChat",
"navigationBarTextStyle":"black"
}
}
注意:
1.json配置文件中不能添加注释。
2.json配置文件不能有多余的逗号。
3.json配置文件必须使用双引号。
pages配置项用来设置微信小程序的页面组成,接受一个数组,每一项都是字符串。
1、数组的第一项代表小程序的初始页面。
2、小程序中新增/减少页面,都需要度pages数组进行修改。
3、文件名不需要文件后缀,因为框架会自动寻找路径下 .json .js .wxml .wxss四个文件进行整合。
二、windows配置项
用于设置小程序的状态栏、导航条、标题、窗口背景色。
属性 | 类型 | 默认值 | 描述 |
---|---|---|---|
navigationBarBackgroundColor | HexColor | #000000 | 导航栏背景颜色,如“#000000” |
navigationBarTextStyle | String | white | 导航栏标题颜色,仅支持black/white |
navigationBarTitleText | String | 导航栏标题文字内容 | |
backgroundColor | HexColor | #ffffff | 窗口的 背景色 |
backgroundTextStyle | String | dark | 下拉背景字体、loading图的样式,仅支持dark / light |
enablePullDownRefresh | Boolean | false | 是否开启下拉刷新 |
onReachBottomDistance | Number | 50 | 页面上拉触底事件触发时距页面底部距离,单位为px |
tabBar配置项
如果小程序是一个多tab应用(客户端窗口的底部或顶部有tab栏可以切换页面),可以通过tabBar配置项指定tab的表现,以及tab切换时对应的页面。
属性介绍
属性 | 类型 | 必填 | 默认值 | 描述 |
---|---|---|---|---|
color | HexColor | 是 | tab上的文字默认颜色 | |
selectedColor | HexColor | 是 | tab上的文字选中时的颜色 | |
backgroundColor | HexColor | 是 | tab的背景色 | |
borderStyle | String | 否 | black | tabbar上边框的颜色,仅支持black white |
list | Array | 是 | tab的列表,详见list属性说明,最少两个、最多5个 | |
position | String | 否 | bottom | 可选值bottom、top,设置为top是无图标 |
其中list是一个数组,数组中的每个项都是一个对象,其属性值如下:
属性 | 类型 | 必填 | 说明 |
---|---|---|---|
pagePath | String | 是 | 页面路径,必须在pages中先定义 |
text | String | 是 | tab上按钮文字 |
iconPath | String | 否 | 图片路径,icon大小限制为40kb,建议尺寸为81px*81px,当position为top时,此参数无效 |
selectedIconPath | String | 否 | 选中时的图片路径,icon大小限制为40kb,建议尺寸为81px*81px,当position为top时,此参数无效 |
注意:
1、当设置position为top时,将不会显示icon
2、tabBar中的list是一个数组,只能配置至少2个、最多5个tab,tab按数组的顺序排序
3、position设置为top时,会在上方显示切换,默认是在下方显示切换(button)
三、页面json配置项
1、不论有没有配置项都不能把大括号去掉;
2、页面的json配置像是用来配置页面自己单独的顶部样式;
3、不能写window这个键。