Vant3 IndexBar 索引欄

介紹

用于列表的索引分類顯示和快速定位。

實(shí)例演示

引入

通過以下方式來全局注冊組件，更多注冊方式請參考組件注冊。

import { createApp } from 'vue';
import { IndexBar, IndexAnchor } from 'vant';

const app = createApp();
app.use(IndexBar);
app.use(IndexAnchor);

代碼演示

基礎(chǔ)用法

點(diǎn)擊索引欄時，會自動跳轉(zhuǎn)到對應(yīng)的 IndexAnchor 錨點(diǎn)位置。

<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>

自定義索引列表

可以通過 index-list 屬性自定義展示的索引字符列表。

<van-index-bar :index-list="indexList">
  <van-index-anchor index="1">標(biāo)題1</van-index-anchor>
  <van-cell title="文本" />
  <van-cell title="文本" />
  <van-cell title="文本" />

  <van-index-anchor index="2">標(biāo)題2</van-index-anchor>
  <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],
    };
  },
};

API

IndexBar Props

IndexAnchor Props

IndexBar Events

IndexBar 方法

通過 ref 可以獲取到 IndexBar 實(shí)例并調(diào)用實(shí)例方法，詳見組件實(shí)例方法。

IndexAnchor Slots

樣式變量

組件提供了下列 CSS 變量，可用于自定義樣式，使用方法請參考ConfigProvider 組件。