一、概述
GroupedData - 全网最好用的通讯录联系人排序算法,支持多语言索引排序,接入简单方便无耦合,只需Mode遵守Protocol即可实现排序
索引.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<BaseContactProtocol>
实现协议中的方法
#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
- 将 cocoapods 更新至最新版本.
- 在 Podfile 中添加 pod 'GroupedData', '~> 0.0.1'
- 执行
pod install
或pod update
。 - 导入 #import "GroupData.h"
手动安装
- 下载 GroupedData 文件夹内的所有内容。
- 将 GroupedData 内的源文件添加(拖放)到你的工程。
- 导入 #import "GroupData.h"
系统要求
该库最低支持 iOS 9.0
和 Xcode 9.0
。
许可证
GroupedData 使用 MIT 许可证,详情见 LICENSE 文件。
个人主页
GitHub地址觉得有用的点个star支持一下
更新日记
- 20210319 提交开源库,欢迎大家使用