【小程序从0到1】常用的全局配置

本文介绍了小程序全局配置的关键内容,包括app.json文件中的pages、window、tabBar等配置项的作用与用法,以及如何设置导航栏、下拉刷新等功能。

摘要生成于 C知道 ,由 DeepSeek-R1 满血版支持, 前往体验 >

欢迎来到我的博客
📔博主是一名大学在读本科生,主要学习方向是前端。
🍭目前已经更新了【Vue】、【React–从基础到实战】、【TypeScript】等等系列专栏
🛠目前正在学习的是🔥 R e a c t / 小程序 React/小程序 React/小程序🔥,中间穿插了一些基础知识的回顾
🌈博客主页👉codeMak1r.小新的博客

本文被专栏【小程序|原力计划】收录

🕹坚持创作✏️,一起学习📖,码出未来👨🏻‍💻!
在这里插入图片描述

上篇文章详细讲解了微信小程序WXSS模版语法的一些基本使用,这篇文章将带领大家学习的是小程序的「小程序的全局配置」

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

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

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

全局配置 — window

小程序窗口组成部分

在这里插入图片描述

了解window节点常用的配置项

属性名类型默认值说明
navigationBarTitletextString字符串导航栏标题文字内容
navigationBarBackgroundColorHexColor#fff导航栏背景颜色,如#000000
navigationBarTextStyleStringwhite导航栏标题颜色,仅支持black/white
backgroundColorHexColor#ffffff窗口的背景色
backgroundTextStyleStringdark下拉loading的样式,仅支持dark/white
enablePullDownRefreshBooleanfalse是否全局开启下拉刷新
onReachBottomDistanceNumber50页面上拉触底事件触发时距页面底部距离(px)

设置导航栏的标题:

app.json ⇒ window ⇒ navigationBarTitleText

在这里插入图片描述

设置导航栏的背景色:

app.json ⇒ window ⇒ navigationBarBackgroundColor
仅支持十六进制的颜色设置,不支持如“red/black”颜色设置。

在这里插入图片描述

设置导航栏标题颜色:

app.json ⇒ window ⇒ navigationBarTextStyle
在这里插入图片描述

全局开启下拉刷新功能

概念:下拉刷新是移动端的专有名词,指的是通过手指在屏幕上的下拉滑动操作,从而重新加载页面数据的行为。
app.json ⇒ window ⇒ enablePullDownRefresh设置为true
在app.json中启动下拉刷新功能,会作用于每个小程序页面。

在这里插入图片描述

设置下拉刷新时窗口的背景色

当全局开启下拉刷新功能之后,默认的窗口背景为白色。

自定义下拉刷新窗口的背景色:
app.json ⇒ window ⇒ 为backgroundColor指定16进制的颜色值为:#efefef。

在这里插入图片描述

设置下拉刷新时的loading样式

当全局开启下拉刷新功能之后,默认窗口的loading样式为白色

更改loading样式的效果

app.json ⇒ window ⇒ backgroundTextStyle

全局配置 — tabBar

tabBar是移动端应用常见的页面效果,用于实现多页面的快速切换。小程序中通常将其分为:

  1. 底部tabBar
  2. 顶部tabBar

在这里插入图片描述

  • tabBar中只能配置最少2个,最多5个tab页签;
  • 当渲染顶部tabBar时,不显示icon,只显示文本

tabBar的六个组成部分

在这里插入图片描述

  1. backgroundColor:tabBar的背景色
  2. selectedIconPath:选中时的图片路径
  3. borderStyle:tabBar上边框的颜色
  4. iconPath:未选中时图片的路径
  5. selectedColor:tab上的文字选中时的颜色
  6. color:tab上文字的默认(未选中)颜色

tabBar节点的配置项

属性类型必填默认值描述
positionStringbottomtabBar上的位置,仅支持bottom\top
borderStyleStringblacktabBar上边框的颜色,仅支持black\white
colorHexColortab上文字的默认(未选中)颜色
selectedColorHexColortab上的文字选中时的颜色
backgroundColorHexColortabBar的背景色
listArraytab页签的列表
最少2个、最多5个tab页签

每个tab项的配置选项

属性类型必填描述
pagePathString页面路径,页面必须在pages中预先定义
textStringtab上显示的文字
iconPathString未选中时的图标路径;
当position为top时,不显示icon
selectedIconPathString选中时的图标路径;
当position为top时,不显示icon
评论 3
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

codeMak1r.小新

感谢大佬的资瓷!

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付:¥1
获取中
扫码支付

您的余额不足,请更换扫码支付或充值

打赏作者

实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值