为页面提供导航功能，常用于页面顶部。
通过以下方式来全局注册组件，更多注册方式请参考组件注册。
import { createApp } from 'vue';
import { NavBar } from 'vant';
const app = createApp();
app.use(NavBar); <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 = () => Toast('返回');
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>
| 参数 | 说明 | 类型 | 默认值 |
|---|---|---|---|
| title | 标题 | string |
|
| left-text | 左侧文案 | string |
|
| right-text | 右侧文案 | string |
|
| left-arrow | 是否显示左侧箭头 | boolean |
|
| border | 是否显示下边框 | boolean |
|
| fixed | 是否固定在顶部 | boolean |
|
| placeholder | 固定在顶部时，是否在标签位置生成一个等高的占位元素 | boolean |
|
| z-index | 导航栏 z-index | number | string |
|
| safe-area-inset-top | 是否开启顶部安全区适配 | boolean |
|
| 名称 | 说明 |
|---|---|
| title | 自定义标题 |
| left | 自定义左侧区域内容 |
| right | 自定义右侧区域内容 |
| 事件名 | 说明 | 回调参数 |
|---|---|---|
| click-left | 点击左侧按钮时触发 | event: MouseEvent |
| click-right | 点击右侧按钮时触发 | event: MouseEvent |
组件提供了下列 CSS 变量，可用于自定义样式，使用方法请参考 ConfigProvider 组件。
| 名称 | 默认值 | 描述 |
|---|---|---|
| --van-nav-bar-height | 46px | - |
| --van-nav-bar-background-color | var(--van-white) | - |
| --van-nav-bar-arrow-size | 16px | - |
| --van-nav-bar-icon-color | var(--van-primary-color) | - |
| --van-nav-bar-text-color | var(--van-primary-color) | - |
| --van-nav-bar-title-font-size | var(--van-font-size-lg) | - |
| --van-nav-bar-title-text-color | var(--van-text-color) | - |
| --van-nav-bar-z-index | 1 | - |