NavBar 导航栏

引入

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

代码演示

基础用法

  1. <van-nav-bar
  2. title="标题"
  3. left-text="返回"
  4. right-text="按钮"
  5. left-arrow
  6. @click-left="onClickLeft"
  7. @click-right="onClickRight"
  8. />
  1. import { Toast } from 'vant';
  2. export default {
  3. methods: {
  4. onClickLeft() {
  5. Toast('返回');
  6. },
  7. onClickRight() {
  8. Toast('按钮');
  9. },
  10. },
  11. };

使用插槽

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

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

API

Props

参数说明类型默认值
title标题string‘’
left-text左侧文案string‘’
right-text右侧文案string‘’
left-arrow是否显示左侧箭头booleanfalse
border是否显示下边框booleantrue
fixed是否固定在顶部booleanfalse
placeholder v2.5.9固定在顶部时,是否在标签位置生成一个等高的占位元素booleanfalse
z-index导航栏 z-indexnumber | string1
safe-area-inset-top v2.10.13是否开启顶部安全区适配booleanfalse

Slots

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

Events

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

样式变量

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

名称默认值描述
@nav-bar-height46px-
@nav-bar-background-color@white-
@nav-bar-arrow-size16px-
@nav-bar-icon-color@blue-
@nav-bar-text-color@blue-
@nav-bar-title-font-size@font-size-lg-
@nav-bar-title-text-color@text-color-
@nav-bar-z-index1-

NavBar 导航栏 - 图1