欢迎来到我的博客
📔博主是一名大学在读本科生,主要学习方向是前端。
🍭目前已经更新了【Vue】、【React–从基础到实战】、【TypeScript】等等系列专栏
🛠目前正在学习的是🔥 R e a c t / 小程序 React/小程序 React/小程序🔥,中间穿插了一些基础知识的回顾
🌈博客主页👉codeMak1r.小新的博客😇本文目录😇
本文被专栏【小程序|原力计划】收录
🕹坚持创作✏️,一起学习📖,码出未来👨🏻💻!
上篇文章详细讲解了微信小程序WXSS模版语法的一些基本使用,这篇文章将带领大家学习的是小程序的「小程序的全局配置」
全局配置文件及常用的配置项
小程序根目录下的
app.json
文件是小程序的全局配置文件。常用配置项如下:
- pages:记录当前小程序所有页面的存放路径
- window:全局设置小程序窗口的外观
- tabBar:设置小程序底部的tabBar效果
- style:是否启用新版的组件样式
全局配置 — window
小程序窗口组成部分
了解window节点常用的配置项
属性名 | 类型 | 默认值 | 说明 |
---|---|---|---|
navigationBarTitletext | String | 字符串 | 导航栏标题文字内容 |
navigationBarBackgroundColor | HexColor | #fff | 导航栏背景颜色,如#000000 |
navigationBarTextStyle | String | white | 导航栏标题颜色,仅支持black/white |
backgroundColor | HexColor | #ffffff | 窗口的背景色 |
backgroundTextStyle | String | dark | 下拉loading的样式,仅支持dark/white |
enablePullDownRefresh | Boolean | false | 是否全局开启下拉刷新 |
onReachBottomDistance | Number | 50 | 页面上拉触底事件触发时距页面底部距离(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是移动端应用常见的页面效果,用于实现多页面的快速切换。小程序中通常将其分为:
- 底部tabBar
- 顶部tabBar
- tabBar中只能配置最少2个,最多5个tab页签;
- 当渲染顶部tabBar时,不显示icon,只显示文本
tabBar的六个组成部分
- backgroundColor:tabBar的背景色
- selectedIconPath:选中时的图片路径
- borderStyle:tabBar上边框的颜色
- iconPath:未选中时图片的路径
- selectedColor:tab上的文字选中时的颜色
- color:tab上文字的默认(未选中)颜色
tabBar节点的配置项
属性 | 类型 | 必填 | 默认值 | 描述 |
---|---|---|---|---|
position | String | 否 | bottom | tabBar上的位置,仅支持bottom\top |
borderStyle | String | 否 | black | tabBar上边框的颜色,仅支持black\white |
color | HexColor | 否 | tab上文字的默认(未选中)颜色 | |
selectedColor | HexColor | 否 | tab上的文字选中时的颜色 | |
backgroundColor | HexColor | 否 | tabBar的背景色 | |
list | Array | 是 | tab页签的列表 最少2个、最多5个tab页签 |
每个tab项的配置选项
属性 | 类型 | 必填 | 描述 |
---|---|---|---|
pagePath | String | 是 | 页面路径,页面必须在pages中预先定义 |
text | String | 是 | tab上显示的文字 |
iconPath | String | 否 | 未选中时的图标路径; 当position为top时,不显示icon |
selectedIconPath | String | 否 | 选中时的图标路径; 当position为top时,不显示icon |