【前端微信小程序】第五章 小程序配置文件
2020-10-14 本文已影响0人
itlu
⼀个⼩程序应⽤程序会包括最基本的两种配置⽂件。⼀种是全局的
app.json和⻚⾯⾃⼰的page.json。
1. 全局配置文件 app.json
-
app.json是当前⼩程序的全局配置,包括了⼩程序的所有⻚⾯路径、界⾯表现、⽹络超时时间、底部tab等。普通快速启动项⽬⾥边的app.json配置字段的含义。 -
pages字段 ⽤于描述当前⼩程序所有⻚⾯路径,这是为了让微信客⼾端知道当前你的⼩程序
⻚⾯定义在哪个⽬录。 -
window字段定义⼩程序所有⻚⾯的顶部背景颜⾊,⽂字颜⾊定义等。 -
完整的配置信息请参考
app.json配置
{
"pages":[
"pages/index/index",
"pages/logs/logs"
],
"window":{
"backgroundTextStyle":"light",
"navigationBarBackgroundColor": "#fff",
"navigationBarTitleText": "Weixin",
"navigationBarTextStyle":"black"
},
"style": "v2",
"sitemapLocation": "sitemap.json"
}
1.1 tabbar
Tabbar
1.2 ⻚⾯配置page.json
- 这⾥的
page.json其实⽤来表⽰⻚⾯⽬录下的page.json这类和⼩程序⻚⾯相关的配置。开发者可以独⽴定义每个⻚⾯的⼀些属性,如顶部颜⾊、是否允许下拉刷新等等。⻚⾯的配置只能设置app.json中部分window配置项的内容,⻚⾯中配置项会覆盖app.json的window中相同的配置项。
| 属性 | 类型 | 默认值 | 描述 |
|---|---|---|---|
| navigationBarBackgroundColor | HexColor | #000000 | 导航栏背景颜⾊,如 #000000 #000000 |
| navigationBarTextStyle | String | white | 导航栏标题颜⾊,仅⽀持 black black / white white |
| navigationBarTitleText | String | 导航栏标题⽂字内容 | |
| backgroundColor | HexColor | #ffffff | 窗⼝的背景⾊ |
| backgroundTextStyle | String | dark | 下拉�loading的样式,仅⽀持 dark dark / light light |
| enablePullDownRefresh | Boolean | false | 是否全局开启下拉刷新。详⻅Page.onPullDownRefresh |
| onReachBottomDistance | Number | 50 | ⻚⾯上拉触底事件触发时距⻚⾯底部距离,单位为px。详⻅Page.onReachBottom |
| disableScroll | Boolean | false | 设置为 true 则⻚⾯整体不能上下滚动;只在⻚⾯配置中有效,⽆法在app.json app.json 中设置该项 |
1.3 sitemap 配置-了解即可
- ⼩程序根⽬录下的
sitemap.json⽂件⽤于配置⼩程序及其⻚⾯是否允许被微信索引。
2. 小技巧
-
app.json全局配置文件中,可以通过在文件中编写文件的路径而创建对应的文件及目录。但是该技巧仅限在微信开发者工具中使用。
在右侧的app.json文件中编写路径,可以创建左侧的文件夹及路径