NavBar 导航栏

介绍

为页面提供导航功能,常用于页面顶部。

代码演示

基础用法

通过 title 属性设置导航栏标题。

<z-nav-bar title="标题" />

返回上级

在导航栏实现返回上级功能。

<z-nav-bar title="标题" left-text="返回" left-arrow />

右侧按钮

在导航栏右侧添加可点击的按钮。

<z-nav-bar
  title="标题"
  left-text="返回"
  right-text="按钮"
  left-arrow
  @click-right="toast.showToast('按钮')"
/>
import { useToast } from '../../uni_modules/zebra-ui'
const toast = useToast()

使用插槽

可以通过插槽自定义导航栏两侧的内容。

<z-nav-bar title="标题" left-text="返回" left-arrow>
  <template #right>
    <z-icon name="search" size="18" />
  </template>
</z-nav-bar>

禁用按钮

通过 left-disabledright-disabled 属性来禁用两侧的按钮。按钮被禁用时透明度降低,且无法点击。

<z-nav-bar
  title="标题"
  left-text="返回"
  right-text="按钮"
  left-arrow
  left-disabled
  right-disabled
/>

API

Props

参数说明类型默认值
title标题string''
left-text左侧文案string''
right-text右侧文案string''
left-disabled是否禁用左侧按钮,禁用时透明度降低,且无法点击booleanfalse
right-disabled是否禁用右侧按钮,禁用时透明度降低,且无法点击booleanfalse
left-arrow是否显示左侧箭头booleanfalse
border是否显示下边框booleantrue
fixed是否固定在顶部booleanfalse
placeholder固定在顶部时,是否在标签位置生成一个等高的占位元素booleanfalse
z-index导航栏 z-indexnumber | string1
safe-area-inset-top是否开启顶部安全区适配booleanfalse
clickable是否开启两侧按钮的点击反馈booleantrue
autoBack点击后是否自动返回上一页booleantrue

Slots

名称说明
title自定义标题
left自定义左侧区域内容
right自定义右侧区域内容

Events

事件名说明回调参数
click-left点击左侧按钮时触发event: MouseEvent
click-right点击右侧按钮时触发event: MouseEvent

主题定制

样式变量

组件提供了下列 CSS 变量,可用于自定义样式,使用方法请参考 ConfigProvider 组件

名称默认值描述
--z-nav-bar-height92rpx-
--z-nav-bar-backgroundvar(--z-background-2)-
--z-nav-bar-arrow-size32rpx-
--z-nav-bar-icon-colorvar(--z-primary-color)-
--z-nav-bar-text-colorvar(--z-primary-color)-
--z-nav-bar-title-font-sizevar(--z-font-size-lg)-
--z-nav-bar-title-text-colorvar(--z-text-color)-
--z-nav-bar-z-index1-