全局配置文件及常用的配置项
小程序根目录下的 app.json 文件是小程序的全局配置文件。常用的配置如下：
- pages：记录当前小程序所有页面的存放路径
- window：全局设置小程序窗口的外观
- tabBar：设置小程序底部的 tabBar 效果
- style：是否启用新版的组件样式
window
小程序窗口的组成部分
window 常用配置项
| 属性名 | 类型 | 默认值 | 说明 |
|---|---|---|---|
| navigationBarTitleText | String | 字符串 | 导航栏标题文字内容 |
| navigationBarBackgroundColor | HexColor | #000000 | 导航栏背景颜色 |
| navigationBarTextStyle | String | white | 导航栏标题颜色，仅支持black/white |
| backgroundColor | HexColor | #ffffff | 窗口的背景色 |
| backgroundTextStyle | String | dark | 下拉loading的样式，仅支持dark/light |
| enablePullDownRefresh | Boolean | false | 是否全局开启下拉刷新 |
| onReachBottomDistance | Number | 50 | 页面上拉触底事件触发时距页面底部的距离，单位为px |
设置导航栏的标题
app.json -> window -> navigationBarTitleText
设置导航栏的背景色
app.json -> window -> navigationBarBackgroundColor
设置导航栏标题颜色
app.json -> window -> enablePullDownRefresh
全局开启下拉刷新（在 app.json 中启用下拉刷新功能，会作用于每个小程序页面）
下拉刷新：通过手指在屏幕上的下拉滑动操作，从而重新加载页面数据的行为
app.json -> window -> enablePullDownRefresh
设置下拉刷新时窗口的背景色
当全局开启下拉刷新功能后，默认的窗口背景为白色。设置自定义下拉刷新窗口背景色
app.json -> window -> backgroundColor
设置下拉刷新时 loading 的样式
当全局开启下拉刷新功能后，默认的窗口的 loading 为白色。设置 loading 样式的效果
app.json -> window -> backgroundTextStyle
设置上拉触底的距离
上拉触底：通过手指在屏幕上的上拉滑动操作，从而加载更多数据的行为
app.json -> window -> onReachBottomDistance
tabBar
什么是tabBar
- tabBar是移动端应用常见的页面效果，用于实现多页面的快速切换，小程序中将其分为俩种：
- 底部 tabBar
- 顶部 tabBar
- 注意：
- tabBar 中只能配置最少2个，最多5个 tab 页签
- 当渲染顶部 tabBar 时，不显示 icon，只显示文本
tabBar 的 6 个部分
tabBar 常用配置项
-
tabBar 组件的配置项
属性 类型 必填 默认值 说明 position String 否 bottom tabBar 的位置，仅支持 bottom borderStyle String 否 black tabbar 上边框的颜色， 仅支持 black / white color HexColor 否 tabBar上文字的默认颜色（未选中） selectedColor HexColor 否 tabBar选中时文字的默认颜色 backgroundColor HexColor 否 tabBar的背景色 list Array 是 tabBar的页签列表，最少2个，最多5个 -
每个 tab 项的配置选项
属性 类型 必填 说明 pagePath String 是 页面路径，必须在 pages 中先定义 text String 是 tab 上按钮文字 iconPath String 否 图片路径，icon 大小限制为 40kb，建议尺寸为 81px * 81px，不支持网络图片 selectedIconPath String 否 选中时的图片路径，icon 大小限制为 40kb，建议尺寸为 81px * 81px，不支持网络图片
页面配置文件
页面配置文件的作用
小程序中，每个页面都有自己的 .json 配置文件，用来对当前页面的窗口外观、页面效果等进行配置
页面配置和全局配置的关系
小程序中，app.json 中的 window 节点，可以全局配置小程序中每个页面的窗口表现
对小程序中某个页面想要拥有特殊的窗口表现，此时需要对页面级别的 .json 文件进行修改
-
注意：
当页面配置与全局配置冲突时，根据就近原则，最终的效果以页面配置为准
页面配置中常用的配置项
| 属性 | 类型 | 默认值 | 说明 |
|---|---|---|---|
| navigationBarBackgroundColor | HexColor | #000000 | 当前导航栏背景颜色 |
| navigationBarTextStyle | String | white | 导航栏标题颜色，仅支持 black / white |
| navigationBarTitleText | String | 当前导航栏标题文字内容 | |
| backgroundColor | HexColor | #ffffff | 当前窗口的背景色 |
| backgroundTextStyle | String | dark | 当前页面下拉loading的样式，仅支持dark/light |
| enablePullDownRefresh | Boolean | false | 是否为当前页面开启下拉刷新 |
| onReachBottomDistance | Number | 50 | 页面上拉触底事件触发时距页面底部距离，单位为px |
总结
到此这篇关于小程序开发指南之全局配置的文章就介绍到这了,更多相关小程序全局配置内容请搜索Devmax以前的文章或继续浏览下面的相关文章希望大家以后多多支持Devmax！