Taro 小程序 自定义导航栏

时间:2023-03-09 18:19:01
Taro 小程序 自定义导航栏

在小程序中,有的页面需求可能需要我们做一个自定义的导航栏, 今天就来踩一踩坑

首先需要在app.js 中给全局的导航栏隐藏,

 // app.js

 window: {
navigationStyle: 'custom',
},
// navigationStyle 接受两个参数 ['default', 'custom']: ['系统导航栏, 默认值', '隐藏系统导航栏']

这里隐藏掉默认的导航栏之后 可以通过自定义组件的形式,DIY 一个导航栏, 值得注意的是, 当隐藏系统导航栏后, 页面会直接顶到状态栏上, 不同机型的状高度可能不一致, 尤其是针对 苹果X 的刘海屏等 水滴屏, 需要做适配,

解决方法:  Taro.getSystemInfo  中 有个属性叫做  statusBarHeight , 通过此方法即可获取手机状态栏的高度, 也可以在 未隐藏系统导航栏时 通过  getSystemInfo  中的  可视区域高度  screenHeight  - 窗口高度  windowHeight - 状态栏高度  statusBarHeight 的差值结果得出 系统导航栏的高度, 这里我通过仅拿苹果手机的不同机型进行测试得出 系统导航栏高度为 44px , 便直接把 自定义导航的高度定为 44px (有兴趣的可以试试)

还有知道主要一点的是 隐藏系统导航栏后 右上角胶囊状的按钮  还是后保留在原始位置的

 // app.js

 Taro.getSystemInfo({})
.then(res => {
Taro.$navBarMarginTop = res.statusBarHeight || 0
})
// 将状态栏高度挂载全局

这里的写法很多 可以申明在 app.js 中, 也可以放在 redux中 等等 ,

接下来自定义 导航栏 Navbar

 // src/components/Navbar/index

 import Taro from '@tarojs/taro'
import { View } from '@tarojs/components'
import './index.scss'
class Navbar extends Taro.Component { render() {
const style = {
paddingTop: Taro.$navBarMarginTop + 'px'
}
// 将状态栏的区域空余出来
return (
<View className='navbarWrap' style={style}>
<View className='navbar'>自定义导航栏</View>
</View>
);
}
}
export default Navbar // 这里导航栏内容可以自行配置

然后就是在页面中使用 自定义导航栏

页面中使用方法有两种, 一种是常规的import 组件, taro 中给我们提供了第二种方式

 // index/index.js  首页

 import NavBar from '../../components/Navbar/index'

 class Index extends Component {
config = {
navigationBarTitleText: '首页',
usingComponents: {
'navbar': '../../components/Navbar/index', // 书写第三方组件的相对路径
},
}
render () {
return (
<View className='index'>
<NavBar />
{ /* 方法一 */ }
<navbar />
{ /* 方法一二 */ } </View>
)
}
} export default Index

所幸的是方法二中同样支持 懒人路径写法, 具体工作中可自行选择自己喜欢的写法 这里就不做演示,

如果在开发中遇到了  jsEnginScriptError Component is not found in path   类似的报错,请首先确定自己路径的是否正确引用以及大小写是否有问题,

没问题的话 , 重新 yarn dev:weapp  即可