Sidebar 侧边导航

引入

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

基础用法

通过 绑定当前选中项的索引。

  1. <van-sidebar v-model="active">
  2. <van-sidebar-item title="标签名称" />
  3. <van-sidebar-item title="标签名称" />
  4. <van-sidebar-item title="标签名称" />
  5. </van-sidebar>

徽标提示

  1. <van-sidebar-item title="标签名称" badge="5" />
  2. <van-sidebar-item title="标签名称" />
  3. </van-sidebar>

通过 disabled 属性禁用选项。

监听切换事件

设置 change 方法来监听切换导航项时的事件。

  1. <van-sidebar v-model="active" @change="onChange">
  2. <van-sidebar-item title="标签名 1" />
  3. <van-sidebar-item title="标签名 2" />
  4. </van-sidebar>

Sidebar Props

Sidebar Events

事件名说明回调参数
change切换导航项时触发index: number

SidebarItem Events

事件名说明回调参数
click点击时触发index: number

SidebarItem Slots

类型定义

  1. import type { SidebarProps, SidebarItemProps } from 'vant';

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

名称默认值描述
—van-sidebar-width80px-
—van-sidebar-font-sizevar(—van-font-size-md)-
—van-sidebar-line-heightvar(—van-line-height-md)-
—van-sidebar-text-colorvar(—van-text-color)-
—van-sidebar-disabled-text-colorvar(—van-text-color-3)-
—van-sidebar-padding20px var(—van-padding-sm)-
—van-sidebar-active-colorvar(—van-active-color)-
—van-sidebar-backgroundvar(—van-background)-
—van-sidebar-selected-font-weightvar(—van-font-bold)-
—van-sidebar-selected-text-colorvar(—van-text-color)-
—van-sidebar-selected-border-width4px-
—van-sidebar-selected-border-height16px-
—van-sidebar-selected-border-colorvar(—van-primary-color)-
—van-sidebar-selected-backgroundvar(—van-background-2)-