微信小程序-----全局配置与页面配置

灰勒塔德2024-01-17 17:51

目录

前言

全局配置文件

一、window

[1. 小程序窗口的组成部分](#1. 小程序窗口的组成部分)

[2. window 节点常用的配置项](#2. window 节点常用的配置项)

[3. 设置导航栏的标题](#3. 设置导航栏的标题)

[4. 设置导航栏的背景色](#4. 设置导航栏的背景色)

[5. 设置导航栏的标题颜色](#5. 设置导航栏的标题颜色)

[6. 全局开启下拉刷新功能](#6. 全局开启下拉刷新功能)

[7. 设置下拉刷新时窗口的背景色](#7. 设置下拉刷新时窗口的背景色)

[8. 设置下拉刷新时 loading 的样式](#8. 设置下拉刷新时 loading 的样式)

[9. 设置上拉触底的距离](#9. 设置上拉触底的距离)

二、tabBar

[1. 什么是 tabBar](#1. 什么是 tabBar)

[2. tabBar 的 6 个组成部分](#2. tabBar 的 6 个组成部分)

[3. tabBar 节点的配置项](#3. tabBar 节点的配置项)

[4. 每个 tab 项的配置选项](#4. 每个 tab 项的配置选项)

[案例：配置 tabBar](#案例：配置 tabBar)

页面配置

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

[2. 页面配置中常用的配置项](#2. 页面配置中常用的配置项)

前言

今天我们开始学习微信小程序中的全局配置，前面对微信小程序文件介绍的时候讲到过.json文件的基本作用和内容，那么本期的主角是.json文件，这个是作为微信小程序的全局配置文件，通过这个文件我们可以对微信小程序进行全局性的管理。

全局配置文件

小程序根目录下的 app.json 文件是小程序的全局配置文件。常用的配置项如下：
① pages
记录当前小程序所有页面的存放路径
② window
全局设置小程序窗口的外观
③ tabBar
设置小程序底部的 tabBar 效果
④ style
是否启用新版的组件样式

前面我们对pages属性有了详细的介绍，那本期这里就不做讲解（相关链接：微信小程序-----账号注册以及开发软件的下载与代码结构介绍-CSDN博客）

一、window

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

2.window节点常用的配置项

|------------------------------|----------|---------|---------------------------------|
| 属性名 | 类型 | 默认值 | 说明 |
| navigationBarTitleText | String | 字符串 | 导航栏标题文字内容 |
| navigationBarBackgroundColor | HexColor | #000000 | 导航栏背景颜色，如 #000000 |
| navigationBarTextStyle | String | white | 导航栏标题颜色，仅支持 black / white |
| backgroundColor | HexColor | #ffffff | 窗口的背景色 |
| backgroundTextStyle | String | dark | 下拉 loading 的样式，仅支持 dark / light |
| enablePullDownRefresh | Boolean | false | 是否全局开启下拉刷新 |
| onReachBottomDistance | Number | 50 | 页面上拉触底事件触发时距页面底部距离，单位为px |

3. 设置导航栏的标题

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

cpp 复制代码 
  "window": {
    "navigationBarTextStyle": "black",
    "navigationBarTitleText": "kunkun",
    "navigationBarBackgroundColor": "#fff"
  },

需求：把导航栏上的标题，从默认的 "WeChat"修改为"kunkun"，效果如图所示：

4. 设置导航栏的背景色

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

cpp 复制代码 
  "window": {
    "navigationBarTextStyle": "black",
    "navigationBarTitleText": "kunkun",
    "navigationBarBackgroundColor": "#2b4b6b"
  },

需求：把导航栏标题的背景色，从默认的 #fff 修改为 #2b4b6b ，效果如图所示：

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

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

cpp 复制代码 
 "window": {
    "navigationBarTextStyle": "white",
    "navigationBarTitleText": "kunkun",
    "navigationBarBackgroundColor": "#2b4b6b"
  },

需求：把导航栏上的标题颜色，从默认的 black 修改为 white ，效果如图所示：

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

概念：下拉刷新是移动端的专有名词，指的是通过手指在屏幕上的下拉滑动操作，从而重新加载页面数据的行为。

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

cpp 复制代码 
  "window": {
    "navigationBarTextStyle": "white",
    "navigationBarTitleText": "kunkun",
    "navigationBarBackgroundColor": "#2b4b6b",
    "enablePullDownRefresh":true
  },

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

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

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

cpp 复制代码 
 "window": {
    "navigationBarTextStyle": "white",
    "navigationBarTitleText": "kunkun",
    "navigationBarBackgroundColor": "#2b4b6b",
    "enablePullDownRefresh": true,
    "backgroundColor": "#efefef"
  },

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

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

cpp 复制代码 
  "window": {
    "navigationBarTextStyle": "white",
    "navigationBarTitleText": "kunkun",
    "navigationBarBackgroundColor": "#2b4b6b",
    "enablePullDownRefresh": true,
    "backgroundColor": "#efefef",
    "backgroundTextStyle":"dark"
  },

注意： backgroundTextStyle 的可选值只有 light 和 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****项的配置选项

|------------------|--------|--------|--------------------------------------|
| 属性 | 类型 | 必填 | 描述 |
| pagePath | String | 是 | 页面路径，页面必须在 pages 中预先定义 |
| text | String | 是 | tab 上显示的文字 |
| iconPath | String | 否 | 未选中时的图标路径；当 postion 为 top 时，不显示 icon |
| selectedIconPath | String | 否 | 选中时的图标路径；当 postion 为 top 时，不显示 icon |

案例：配置 tabBar

**步骤****1 -**拷贝图标资源
① 把资料目录中的 images 文件夹， 拷贝到小程序项目根目录中
② 将需要用到的小图标分为 3 组，每组两个，其中：

  • 图片名称中包含 -active 的是选中之后的图标
  • 图片名称中不包含 -active 的是默认图标

截图如下：

步骤2 -新建3个对应的tab页面

通过 app.json 文件的 pages 节点，快速新建 3 个对应的 tab 页面，示例代码如下：

步骤3 -配置tabBar选项

① 打开 app.json 配置文件，和 pages 、 window 平级，新增 tabBar 节点
② tabBar 节点中，新增 list 数组 ，这个数组中存放的，是每个 tab 项的配置对象
③ 在 list 数组中， 新增每一个 tab 项的配置对象 。对象中包含的属性如下：

  • pagePath 指定当前 tab 对应的页面路径【必填】
  • text 指定当前 tab 上按钮的文字【必填】
  • iconPath 指定当前 tab 未选中时候的图片路径【可选】
  • selectedIconPath 指定当前 tab 被选中后高亮的图片路径【可选】

app.json文件完整配置样式如下：

cpp 复制代码 
{
  "pages": [
    "pages/test/test",
    "pages/index/index",
    "pages/logs/logs"
  ],
  "window": {
    "navigationBarTextStyle": "white",
    "navigationBarTitleText": "kunkun",
    "navigationBarBackgroundColor": "#2b4b6b",
    "enablePullDownRefresh": true,
    "backgroundColor": "#efefef",
    "backgroundTextStyle":"dark"
  },
 
  "tabBar": {
    "list": [
      {
        "pagePath": "pages/test/test",
        "text": "home",
        "iconPath": "/image/home.png",
        "selectedIconPath": "/image/home-active.png"
      },
      {
        "pagePath": "pages/index/index",
        "text": "msg",
        "iconPath": "/image/message.png",
        "selectedIconPath": "/image/message-active.png"
      },
      {
        "pagePath": "pages/logs/logs",
        "text": "logs",
        "iconPath": "/image/contact.png",
        "selectedIconPath": "/image/contact-active.png"
      }
    ]
  },

  "style": "v2",
  "componentFramework": "glass-easel",
  "sitemapLocation": "sitemap.json",
  "lazyCodeLoading": "requiredComponents"
}

这里我们就有三个界面，效果展示：

页面配置

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

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

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

如果某些小程序页面想要拥有特殊的窗口表现，此时，"页面级别的 .json 配置文件"就可以实现这种需求。

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

这里，我们在test.json文件添加以下样式：

cpp 复制代码 
{
  "usingComponents": {
  },
  "navigationBarBackgroundColor": "#ff0000"
}

效果展示如下：

1705415544313

可以看出在上面全局配置的基础上，我修改了其中一个的页面配置，那么效果就会覆盖掉全局配置。

**2.**页面配置中常用的配置项

页面配置项跟上面全局配置的配置项是一样的，如下表所示：

|------------------------------|----------|---------|-------------------------------------|
| 属性 | 类型 | 默认值 | 描述 |
| navigationBarBackgroundColor | HexColor | #000000 | 当前页面导航栏背景颜色，如 #000000 |
| navigationBarTextStyle | String | white | 当前页面导航栏标题颜色，仅支持 black / white |
| navigationBarTitleText | String | | 当前页面导航栏标题文字内容 |
| backgroundColor | HexColor | #ffffff | 当前页面窗口的背景色 |
| backgroundTextStyle | String | dark | 当前页面下拉 loading 的样式，仅支持 dark / light |
| enablePullDownRefresh | Boolean | false | 是否为当前页面开启下拉刷新的效果 |
| onReachBottomDistance | Number | 50 | 页面上拉触底事件触发时距页面底部距离，单位为 px |

想要获取更多的学习资源，可以点击以下链接查看。 黑马程序员web前端视频教程从入门到精通Web前端视频教程完整版_Web前端视频教程从入门到精通_黑马程序员 (itheima.com)

以上就是本期的全部内容了，我们下次见！

分享一张壁纸：

相关推荐
CodeClimb6 分钟前
【华为OD-E卷-木板 100分（python、java、c++、js、c）】
java·javascript·c++·python·华为od
咸鱼翻面儿10 分钟前
Javascript异步，这次我真弄懂了！！！
javascript
qq_5895681043 分钟前
Echarts的高级使用，动画，交互api
前端·javascript·echarts
dingdingfish1 小时前
JSON 系列之1：将 JSON 数据存储在 Oracle 数据库中
oracle·json·database
暴富的Tdy2 小时前
【CryptoJS库AES加密】
前端·javascript·vue.js
℘团子এ2 小时前
js和html中，将Excel文件渲染在页面上
javascript·html·excel
三木吧2 小时前
开发微信小程序的过程与心得
人工智能·微信小程序·小程序
Kika写代码2 小时前
【微信小程序】3|首页搜索框 | 我的咖啡店-综合实训
微信小程序·小程序
金金金__2 小时前
微信小程序：解决顶部被遮挡的问题
微信小程序·小程序
热门推荐
01【一文读懂】NTN（非地面网络）技术介绍02优化手机性能，解决卡顿问题：关闭这3个微信开关，释放内存空间03玄机平台应急响应—webshell查杀04Cube-Studio：开源大模型全链路一站式中台05基于大语言模型（LLM）的合成数据生成、策展和评估的综述06(欧拉)openEuler系统添加网卡文件配置流程、(欧拉)openEuler系统手动配置ipv6地址流程、(欧拉)openEuler系统网络管理说明07组基轨迹建模 GBTM的介绍与实现（Stata 或 R）08HCIA-datacom数通题库和录播视频资料09Docker 夺命连环 15 问10RAG 实践- Ollama+RagFlow 部署本地知识库