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

目录

前言

全局配置文件

一、window

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

2. window 节点常用的配置项

3. 设置导航栏的标题 

4. 设置导航栏的背景色

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

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

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

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

9. 设置上拉触底的距离

二、tabBar

1. 什么是 tabBar

2. tabBar 的 6 个组成部分

 3. tabBar 节点的配置项

4. 每个 tab 项的配置选项

 案例:配置 tabBar

 页面配置

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

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


前言

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

全局配置文件

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

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

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

一、window

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

微信小程序-----全局配置与页面配置_第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

  "window": {
    "navigationBarTextStyle": "black",
    "navigationBarTitleText": "kunkun",
    "navigationBarBackgroundColor": "#fff"
  },

需求:把导航栏上的标题,从默认的 “WeChat”修改为“kunkun”,效果如图所示:

微信小程序-----全局配置与页面配置_第2张图片

微信小程序-----全局配置与页面配置_第3张图片

4. 设置导航栏的背景色

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

  "window": {
    "navigationBarTextStyle": "black",
    "navigationBarTitleText": "kunkun",
    "navigationBarBackgroundColor": "#2b4b6b"
  },

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

微信小程序-----全局配置与页面配置_第4张图片

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

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

 "window": {
    "navigationBarTextStyle": "white",
    "navigationBarTitleText": "kunkun",
    "navigationBarBackgroundColor": "#2b4b6b"
  },

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

微信小程序-----全局配置与页面配置_第5张图片

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

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

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

  "window": {
    "navigationBarTextStyle": "white",
    "navigationBarTitleText": "kunkun",
    "navigationBarBackgroundColor": "#2b4b6b",
    "enablePullDownRefresh":true
  },

微信小程序-----全局配置与页面配置_第6张图片

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

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

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

 "window": {
    "navigationBarTextStyle": "white",
    "navigationBarTitleText": "kunkun",
    "navigationBarBackgroundColor": "#2b4b6b",
    "enablePullDownRefresh": true,
    "backgroundColor": "#efefef"
  },

微信小程序-----全局配置与页面配置_第7张图片

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

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

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

微信小程序-----全局配置与页面配置_第8张图片

                         注意: backgroundTextStyle 的可选值只有 light dark

9. 设置上拉触底的距离

概念:上拉触底是移动端的专有名词,通过手指在屏幕上的上拉滑动操作,从而加载更多数据的行为。

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

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

二、tabBar

1. 什么是 tabBar

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

  • 底部 tabBar
  • 顶部 tabBar

微信小程序-----全局配置与页面配置_第9张图片

注意:

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

2. tabBar 6 个组成部分

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

微信小程序-----全局配置与页面配置_第10张图片

 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 的是默认图标

        截图如下:

微信小程序-----全局配置与页面配置_第11张图片

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

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

微信小程序-----全局配置与页面配置_第12张图片

步骤3 - 配置 tabBar 选项

打开 app.json 配置文件,和 pages window 平级,新增 tabBar 节点
tabBar 节点中,新增 list 数组 ,这个数组中存放的,是每个 tab 项的配置对象
list 数组中, 新增每一个 tab 项的配置对象 。对象中包含的属性如下:
  •  pagePath 指定当前 tab 对应的页面路径必填
  •  text 指定当前 tab 上按钮的文字必填
  •  iconPath 指定当前 tab 未选中时候的图片路径可选
  •  selectedIconPath 指定当前 tab 被选中后高亮的图片路径可选

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

{
  "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"
}

这里我们就有三个界面,效果展示: 

微信小程序-----全局配置与页面配置_第13张图片

 页面配置

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

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

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

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

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

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

{
  "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)

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

分享一张壁纸:

你可能感兴趣的:(微信小程序,微信小程序,小程序,javascript,微信开放平台,微信,json)