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 (
<ZoNavBar
border={border}
needPlaceholder={needPlaceholder}
onClick={this.iconClick}
title={title}
>
{showCustom && this.customDom()}
</ZoNavBar>
)
}
}

左上角图标点击事件逻辑说明

事件逻辑判断按照以下顺序执行!

  • showLeftIcon(是否显示图标)为false
    • 左上角无反应
  • defaultIconEvent(是否触发图标默认点击事件)为false
    • onClick函数存在 --- 执行 onClick事件
    • onClick函数不存在 --- 图标点击无反应
  • 当页面历史栈有上一页(表明能返回)
    • backPagePath设置 --- 跳转路径backPagePath
    • backPagePath --- 默认点击返回上一页
  • 当页面历史栈没有上一页(只能返回首页)
    • homePagePath设置 --- 跳转路径homePagePath
    • homePagePath默认值 --- 返回/pages/index/index(页面如果不存在则点击无反应)

特殊场景需求说明

1. 不论是home图标还是返回图标点击全部返回特定路径

例如特定路径为 /pages/index/index

配置方法:

  • 设置backPagePathhomePagePath都设置成/pages/index/index

2. 始终显示返回图标并且点击全部返回特定路径

例如特定路径为 /pages/index/index

配置方法:

方法一:

  • 设置alwaysShowBacktrue
  • 设置backPagePathhomePagePath都设置成/pages/index/index

方法二:

  • 设置alwaysShowBacktrue
  • 设置defaultIconEventfalse
  • 绑定onClick点击事件
    • 自行处理跳转特定页面onclick={() => {Taro.redirectTo({url:/pages/index/index})}}

3. 始终显示返回图标并且遵循原逻辑

配置方法:

  • 设置alwaysShowBacktrue

最终呈现:

  • 有上一页和无上一页都显示返回图标
  • 有上一页
    • 点击返回上一页
  • 无上一页
    • 点击返回homePagePath路径页

参数

参数注意事项

homePagePath请根据项目自行配置,默认值仅做参考!!!

customIcon参数Taro3有效!!!

参数说明类型可选值默认值
title标题名称Array--
border是否显示下划线Boolean--
className自定义 classNameString--
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 版本新增属性

参数说明类型可选值默认值
backIconImg返回图标自定义图片String-默认图标
homeIconImg返回首页自定义图片String-默认图标

事件

事件名称说明返回参数
onClick点击的回调函数event
TZo UI10:24