您的当前位置:首页正文

微信小程序--8(全局配置)

2024-12-01 来源:个人技术集锦


一、概念

二、window

(一) 小程序窗口组成

(二) window节点的常用配置项

属性名类型默认值说明
navigationBarTitleTextString字符串导航栏标题文字内容
navigationBarBackgroundColorHexColor#000000导航栏背景颜色
navigationBarTextStyleStringwhite导航栏标题颜色,只能是black/white
backgroundColorHexColor#ffffff窗口背景色
backgroundTextStyleStringdark下拉loading的样式,仅支持dark/light
enablePullDownRefreshBooleanfalse是否全局开启下拉刷新
onReachBottomDistanceNumber50px页面上拉触底事件触发时距离页面底部的距离

1、设置导航栏标题

步骤:app.json---window---navgitionBarTitleText

示例:

2、设置导航栏的背景色

步骤:app.json--window---navigationBarBackgroundColor

示例:

注意:只支持十六进制的颜色

3、设置导航栏的标题颜色

步骤:app.json--window---navigationBarTextStyle

示例:

注意:颜色只能是black/white

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

概念:指通过手指下拉滑动,使页面重新加载的操作。

步骤:app.json--window---enablePullDownRefresh(值设为true)

示例:

注意:在app.json里面开启的下拉刷新功能,是作用于每个页面的。

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

当全局开启下拉刷新功能之后,默认的窗口的背景色为白色。

修改背景颜色步骤:app.json--window---backgroundColor

示例:

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

默认loading的颜色为白色,若要更改

步骤:app.json--window---backgroundTextStyle

示例:

注意:仅支持dark/light

7、设置上拉触底的距离

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

步骤:app.json--window---onReachBottomDistance

示例:

注意:页面上拉触底事件触发时距离页面底部的距离默认50px,建议没有特殊需求,无需修改。

(三)tabBar

1、概念:是移动端应用常见的页面效果,用于实现多页面的快速切换。

2、分类:

  • 底部tabBar
  • 顶部tabBar

3、注意:

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

4、组成部分

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

5、tarBar的配置项

属性类型必填默认值描述
positionStringbottomtabBar的位置,仅支持bottom/top
borderStyleStringblacktabBar上边框的颜色,仅支持black/white
selectedColorHexColor文字选中时的颜色
colorHexColor文字默认颜色
backgroundColorHexColor背景色
listArray页签的列表,少2个,最多5个

6、每个tab项的配置选项

属性类型必填描述
pagePathString

页面路径,页面必须在pages中预先定义

textStringtab上显示的文字
iconPathString未选中的图标路径,当position为top时,不显示icon
selectedconPathString选中的图标路径,当position为top时,不显示icon

示例:

显示全文