Harmony NEXT - AlphabetIndexer实现联系人字母索引

摘要

使用AlphabetIndexer实现联系人字母索引，AlphabetIndexer是官方封装好的组件

代码实现

首先在aboutToAppear方法中初始化数据，aboutToAppear方法相当于安卓开发中Activity的onCreate，遍历字符串列表，使用pinyin-pro框架转成拼音，再截取首字母转成大写，最后对数组进行排序，规则是：A-Z-#

initData(){
    const nameList = ["白虎","白天","白痴","常羲","嫦娥",
        "二郎神","伏羲","观世音","精卫","夸父","789范德萨范德萨","女娲","哪吒",
        "盘古","青龙","如来","孙悟空","沙僧","顺风耳","太白金星","太上老君","羲和","玄武",
        "猪八戒","朱雀","祝融","Abbey","Steven","Elizabeth","しんのすけ"];

    for(let i=0;i<nameList.length;i++){
        let pinyinStr=pinyin(nameList[i], { toneType: "none" });//根据姓名获取拼音
        let index=pinyinStr.substring(0,1).toUpperCase();// 获取拼音首字母并转成大写
        if (!/^[A-Z]$/.test(index)) { // 如果不在A-Z中则默认为“#”
            index = "#";
        }
        console.log(nameList[i]+" index:"+index)
        this.list.push(new Contact(index, nameList[i]));
    }

    this.list.sort((a, b) => {
        if (a.index === b.index) {
            return a.name.localeCompare(b.name);
        }
        if (a.index === "#") {
            return 1;
        }
        if (b.index === "#") {
            return -1;
        }
        return a.index.localeCompare(b.index);
    });
}

数据准备好了，接下来如何展示在界面上，ArkTS UI非常简单，不像安卓要写适配器、IOS要写Cell，@Component组件必须要重写build方法，在build方法中实现界面逻辑，首先最外层使用Row容器组件，一行显示

• 左边使用List组件加载列表，在循环列表中通过if判断是否显示字母
• 右边使用AlphabetIndexer组件展示26个字母，实现onSelect方法，用户选中字母会回调这个方法

build() {
    Row() {
        List({ space: 0, initialIndex: 0,scroller:this.scroller}){//加载列表
            ForEach(this.list, (item:Contact,index) => {
                ListItem() {
                    Column(){
                        if (index==0||this.list[index-1].index != item.index){
                            Text(item.index).width('100%').fontColor('#333333').fontSize(14).backgroundColor("#EAEAEA").padding({
                                top:5,bottom:5,left:15
                            })
                        }

                        Text(item.name)
                            .fontSize(30)
                            .padding({
                                top:15,bottom:15,left:15
                            })
                    }.alignItems(HorizontalAlign.Start)
                }
            }, (item:Contact) => util.generateRandomUUID(true))//key随机生成
        }.layoutWeight(1).scrollBar(BarState.Off)
        .height('100%').divider({
            color:'#E5E5E5',
            strokeWidth:0.5
        })

        AlphabetIndexer({ arrayValue: this.value, selected: 0})
            .selectedColor(0xFFFFFF) // 选中项文本颜色
            .popupColor(0xFFFAF0) // 弹出框文本颜色
            .selectedBackgroundColor(0xCCCCCC) // 选中项背景颜色
            .popupBackground(0xD2B48C) // 弹出框背景颜色
            .usingPopup(false) // 是否显示弹出框
            .selectedFont({ size: 16, weight: FontWeight.Bolder }) // 选中项字体样式
            .popupFont({ size: 30, weight: FontWeight.Bolder }) // 弹出框内容的字体样式
            .itemSize(22) // 每一项的尺寸大小
            .alignStyle(IndexerAlign.Left) //弹出框在索引条右侧弹出
            .onSelect((index: number) => {
                console.info(this.value[index] + ' Selected!')
                this.onSelectIndexItem(this.value[index]);
            })
    }
    .width('100%')
    .height('100%')
}

当用户选中某个字母时，循环遍历索引位置，通过scroller滚动到指定位置

onSelectIndexItem(index:string){
    for (let i=0;i<this.list.length;i++){
        console.log("名字："+this.list[i].name+" index1:"+this.list[i].index+" index2:"+index)
        if (this.list[i].index == index){
            this.scroller.scrollToIndex(i)//滚动到索引位置
            break ;
        }
    }
}

AlphabetIndexer还可以通过usingPopup设置是否使用提示弹窗，大家可以自己去看API文档。