iOS 通讯录联系人排序算法

一、概述

GroupedData - 全网最好用的通讯录联系人排序算法，支持多语言索引排序,接入简单方便无耦合，只需Mode遵守Protocol即可实现排序

GroupedData

索引.GIF

二、使用场景

多语言场景、根据不同语言显示不同索引

意大利语、德语、中文、英文的索引：A B C D E F G H I J K L M N O P Q R S T U V W X Y Z #
土耳其的索引：A B C Ç D E F G H I İ J K L M N O Ö P Q R S Ş T U Ü V W X Y Z #
俄罗斯的索引：А Б В Г Д Е Ж З И Й К Л М Н О П Р С Т У Ф Х Ц Ч Ш Щ Ы Э Ю Я A B C D E F G H I >J K L M N O P Q R S T U V W X Y Z #
波兰语：A Ą B C Ć D E Ę F G H I J K L Ł M N Ń O Ó P Q R S Ś T U V W X Y Z Ź Ż #

不必为名姓、姓名烦恼

细心的小伙伴可能会发现，苹果通讯录可自定义名姓顺序
中文环境下姓在前名在后、英文环境下名在前姓在后
通过实现BaseContactProtocol方法可自定义取姓、取名做索引

通讯录设置.png

三、使用方法

遵守协议

    @interface Model : NSObject

实现协议中的方法

    #pragma mark --- BaseContactProtocol
    - (NSString *)groupTitle{
        NSString *sort = [PinyinConverter toPinyin:self.name];
        NSString *sortStr = [sort length] ? [sort substringWithRange:NSMakeRange(0, 1)] : @"";
        NSString *title = sortStr.localizedCapitalizedString;
        UILocalizedIndexedCollation *collation = [UILocalizedIndexedCollation currentCollation];
        if ([[collation sectionTitles] containsObject:title]) {
            return title;
        }else{
            return @"#";
        }
    }

    - (NSString *)showName{
        return self.name;
    }

Model实现groupTitle协议可自定义索引字段摆脱取首字母限制
满足需求：参考系统通讯录

Model实现showName协议可规范组内排序
满足需求：
1.中文环境下，中文排序在前，英文排序在后
2.英文环境下，英文排序在前，中文排序在后
3.避免陈、晨等同音不同字交叉排序

获取整理后的数据

    GroupedData *groupedData = [[GroupedData alloc] init];
    groupedData.members = myPhoneContacts;
    self.contentDic = groupedData.contentDic;
    self.titles = groupedData.sectionTitles;

排序算法看demo

依赖

无任何依赖

安装

CocoaPods

1. 将 cocoapods 更新至最新版本.
2. 在 Podfile 中添加 pod 'GroupedData', '~> 0.0.1'
3. 执行 pod install 或 pod update。
4. 导入 #import "GroupData.h"

手动安装

1. 下载 GroupedData 文件夹内的所有内容。
2. 将 GroupedData 内的源文件添加(拖放)到你的工程。
3. 导入 #import "GroupData.h"

系统要求

该库最低支持 iOS 9.0 和 Xcode 9.0。

许可证

GroupedData 使用 MIT 许可证，详情见 LICENSE 文件。

个人主页

GitHub地址觉得有用的点个star支持一下

更新日记

• 20210319 提交开源库，欢迎大家使用