微信小程序全局配置及常用配置项详解

一、window常用配置

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

① pages

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

② window

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

③ tabBar

设置小程序底部的tabBar效果

④ style

是否启用新版的组件样式

2.window常用配置项

3.设置导航栏的标题

设置步骤:app.json->window->navigationBarTitleText 修改保存即可,导航栏背景颜色修改只支持十六进制。

注意:navigationBarTextStyle的可选值只支持black和white。

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

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

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

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

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

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

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

7.设置上拉触底的距离

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

设置步骤: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节点配置项

每个tab项的配置选项

window节点平级定义tabBar节点:

"tabBar": {
    "list": [
      {
        // 定义的页面路径
        "pagePath": "pages/list/list",
        "text": "首页"
      },
      {
        "pagePath": "pages/test/test",
        "text": "我的"
      }
    ]
  },

注意:tabPage页面的组件要放到pages节点内部最前面,否则页面没效果。

三、页面配置文件

1.页面配置文件的作用

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

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

小程序中,app.json中的window节点,可以全局配置小程序中每个页面的窗口表现。如果某些小程序页面想要拥有特殊的窗口表现,此时,页面的.json配置文件就可以实现这种需求。

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

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

作者:未及545 原文地址:https://blog.csdn.net/qq_72760247/article/details/128094570

%s 个评论

要回复文章请先登录注册