一个自适应的微信小程序自定义导航栏组件。
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
assets
components/navigationBar
example
CHANGELOG.md
README.md
app.js
app.json
app.wxss
project.config.json

README.md

weapp-navigation-bar

因为小程序原生导航栏的一些限制,比如:不能设置字体大小,ios标题居中而安卓居左,从非首页启动小程序返回首页菜单不明显,屏幕空间不能最大化使用。因此微信开放了小程序自定义导航栏,允许用户最大化的使用屏幕空间。但是自定导航栏不支持只指定某些页面使用,而是全局的,所以也带来了一些适配问题。

本导航栏组件支持

  1. 可根据手机状态栏高度适配。
  2. 可自定义设置包括字体颜色、字体大小、背景颜色、无标题、导航栏是否置顶。
  3. 可自动识别是否首页launch。
  4. 更多请查看组件更新内容

演示

1 自定义导航栏

2 模拟非首页启动小程序

3 设置导航栏跟随页面滚动

4 页面上下滚动指定像素值,切换导航栏的显示或隐藏

使用说明

使用前需要了解小程序自定义组件自定义导航栏。 app.json配置以下属性

"window":{
    "navigationStyle": "custom",
    "backgroundTextStyle":"light",
    "navigationBarBackgroundColor": "#fff",
    "navigationBarTitleText": "自定义导航栏",
    "navigationBarTextStyle":"white"
  }

如果已了解,可直接把组件拷贝到项目里引用,用法可参考example。

额外说明:小程序右上角胶囊颜色,可通过navigationBarTextStyle设置,支持black和white。 为了提高兼容性,建议把所有页面内容写在设置的页面容器里,参考example。

组件自定义方法

toggleShow()/toggleHide()用于切换自定义导航栏的显示/隐藏。

组件自定义属性说明

属性 说明 类型 默认值
title 标题 String none
color 标题字体颜色 String #000000
fontSize 导航栏字体大小,单位rpx、px String 40rpx
background 导航栏背景颜色 String #ffffff
placeholderBg 导航栏占位栏背景色 String transparent
back 是否显示导航栏返回按钮 Boolean false
fixed 导航栏是否fixed定位置顶 Boolean true