引入
在app.json
或index.json
中引入组件,详细介绍见快速上手
"usingComponents": {
"van-sidebar": "path/to/@vant/weapp/dist/sidebar/index",
"van-sidebar-item": "path/to/@vant/weapp/dist/sidebar-item/index"
}
Vant Weapp 1.0 版本开始支持此组件,升级方式参见快速上手
代码演示
基础用法
通过在van-sidebar
上设置activeKey
属性来控制选中项
<van-sidebar active-key="{{ activeKey }}" bind:change="onChange">
<van-sidebar-item title="标签名称" />
<van-sidebar-item title="标签名称" />
<van-sidebar-item title="标签名称" />
</van-sidebar>
Page({
data: {
activeKey: 0
},
onChange(event) {
wx.showToast({
icon: 'none',
title: `切换至第${event.detail}项`
});
}
});
提示信息
设置dot
属性后,会在右上角展示一个小红点。设置info
属性后,会在右上角展示相应的徽标
<van-sidebar active-key="{{ activeKey }}">
<van-sidebar-item title="标签名称" dot />
<van-sidebar-item title="标签名称" info="5" />
<van-sidebar-item title="标签名称" info="99+" />
</van-sidebar>
API
参数 | 说明 | 类型 | 默认值 | 版本 |
---|
activeKey | 选中项的索引 | string | number | 0 | - |
事件名 | 说明 | 参数 |
---|
change | 切换徽章时触发 | 当前选中徽章的索引 |
参数 | 说明 | 类型 | 默认值 | 版本 |
---|
title | 内容 | string | '' | - |
dot | 是否显示右上角小红点 | boolean | false | - |
info | 提示消息 | string | number | '' | - |
事件名 | 说明 | 参数 |
---|
click | 点击徽章时触发 | 当前徽章的索引 |