NavBar 导航栏

介绍

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

引入

app.jsonindex.json中引入组件,详细介绍见快速上手

  1. "usingComponents": {
  2. "van-nav-bar": "@vant/weapp/nav-bar/index"
  3. }

代码演示

基础用法

  1. <van-nav-bar
  2. title="标题"
  3. left-text="返回"
  4. right-text="按钮"
  5. left-arrow
  6. bind:click-left="onClickLeft"
  7. bind:click-right="onClickRight"
  8. />
  1. Page({
  2. onClickLeft() {
  3. wx.showToast({ title: '点击返回', icon: 'none' });
  4. },
  5. onClickRight() {
  6. wx.showToast({ title: '点击按钮', icon: 'none' });
  7. },
  8. });

高级用法

通过 slot 定制内容。

  1. <van-nav-bar title="标题" left-text="返回" left-arrow>
  2. <van-icon name="search" slot="right" />
  3. </van-nav-bar>

API

Props

参数说明类型默认值
title标题string‘’
left-text左侧文案string‘’
right-text右侧文案string‘’
left-arrow是否显示左侧箭头booleanfalse
fixed是否固定在顶部booleanfalse
placeholder固定在顶部时是否开启占位booleanfalse
border是否显示下边框booleantrue
z-index元素 z-indexnumber1
custom-style根节点自定义样式string-
safe-area-inset-top是否留出顶部安全距离(状态栏高度)booleantrue

Slot

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

Events

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

外部样式类

类名说明
custom-class根节点样式类
title-class标题样式类

NavBar 导航栏 - 图1