wx小程序前端微信小程序

【前端微信小程序】第五章 小程序配置文件

2020-10-14  本文已影响0人  itlu

⼀个⼩程序应⽤程序会包括最基本的两种配置⽂件。⼀种是全局的 app.json 和⻚⾯⾃⼰的page.json

1. 全局配置文件 app.json

  1. app.json 是当前⼩程序的全局配置,包括了⼩程序的所有⻚⾯路径、界⾯表现、⽹络超时时间、底部tab等。普通快速启动项⽬⾥边的app.json 配置字段的含义。

  2. pages 字段 ⽤于描述当前⼩程序所有⻚⾯路径,这是为了让微信客⼾端知道当前你的⼩程序
    ⻚⾯定义在哪个⽬录。

  3. window 字段定义⼩程序所有⻚⾯的顶部背景颜⾊,⽂字颜⾊定义等。

  4. 完整的配置信息请参考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

  1. 这⾥的page.json 其实⽤来表⽰⻚⾯⽬录下的page.json 这类和⼩程序⻚⾯相关的配置。开发者可以独⽴定义每个⻚⾯的⼀些属性,如顶部颜⾊、是否允许下拉刷新等等。⻚⾯的配置只能设置app.json中部分window配置项的内容,⻚⾯中配置项会覆盖 app.jsonwindow中相同的配置项。
属性 类型 默认值 描述
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 配置-了解即可

  1. ⼩程序根⽬录下的sitemap.json⽂件⽤于配置⼩程序及其⻚⾯是否允许被微信索引。

2. 小技巧

  1. app.json 全局配置文件中,可以通过在文件中编写文件的路径而创建对应的文件及目录。但是该技巧仅限在微信开发者工具中使用。
在右侧的app.json文件中编写路径,可以创建左侧的文件夹及路径
上一篇下一篇

猜你喜欢

热点阅读