NavBar 状态栏
使用指南
在 Taro 文件中引入组件
import { ZoNavBar } from '@lylb/tzo-ui';
组件依赖的样式文件(仅按需引用时需要)
@import '~@lylb/tzo-ui/dist/style/components/nav-bar.scss';
一般用法
import Taro from '@tarojs/taro';import { ZoNavBar } from '@lylb/tzo-ui';export default class Index extends Taro.Component {constructor() {super(...arguments);this.state = {border: false,needPlaceholder: false,showCustom: false,title: '走路打卡',};}static config = {navigationStyle: 'custom',};iconClick = (e) => {console.log('点击图标', e);};customDom() {return (<View className="custom_con"><Image src={logo} mode="scaleToFill"></Image></View>);}render () {const {border,needPlaceholder,title}return (<ZoNavBarborder={border}needPlaceholder={needPlaceholder}onClick={this.iconClick}title={title}>{showCustom && this.customDom()}</ZoNavBar>)}}
左上角图标点击事件逻辑说明
事件逻辑判断按照以下顺序执行!
- 当
showLeftIcon(是否显示图标)为false- 左上角无反应
- 当
defaultIconEvent(是否触发图标默认点击事件)为false- 当
onClick函数存在 --- 执行onClick事件 - 当
onClick函数不存在--- 图标点击无反应
- 当
- 当页面历史栈有上一页(表明能返回)
backPagePath设置 --- 跳转路径backPagePathbackPagePath为空--- 默认点击返回上一页
- 当页面历史栈
没有上一页(只能返回首页)homePagePath设置 --- 跳转路径homePagePathhomePagePath为默认值--- 返回/pages/index/index(页面如果不存在则点击无反应)
特殊场景需求说明
1. 不论是home图标还是返回图标点击全部返回特定路径
例如特定路径为 /pages/index/index
配置方法:
- 设置
backPagePath和homePagePath都设置成/pages/index/index
2. 始终显示返回图标并且点击全部返回特定路径
例如特定路径为 /pages/index/index
配置方法:
方法一:
- 设置
alwaysShowBack为true - 设置
backPagePath和homePagePath都设置成/pages/index/index
方法二:
- 设置
alwaysShowBack为true - 设置
defaultIconEvent为false - 绑定
onClick点击事件- 自行处理跳转特定页面
onclick={() => {Taro.redirectTo({url:/pages/index/index})}}
- 自行处理跳转特定页面
3. 始终显示返回图标并且遵循原逻辑
配置方法:
- 设置
alwaysShowBack为true
最终呈现:
- 有上一页和无上一页都显示
返回图标 - 有上一页
- 点击返回上一页
- 无上一页
- 点击返回
homePagePath路径页
- 点击返回
参数
参数注意事项
homePagePath请根据项目自行配置,默认值仅做参考!!!
customIcon参数Taro3有效!!!
| 参数 | 说明 | 类型 | 可选值 | 默认值 |
|---|---|---|---|---|
| title | 标题名称 | Array | - | - |
| border | 是否显示下划线 | Boolean | - | - |
| className | 自定义 className | String | - | - |
| customStyle | 自定义样式 | Object | - | - |
| titleStyle | 标题自定义样式 | Object | - | - |
| showLeftIcon | 是否显示左侧图标 | Boolean | - | - |
| alwaysShowBack | 始终显示返回按钮 | Boolean | - | - |
| backPagePath | 返回页面路径 | String | - | - |
| homePagePath | 首页路径 | String | 自行配置 | /pages/index/index(仅参考) |
| customIcon(Taro3有效) | 自定义图标 | JSX.Element | - | - |
| defaultIconEvent | 是否触发图标默认点击事件 | Boolean | - | - |
| needPlaceholder | 是否需要占位区域 | Boolean | - | true |
0.0.4 版本新增属性
事件
| 事件名称 | 说明 | 返回参数 |
|---|---|---|
| onClick | 点击的回调函数 | event |