小程序开发指南之全局配置

 更新时间:2022年01月25日 14:42:49   作者:NewBoy  
这篇文章主要给大家介绍了关于小程序开发指南之全局配置的相关资料,文中通过实例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下

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

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

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

window

小程序窗口的组成部分

window 常用配置项

属性名类型默认值说明
navigationBarTitleTextString字符串导航栏标题文字内容
navigationBarBackgroundColorHexColor#000000导航栏背景颜色
navigationBarTextStyleStringwhite导航栏标题颜色,仅支持black/white
backgroundColorHexColor#ffffff窗口的背景色
backgroundTextStyleStringdark下拉loading的样式,仅支持dark/light
enablePullDownRefreshBooleanfalse是否全局开启下拉刷新
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 组件的配置项

    属性类型必填默认值说明
    positionStringbottomtabBar 的位置,仅支持 bottom 
    borderStyleStringblacktabbar 上边框的颜色, 仅支持 black / white
    colorHexColor tabBar上文字的默认颜色(未选中)
    selectedColorHexColor tabBar选中时文字的默认颜色
    backgroundColorHexColor tabBar的背景色
    listArray tabBar的页签列表,最少2个,最多5个
  • 每个 tab 项的配置选项

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

页面配置文件

页面配置文件的作用

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

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

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

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

  • 注意:

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

页面配置中常用的配置项

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

总结

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

您可能感兴趣的文章:

相关文章

  • js控制框架刷新

    js控制框架刷新

    一句话控制框架的刷新
    2008-08-08
  • 原生JavaScript实现合并多个数组示例

    原生JavaScript实现合并多个数组示例

    这篇文章主要介绍了原生的JavaScript及jquery实现合并多个数组,很简单,很实用,大家可以看看
    2014-09-09
  • 详解JavaScript如何准确获取任意变量的数据类型

    详解JavaScript如何准确获取任意变量的数据类型

    js是弱类型语言,或者说是动态语言,在定义变量时我们可以不提前声明变量的类型,也可以在变量声明后赋予不同类型的值。所以本文为大家详解一下JavaScript如何准确获取任意变量的数据类型,需要的可以参考一下
    2022-06-06
  • JavaScript中常用的数组操作方法总结

    JavaScript中常用的数组操作方法总结

    这篇文章为大家总结了一些JavaScript中常用的数组操作方法,文中通过示例代码介绍的非常详细。对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下
    2022-07-07
  • js链接确认提醒功能

    js链接确认提醒功能

    非常不错的功能,当单机一个链接时,会弹出确认对话框效果
    2008-09-09
  • JavaScript简单实现合并两个Json对象的方法示例

    JavaScript简单实现合并两个Json对象的方法示例

    这篇文章主要介绍了JavaScript简单实现合并两个Json对象的方法,结合实例形式分析了json对象的遍历、添加实现合并的相关操作技巧,需要的朋友可以参考下
    2017-10-10
  • JavaScript使用Fetch的方法详解

    JavaScript使用Fetch的方法详解

    Fetch API提供了一个JavaScript接口,用于访问和操纵HTTP管道的部分。它还提供了一个全局 fetch()方法,该方法提供了一种简单,合理的方式来跨网络异步获取资源。本文将详解JS如何使用Fetch,感兴趣的可以学习一下
    2022-05-05
  • js Canvas绘制圆形时钟教程

    js Canvas绘制圆形时钟教程

    这篇文章主要为大家详细介绍了js Canvas绘制圆形时钟教程,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2017-02-02
  • javascript js 操作数组 增删改查的简单实现

    javascript js 操作数组 增删改查的简单实现

    下面小编就为大家带来一篇javascript js 操作数组 增删改查的简单实现。小编觉得挺不错的,现在就分享给大家,也给大家做个参考。一起跟随小编过来看看吧
    2016-06-06
  • 在JavaScript中终止forEach循环的三种方式

    在JavaScript中终止forEach循环的三种方式

    如何终止forEach循环这个问题估计会难倒一部分同学,甚至会有人反问,forEach循环在JavaScript中能终止吗?本文小编给大家介绍了三种方式可以终止forEach循环,需要的朋友可以参考下
    2023-11-11

最新评论