Sidebar 侧边导航
引入
通过以下方式来全局注册组件,更多注册方式请参考组件注册。
基础用法
通过 绑定当前选中项的索引。
<van-sidebar v-model="active">
<van-sidebar-item title="标签名称" />
<van-sidebar-item title="标签名称" />
<van-sidebar-item title="标签名称" />
</van-sidebar>
徽标提示
<van-sidebar-item title="标签名称" badge="5" />
<van-sidebar-item title="标签名称" badge="20" />
</van-sidebar>
通过 disabled
属性禁用选项。
监听切换事件
设置 change
方法来监听切换导航项时的事件。
<van-sidebar v-model="active" @change="onChange">
<van-sidebar-item title="标签名 1" />
<van-sidebar-item title="标签名 2" />
</van-sidebar>
Sidebar Props
Sidebar Events
事件名 | 说明 | 回调参数 |
---|---|---|
change | 切换导航项时触发 | index: number |
SidebarItem Events
事件名 | 说明 | 回调参数 |
---|---|---|
click | 点击时触发 | index: number |
SidebarItem Slots
类型定义
import type { SidebarProps, SidebarItemProps } from 'vant';
组件提供了下列 CSS 变量,可用于自定义样式,使用方法请参考 。
名称 | 默认值 | 描述 |
---|---|---|
—van-sidebar-width | 80px | - |
—van-sidebar-font-size | var(—van-font-size-md) | - |
—van-sidebar-line-height | var(—van-line-height-md) | - |
—van-sidebar-text-color | var(—van-text-color) | - |
—van-sidebar-disabled-text-color | var(—van-text-color-3) | - |
—van-sidebar-padding | 20px var(—van-padding-sm) | - |
—van-sidebar-active-color | var(—van-active-color) | - |
—van-sidebar-background-color | var(—van-background-color) | - |
—van-sidebar-selected-font-weight | var(—van-font-weight-bold) | - |
—van-sidebar-selected-text-color | var(—van-text-color) | - |
—van-sidebar-selected-border-width | 4px | - |
—van-sidebar-selected-border-height | 16px | - |
—van-sidebar-selected-border-color | var(—van-danger-color) | - |
—van-sidebar-selected-background-color | var(—van-background-color-light) | - |