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

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

小程序根目录下的 app.json 文件是小程序的全局配置文件。常用的配置如下:

pages:记录当前小程序所有页面的存放路径window:全局设置小程序窗口的外观tabBar:设置小程序底部的 tabBar 效果style:是否启用新版的组件样式

window

小程序窗口的组成部分

window 常用配置项

属性名类型默认值说明navigationBarTitleTextString字符串导航栏标题文字内容navigationBarBackgroundColorHexColor#000000导航栏背景颜色navigationBarTextStyleStringwhite导航栏标题颜色,仅支持black/whitebackgroundColorHexColor#ffffff窗口的背景色backgroundTextStyleStringdark下拉loading的样式,仅支持dark/lightenablePullDownRefreshBooleanfalse是否全局开启下拉刷新onReachBottomDistanceNumber50页面上拉触底事件触发时距页面底部的距离,单位为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 组件的配置项

属性类型必填默认值说明positionString否bottomtabBar 的位置,仅支持 bottom borderStyleString否blacktabbar 上边框的颜色, 仅支持 black / whitecolorHexColor否 tabBar上文字的默认颜色(未选中)selectedColorHexColor否 tabBar选中时文字的默认颜色backgroundColorHexColor否 tabBar的背景色listArray是 tabBar的页签列表,最少2个,最多5个

每个 tab 项的配置选项

属性类型必填说明pagePathString是页面路径,必须在 pages 中先定义textString是tab 上按钮文字iconPathString否图片路径,icon 大小限制为 40kb,建议尺寸为 81px * 81px,不支持网络图片selectedIconPathString否选中时的图片路径,icon 大小限制为 40kb,建议尺寸为 81px * 81px,不支持网络图片

页面配置文件

页面配置文件的作用

小程序中,每个页面都有自己的 .json 配置文件,用来对当前页面的窗口外观、页面效果等进行配置

页面配置和全局配置的关系

小程序中,app.json 中的 window 节点,可以全局配置小程序中每个页面的窗口表现

对小程序中某个页面想要拥有特殊的窗口表现,此时需要对页面级别的 .json 文件进行修改

注意:

当页面配置与全局配置冲突时,根据就近原则,最终的效果以页面配置为准

页面配置中常用的配置项

属性类型默认值说明navigationBarBackgroundColorHexColor#000000当前导航栏背景颜色navigationBarTextStyleStringwhite导航栏标题颜色,仅支持 black / whitenavigationBarTitleTextString 当前导航栏标题文字内容backgroundColorHexColor#ffffff当前窗口的背景色backgroundTextStyleStringdark当前页面下拉loading的样式,仅支持dark/lightenablePullDownRefreshBooleanfalse是否为当前页面开启下拉刷新onReachBottomDistanceNumber50页面上拉触底事件触发时距页面底部距离,单位为px

总结

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