Skip to content

IndexList

A-Z alphabet index list. Supports data grouping, right-side index navigation bar, sticky group headers, and search filtering.

Basic Usage

vue
<template>
  <see-index-list :data="data" @on-select="onSelect" />
</template>

<script setup>
const data = [
  { index: 'A', name: 'Alice' },
  { index: 'B', name: 'Bob' },
  { index: 'C', name: 'Charlie' }
]

const onSelect = (item) => {
  console.log('Selected:', item)
}
</script>
vue
<template>
  <see-index-list :data="data" :is-show-search="true" />
</template>

IndexListItem

PropertyTypeDescription
indexstringIndex value (e.g. A, B, C)
namestringDisplay name
pinyinstringPinyin (optional)
firstLetterstringFirst letter (optional)

Props

PropertyTypeDefaultDescription
dataIndexListItem[][]Data list
indexListstring[][]Custom index list
indexKeystring'index'Index field name
isPinyinbooleanfalseWhether to enable pinyin index
isShowSearchbooleanfalseWhether to show search box
isStickyHeaderbooleantrueWhether group headers are sticky
heightstring | number'100%'List height
isVirtualbooleanfalseWhether to enable virtual scrolling

Events

EventParametersDescription
onSelectitemItem selected
onIndexChangeindexIndex changed

Liao ICP No. 2025070134