minapp-navigation-bar
微信小程序在 1.7.0 版本以后支持了自定义导航栏样式,也就是在配置文件中将 navigationStyle
设置为 true
,便可获得只保留右上角胶囊的小程序页面。渐变背景和汉堡导航有了可行性。
本库是小程序自定义导航栏刘海屏通用适配方案,支持所有常规屏和异形屏手机,轻量、扩展性强。
如何使用
-
通过 npm 安装
确保已开启开发者工具中
使用 npm 模块
功能,并已对项目进行npm init
初始化npm install --save minapp-navigation-bar -
构建
在微信开发者工具中依次点击
工具
-构建 npm
-
在页面中配置
page.json
-
在页面中引入
page.wxml
属性
-
os String 标题栏显示样式
可选值
android
,ios
,auto
默认值为
auto
,根据自动确定手机系统注意:使用不支持的值会被作为
android
处理<!-- 即使是 iPhone,也显示为安卓系统样式 -->这是标题<!-- 即使是安卓手机,也显示为 iOS 系统样式 -->这是标题<!-- 安卓手机显示安卓样式,iPhone 显示 iOS 样式 -->这是标题 -
hide-back Boolean 是否隐藏返回按钮
默认值为
false
,即在可返回时显示返回按钮<!-- 页面栈中页面数量大于 1 时显示返回按钮 -->这是标题<!-- 无论页面栈中有多少页面,都不显示返回按钮 -->这是标题
自定义事件
-
grow 当导航栏高度计算完成后触发,用来在 Page 中获得导航栏高度
### 返回值
- height Number 导航栏高度
<!-- 绑定 grow 事件 -->这是标题<!-- 设置 container 的 padding-top 为导航栏的高 -->这里是内容
样式
默认为白底黑字样式,标题字体大小颜色背景等等均可以自定义
版本记录
v0.1.1
实现功能