目录

全局配置文件及常用的配置项 window 小程序窗口的组成部分 window 常用配置项 设置导航栏的标题 设置导航栏的背景色 设置导航栏标题颜色 全局开启下拉刷新（在 app.json 中启用下拉刷新功能，会作用于每个小程序页面） 设置下拉刷新时窗口的背景色 设置下拉刷新时 loading 的样式 设置上拉触底的距离 tabBar 什么是tabBar tabBar 的 6 个部分 tabBar 常用配置项 页面配置文件 页面配置文件的作用 页面配置和全局配置的关系 页面配置中常用的配置项 总结

全局配置文件及常用的配置项

小程序根目录下的 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

总结

到此这篇关于小程序开发指南之全局配置的文章就介绍到这了,更多相关小程序全局配置内容请搜索我们以前的文章或继续浏览下面的相关文章希望大家以后多多支持我们！