IndexBar 索引栏
引入
通过以下方式来全局注册组件,更多注册方式请参考组件注册。
基础用法
点击索引栏时,会自动跳转到对应的 锚点位置。
<van-index-bar>
<van-index-anchor index="A" />
<van-cell title="文本" />
<van-cell title="文本" />
<van-cell title="文本" />
<van-index-anchor index="B" />
<van-cell title="文本" />
<van-cell title="文本" />
<van-cell title="文本" />
</van-index-bar>
export default {
setup() {
return {
indexList: [1, 2, 3, 4, 5, 6, 7, 8, 9, 10],
};
},
};
IndexBar Props
IndexAnchor Props
参数 | 说明 | 类型 | 默认值 |
---|---|---|---|
index | 索引字符 | number | string | - |
IndexBar 方法
通过 ref 可以获取到 IndexBar 实例并调用实例方法,详见。
方法名 | 说明 | 参数 | 返回值 |
---|---|---|---|
scrollTo | 滚动到指定锚点 | index: number | string | - |
类型定义
组件导出以下类型定义:
import { ref } from 'vue';
import type { IndexBarInstance } from 'vant';
const indexBarRef = ref<IndexBarInstance>();
indexBarRef.value?.scrollTo('B');
样式变量
组件提供了下列 CSS 变量,可用于自定义样式,使用方法请参考 ConfigProvider 组件。
名称 | 默认值 | 描述 |
---|---|---|
—van-index-bar-sidebar-z-index | 2 | - |
—van-index-bar-index-font-size | var(—van-font-size-xs) | - |
—van-index-bar-index-line-height | var(—van-line-height-xs) | - |
—van-index-bar-index-active-color | var(—van-danger-color) | - |
—van-index-anchor-z-index | 1 | - |
—van-index-anchor-padding | 0 var(—van-padding-md) | - |
—van-index-anchor-text-color | var(—van-text-color) | - |
—van-index-anchor-font-weight | var(—van-font-weight-bold) | - |
—van-index-anchor-font-size | var(—van-font-size-md) | - |
—van-index-anchor-line-height | 32px | - |
—van-index-anchor-background-color | transparent | - |
—van-index-anchor-sticky-text-color | var(—van-danger-color) | - |
—van-index-anchor-sticky-background-color | var(—van-background-color-light) | - |