系列文章目录
👉【零基础微信小程序入门开发】配置小程序
上次说到小程序的介绍和环境的搭建、打印hello word,以及部分组件等一些基本功能的介绍,写的有点不详细,如果分的太细了功能又太少,于是我打算围绕开发者的文档来进行说明,这样可能更加直观一点,废话不多少,开始
全局配置
我们在小程序官方模板中可以看到根目录有一个app.json,这个文件用来对微信小程序进行全局配置,决定页面文件的==路径==、==窗口表现==、==设置网络超时时间==、==设置多 tab== 等。{
"pages":[
"pages/index/index",
"pages/logs/logs"
],
"window":{
"backgroundTextStyle":"light",
"navigationBarBackgroundColor": "#fff",
"navigationBarTitleText": "Weixin",
"navigationBarTextStyle":"black"
},
"style": "v2",
"sitemapLocation": "sitemap.json"
}
①pages里面的为项目路径,第一个为【"pages/index/index",】表示优先加载该页面,其他的位次顺序无所谓,但是只有这里有文件才可以跳转
②window是对整个小程序窗口做调整
属性 | 默认值 | 描述 |
---|---|---|
backgroundTextStyle | dark | 下拉 loading 的样式,仅支持 dark / light |
navigationBarBackgroundColor | #000000 | 导航栏背景颜色,如 #000000 |
navigationBarTitleText | 导航栏标题文字内容 | |
navigationBarTextStyle | white | 导航栏标题颜色,仅支持 black / white |
页面配置
属性 | 类型 | 默认值 | 描述 |
---|---|---|---|
navigationBarBackgroundColor | HexColor | #000000 | 导航栏背景颜色,如 #000000 |
navigationBarTextStyle | string | white | 导航栏标题颜色,仅支持 black / white |
navigationBarTitleText | string | 导航栏标题文字内容 | |
navigationStyle | string | default | 导航栏样式,仅支持以下值: |
default | 默认样式 | custom | 自定义导航栏,只保留右上角胶囊按钮。 |
backgroundColor | HexColor | #ffffff | 窗口的背景色 |
backgroundTextStyle | string | dark | 下拉 loading 的样式,仅支持 dark / light |
backgroundColorTop | string | #ffffff | 顶部窗口的背景色,仅 iOS 支持 微信客户端 6.5.16 |
backgroundColorBottom | string | #ffffff | 底部窗口的背景色,仅 iOS 支持 微信客户端 6.5.16 |
enablePullDownRefresh | boolean | false | 是否开启当前页面下拉刷新。 |
onReachBottomDistance | number | 50 | 页面上拉触底事件触发时距页面底部距离,单位为px。 |
pageOrientation | string | portrait | 屏幕旋转设置,支持 auto / portrait / landscape |
disableScroll | boolean | false | 设置为 true 则页面整体不能上下滚动。 |
usingComponents | Object | 否 | 页面自定义组件配置 1.6.3 |
initialRenderingCache | string | 页面初始渲染缓存配置,支持 static / dynamic 2.11.1 | |
style | string | default | 启用新版的组件样式 2.10.2 |
singlePage | Object | 否 | 单页模式相关配置 2.12.0 |
restartStrategy | string | homePage | 重新启动策略配置 2.8.0 |
handleWebviewPreload | string | static | 控制预加载下个页面的时机。 |
visualEffectInBackground | string | 否 | 切入系统后台时,隐藏页面内容,保护用户隐私。 |
enablePassiveEvent | Object或boolean | 否 | 事件监听是否为 passive,若对页面单独设置则会覆盖全局的配置 |
sitemap 配置
sitemap.json用于微信索引,当开发者允许微信索引时,微信会通过爬虫的形式,为小程序的页面内容建立索引。当用户的搜索词条触发该索引时,小程序的页面将可能展示在搜索结果中。
以上就是今天讲解的内容