阅读(4905) (0)

Vant3 NavBar 导航栏

2021-08-11 09:44:43 更新

介绍

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

实例演示

引入

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

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>

API

Props

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

Slots

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

Events

事件名 说明 回调参数
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 -