【前端微信小程序】第五章 小程序配置文件
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
Tabbar1.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
全局配置文件中,可以通过在文件中编写文件的路径而创建对应的文件及目录。但是该技巧仅限在微信开发者工具中使用。