NavBar 导航栏

介绍

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

引入

通过以下方式来全局注册组件，更多注册方式请参考组件注册。

import { createApp } from 'vue';
import { NavBar } from 'vant';
const app = createApp();
app.use(NavBar);

代码演示

基础用法

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

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

返回上级

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

<van-nav-bar
  title="标题"
  left-text="返回"
  left-arrow
  @click-left="onClickLeft"
/>

export default {
  setup() {
    const onClickLeft = () => history.back();
    return {
      onClickLeft,
    };
  },
};

右侧按钮

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

<van-nav-bar
  title="标题"
  left-text="返回"
  right-text="按钮"
  left-arrow
  @click-left="onClickLeft"
  @click-right="onClickRight"
/>

import { Toast } from 'vant';
export default {
  setup() {
    const onClickLeft = () => history.back();
    const onClickRight = () => Toast('按钮');
    return {
      onClickLeft,
      onClickRight,
    };
  },
};

使用插槽

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

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

API

Props

Slots

Events

类型定义

组件导出以下类型定义：

import type { NavBarProps } from 'vant';

主题定制

样式变量

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