扩展组件(uni-ui)之uni-indexed-list

517 阅读1分钟

uni-indexed-list 是 uni-app 的 uni-ui 组件库中的一个索引列表组件,用于创建带有索引栏的列表视图。这种组件通常用于长列表的快速导航,例如联系人列表、城市列表等,用户可以通过点击或滑动索引栏快速跳转到列表的指定部分。

基本用法

在使用 uni-indexed-list 之前,你需要确保已经正确安装了 uni-ui 库,并在页面中引入了 uni-indexed-list 组件。

引入组件

<template>
    <uni-indexed-list :list="listData" @select="onSelect"></uni-indexed-list>
</template>

<script>
    import uniIndexedList from '@dcloudio/uni-ui/lib/uni-indexed-list/uni-indexed-list.vue'
    export default {
        components: { uniIndexedList },
        data() {
            return {
                listData: [
                    {
                        index: 'A',
                        data: ['阿尔巴尼亚', '阿尔及利亚', '阿富汗']
                    },
                    {
                        index: 'B',
                        data: ['巴哈马', '巴基斯坦', '巴拉圭']
                    },
                    // 更多数据...
                ]
            }
        },
        methods: {
            onSelect(item) {
                console.log('你选择了:', item);
            }
        }
    }
</script>

属性

  • list:一个数组,每个元素代表列表中的一个分组,每个分组包含一个 index 字段(索引字符)和一个 data 字段(该索引下的数据列表)。

事件

  • select:当用户选择列表中的某项时触发的事件,事件参数为所选项的内容。

示例

以下是 uni-indexed-list 组件的使用示例,创建了一个带有索引栏的列表:

<uni-indexed-list :list="listData" @select="onSelect"></uni-indexed-list>

注意事项

  • 通过 list 属性传入列表数据,确保数据格式符合要求。
  • 列表的索引通常是按字母或其他顺序排列的。
  • 使用 select 事件来处理用户的选择操作。

更多关于 uni-indexed-list 组件的使用细节,可以查阅 uni-ui 官方文档 或 uni-ui 库的相关文档。