在小程序中,有的页面需求可能需要我们做一个自定义的导航栏, 今天就来踩一踩坑
首先需要在app.js 中给全局的导航栏隐藏,
1 // app.js 2 3 window: { 4 navigationStyle: 'custom', 5 }, 6 // navigationStyle 接受两个参数 ['default', 'custom']: ['系统导航栏, 默认值', '隐藏系统导航栏']
这里隐藏掉默认的导航栏之后 可以通过自定义组件的形式,DIY 一个导航栏, 值得注意的是, 当隐藏系统导航栏后, 页面会直接顶到状态栏上, 不同机型的状高度可能不一致, 尤其是针对 苹果X 的刘海屏等 水滴屏, 需要做适配,
解决方法: Taro.getSystemInfo 中 有个属性叫做 statusBarHeight , 通过此方法即可获取手机状态栏的高度, 也可以在 未隐藏系统导航栏时 通过 getSystemInfo 中的 可视区域高度 screenHeight - 窗口高度 windowHeight - 状态栏高度 statusBarHeight 的差值结果得出 系统导航栏的高度, 这里我通过仅拿苹果手机的不同机型进行测试得出 系统导航栏高度为 44px , 便直接把 自定义导航的高度定为 44px (有兴趣的可以试试)
还有知道主要一点的是 隐藏系统导航栏后 右上角胶囊状的按钮 还是后保留在原始位置的
1 // app.js 2 3 Taro.getSystemInfo({}) 4 .then(res => { 5 Taro.$navBarMarginTop = res.statusBarHeight || 0 6 }) 7 // 将状态栏高度挂载全局
这里的写法很多 可以申明在 app.js 中, 也可以放在 redux中 等等 ,
接下来自定义 导航栏 Navbar
1 // src/components/Navbar/index 2 3 import Taro from '@tarojs/taro' 4 import { View } from '@tarojs/components' 5 import './index.scss' 6 class Navbar extends Taro.Component { 7 8 render() { 9 const style = { 10 paddingTop: Taro.$navBarMarginTop + 'px' 11 } 12 // 将状态栏的区域空余出来 13 return ( 14 <View className='navbarWrap' style={style}> 15 <View className='navbar'>自定义导航栏</View> 16 </View> 17 ); 18 } 19 } 20 export default Navbar 21 22 // 这里导航栏内容可以自行配置
然后就是在页面中使用 自定义导航栏
页面中使用方法有两种, 一种是常规的import 组件, taro 中给我们提供了第二种方式
1 // index/index.js 首页 2 3 import NavBar from '../../components/Navbar/index' 4 5 class Index extends Component { 6 config = { 7 navigationBarTitleText: '首页', 8 usingComponents: { 9 'navbar': '../../components/Navbar/index', // 书写第三方组件的相对路径 10 }, 11 } 12 render () { 13 return ( 14 <View className='index'> 15 <NavBar /> 16 { /* 方法一 */ } 17 <navbar /> 18 { /* 方法一二 */ } 19 20 </View> 21 ) 22 } 23 } 24 25 export default Index
所幸的是方法二中同样支持 懒人路径写法, 具体工作中可自行选择自己喜欢的写法 这里就不做演示,
如果在开发中遇到了 jsEnginScriptError Component is not found in path 类似的报错,请首先确定自己路径的是否正确引用以及大小写是否有问题,
没问题的话 , 重新 yarn dev:weapp 即可