IndexBar 索引栏

引入

在app.json或index.json中引入组件，详细介绍见快速上手

"usingComponents": {
  "van-index-bar": "path/to/@vant/weapp/dist/van-index-bar/index",
  "van-index-anchor": "path/to/@vant/weapp/dist/van-index-anchor/index"
}

Vant Weapp 1.0 版本开始支持此组件，升级方式参见快速上手

代码演示

基础用法

点击索引栏时，会自动跳转到对应的IndexAnchor锚点位置

<van-index-bar scroll-top="{{ scrollTop }}">
  <view>
    <van-index-anchor index="A" />
    <van-cell title="文本" />
    <van-cell title="文本" />
    <van-cell title="文本" />
  </view>
  <view>
    <van-index-anchor index="B" />
    <van-cell title="文本" />
    <van-cell title="文本" />
    <van-cell title="文本" />
  </view>
  ...
</van-index-bar>

Page({
  onPageScroll(event) {
    this.setData({
      scrollTop: event.scrollTop
    });
  }
});

自定义索引列表

可以通过index-list属性自定义展示的索引字符列表，

<van-index-bar
  scroll-top="{{ scrollTop }}"m
  index-list="{{ indexList }}"
>
  <view>
    <van-index-anchor index="1">标题1</van-index-anchor>
    <van-cell title="文本" />
    <van-cell title="文本" />
    <van-cell title="文本" />
  </view>
  <view>
    <van-index-anchor index="2">标题2</van-index-anchor>
    <van-cell title="文本" />
    <van-cell title="文本" />
    <van-cell title="文本" />
  </view>
  ...
</van-index-bar>

Page({
  data: {
    indexList: [1, 2, 3, 4, 5, 6, 7, 8, 9, 10]
  },
  onPageScroll(event) {
    this.setData({
      scrollTop: event.scrollTop
    });
  }
});

API

IndexBar Props

IndexAnchor Props

IndexBar Events

IndexAnchor Slots