/Taro-navigation-bar

微信小程序自定义导航栏组件,navigation,完美适配全部手机

Primary LanguageJavaScript

小程序组件 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 和使用方式.

属性列表

属性 类型 默认值 必填 说明
ext-class string 添加在组件内部结构的 class,可用于修改组件内部的样式
title string 导航标题,如果不提供,则名为 renderCenter 的 slot 有效
background string #ffffff 导航背景色
backgroundColorTop string background 导航下拉背景色,默认取 background 的颜色,不理解见 issue 问题
color string #000000 导航字体颜色
iconTheme string black 主题图标和字体颜色,当背景色为深色时,可以设置'white'
back boolean false 是否显示返回按钮,默认点击按钮会执行 navigateBack,如果为 false,则名为 renderLeft 的 slot 有效
home boolean false 是否显示 home 按钮,执行方法自定义,或者看例子
searchBar boolean false 是否显示搜索框,默认点击按钮会执行 onSearch,如果为 false,则名为 renderCenter 的 slot 有效
searchText string 点我搜索 搜索框文字
onHome eventhandler 在 home 为 true 时,点击 home 按钮触发此事件
onBack venthandler 在 back 为 true 时,点击 back 按钮触发此事件,detail 包含 delta
onSearch eventhandler 在 searchBar 为 true 时,点击 search 按钮触发此事件

Slot

名称 描述
renderLeft 左侧 slot,在 back 按钮位置显示,当 back 为 false 的时候有效
renderCenter 标题 slot,在标题位置显示,当 searchBar 为 false title 为空的时候有效
renderRight 在导航的右侧显示

注意

  • 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✨✨ 谢谢 ~

测试信息

手机型号 胶囊位置信息 statusBarHeight 测试情况
iPhoneX 80 32 281 369 48 88 44 通过
iPhone8 plus 56 32 320 408 24 88 20 通过
iphone7 56 32 281 368 24 87 20 通过
iPhone6 plus 56 32 320 408 24 88 20 通过
iPhone6 56 32 281 368 24 87 20 通过
HUAWEI SLA-AL00 64 32 254 350 32 96 24 通过
HUAWEI VTR-AL00 64 32 254 350 32 96 24 通过
HUAWEI EVA-AL00 64 32 254 350 32 96 24 通过
HUAWEI EML-AL00 68 32 254 350 36 96 29 通过
HUAWEI VOG-AL00 65 32 254 350 33 96 25 通过
HUAWEI ATU-TL10 64 32 254 350 32 96 24 通过
HUAWEI SMARTISAN OS105 64 32 326 422 32 96 24 通过
XIAOMI MI6 59 28 265 352 31 87 23 通过
XIAOMI MI4LTE 60 32 254 350 28 96 20 通过
XIAOMI MIX3 74 32 287 383 42 96 35 通过
REDMI NOTE3 64 32 254 350 32 96 24 通过
REDMI NOTE4 64 32 254 350 32 96 24 通过
REDMI NOTE3 55 28 255 351 27 96 20 通过
REDMI 5plus 67 32 287 383 35 96 28 通过
MEIZU M571C 65 32 254 350 33 96 25 通过
MEIZU M6 NOTE 62 32 254 350 30 96 22 通过
MEIZU MX4 PRO 62 32 278 374 30 96 22 通过
OPPO A33 65 32 254 350 33 96 26 通过
OPPO R11 58 32 254 350 26 96 18 通过
VIVO Y55 64 32 254 350 32 96 24 通过
HONOR BLN-AL20 64 32 254 350 32 96 24 通过
HONOR NEM-AL10 59 28 265 352 31 87 24 通过
HONOR BND-AL10 64 32 254 350 32 96 24 通过
HONOR duk-al20 64 32 254 350 32 96 24 通过
SAMSUNG SM-G9550 64 32 305 401 32 96 24 通过
360 1801-A01 64 32 254 350 32 96 24 通过