小程序组件 navigation-bar

小程序自定义导航栏适配 完美解决内容上下不居中 左右不居中 高度不合适的问题

Navigation

Navigation 是小程序的顶部导航组件，当页面配置 navigationStyle 设置为 custom 的时候可以使用此组件替代原生导航栏

使用

• 下载项目代码

git clone https://github.com/lingxiaoyi/Taro-navigation-bar.git

• 进入目录安装依赖，国内用户推荐使用 cnpm 进行加速

npm i

或者

yarn  i

或借助 cnpm 加速

• 启动本地服务器

npm run dev:weapp # 微信小程序
npm run dev:qq # qq小程序

• 用开发者工具打开代码目录,记得把 appid 改成自己的,或者点击测试号,如果不改就默认是作者的,以防万一不能访问,最好改成自己或测试的.
• 在修改代码或添加新页面之后,工具中页面样式发生错乱,反复查找问题还未解决,建议重启服务和开发工具,有意想不到的效果.

项目中使用

• 进入目录安装依赖，国内用户推荐使用 cnpm 进行加速
• npm 使用方式移步仓库地址

npm install taro-navigationbar --save

• 在代码中 import 并按照文档说明使用

import NavBar from 'taro-navigationbar';

示例代码

<!--WXML示例代码-->
<NavBar
          title='有返回和home'
          background='#fff'
          back
          home
          onBack={this.handlerGobackClick}
          onHome={this.handlerGohomeClick}
        />

更多使用方式请移步仓库地址查看 demo 和使用方式.

属性列表

Slot

注意

• iconTheme 设置为 white 的时候,一定要记得自己去 json 文件设置"navigationBarTextStyle": "white"
• 跳转搜索页面,在 Android 机子会出现文字被键盘弹起顶出 input 框,解决方案是页面设置一个死的高度不要高于 windowHeight - navheight. 例子中是写死 500px,或者可以在 didMount 中通过 JS 计算赋值页面高度.
• input 框文字抖动问题我是借鉴别人写的,可以最大限度减小文字抖动的大小,提升用户体验.
• title searchBar renderCenter 如果全部有内容,是这样的先后显示顺序.
• 默认配置满足不了功能的,请使用 slot 功能,见例子 1 6 7仓库地址
• 由于本人精力有限,只测试了常规的 20 多款手机.如有哪种机型出现问题,请备注机型和小程序版本库.本人会以最快方式解决问题.
• 用法和测试 demo 请 clone 代码仓库地址

后续

• 其他功能,规划中,或者留言联系方式微信 zhijunxh
• 还需要其他样子的例子请留言,如果功能比较重要和主流的话,我会考虑第一时间添加

备注

• iPhone 手机打电话和开热点导致导航栏样式错乱，问题已经解决啦，这里特别感谢 moments 网友提出的问题
• 渐变和动态修改背景色请参考例子 10,ios 机子会出现滚动渐变颜色加载出来不能消失的问题,暂时没想到解决办法,这是微信浏览器渲染的问题,社区里面相关问题地址
• getMenuButtonBoundingClientRect 胶囊按钮信息获取不到或者此方法报错问题已修复 获取菜单报错，需要捕捉异常和兼容版本导航栏渲染不出来

~ 创作不易,如果对你有帮助，请给个星星 star✨✨ 谢谢 ~

测试信息