小程序入门学习(四)之全局配置

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

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

pages:记录当前小程序所有页面的存放路径

window:全局设置小程序窗口的外观

tabBar:设置小程序底部的 tabBar 效果

style:是否启用新版的组件样式

二、window

1. 小程序窗口的组成部分

2、window 节点常用的配置项

3. 设置导航栏的标题

设置步骤:app.json -> window -> navigationBarTitleText

4. 设置导航栏的背景色

设置步骤:app.json -> window -> navigationBarBackgroundColor

5. 设置导航栏的标题颜色

设置步骤:app.json -> window -> navigationBarTextStyle

注意: navigationBarTextStyle 的可选值只有 black 和 white

6. 全局开启下拉刷新功能

设置步骤:app.json -> window -> 把 enablePullDownRefresh 的值设置为 true

注意:在 app.json 中启用下拉刷新功能,会作用于每个小程序页面!

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

当全局开启下拉刷新功能之后,默认的窗口背景为白色。如果自定义下拉刷新窗口背景色,设置步骤为: app.json -> window -> 为 backgroundColor 指定16进制的颜色值 #efefef。

8. 设置下拉刷新时 loading 的样式

当全局开启下拉刷新功能之后,默认窗口的 loading 样式为白色,如果要更改 loading 样式的效果,设置步 骤为 app.json -> window -> 为 backgroundTextStyle 指定 dark 值。

9. 设置上拉触底的距离

设置步骤: app.json -> window -> 为 onReachBottomDistance 设置新的数值。

注意:默认距离为50px,如果没有特殊需求,建议使用默认值即可。

三、tabBar

1. 什么是 tabBar

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

  • 底部 tabBar
  • 顶部 tabBar

注意:

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

2. tabBar 的 6 个组成部分

  • backgroundColor:tabBar 的背景色
  • selectedIconPath:选中时的图片路径
  • borderStyle:tabBar 上边框的颜色
  • iconPath:未选中时的图片路径
  • selectedColor:tab 上的文字选中时的颜色
  • color:tab 上文字的默认(未选中)颜色

3. 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 |

4. 每个 tab 项的配置选项

复制代码
"tabBar": {
    "list": [{
      "pagePath": "pages/home/home",
      "text": "首页",
      "iconPath": "/images/tabs/home.png",
      "selectedIconPath": "/images/tabs/home-active.png"
    },{
      "pagePath": "pages/message/message",
      "text": "消息",
      "iconPath": "/images/tabs/message.png",
      "selectedIconPath": "/images/tabs/message-active.png"
    },{
      "pagePath": "pages/contact/contact",
      "text": "联系我们",
      "iconPath": "/images/tabs/contact.png",
      "selectedIconPath": "/images/tabs/contact-active.png"
    }]
},
相关推荐
李纲明3 分钟前
微信小程序开了 Skyline 后样式全乱、滚动对不上甚至部分组件不能用?Skyline 怎么接才稳
javascript·微信小程序·小程序·devdiy
wx1qq1com2 天前
一桩带几台车:共享租赁桩位配比、取电与结算闭环设计
物联网·微信小程序·小程序
2401_879692512 天前
微信小程序照相与摄像功能实现——chooseImage 与 chooseVideo 详解
微信小程序·小程序·notepad++
李纲明4 天前
微信小程序 getSystemInfo 提示已废弃、屏幕高度算错胶囊还对不齐?getWindowInfo 和 getDeviceInfo 怎么接才稳
javascript·微信小程序·小程序·小程序开发·devdiy
dreams_dream4 天前
微信小程序-使用npm包
微信小程序·小程序·npm
caoliaoerweima4 天前
草料二维码小程序上线活码编辑器:手机上也能编辑活码了
智能手机·小程序·编辑器·草料二维码
dreams_dream6 天前
微信小程序:页面事件-上拉触底
微信小程序·小程序
wafrdggh7 天前
2026电商快递批量查询怎么用?固乔助手模板设置评测
大数据·数据库·小程序
wafrdggh8 天前
2026 商城小程序平台哪个价格合理?把跨境附加成本这个坑算透
大数据·小程序
恩创软件开发10 天前
自助KTV系统管理员续单功能
经验分享·小程序