通訊錄、城市選擇、歌單這類列表,都需要右側那條 A–Z 的索引。中文字串本身沒有字母順序,得先轉成拼音首字母,再分組、排序、產生索引鍵陣列。這件事邏輯固定,封裝一次到處可用。
/**
* 傳入原始數據與用來存放索引的空數組,回傳整理後的分組數組
* 已封裝為分類,引入頭文件即可使用
* https://github.com/KKKKaras/JY_SectionDemo
*/
#import "JYTableViewController.h"
#import "ChineseString.h"
#import "NSObject+Index.h"
@interface JYTableViewController () {
NSMutableArray *_listArray; // 源數據
NSMutableArray *_AbcSort; // 排序整理後的數據
NSMutableArray *_sectionHeadsKeys;// 存放索引
}
@end
@implementation JYTableViewController
- (void)viewDidLoad {
[super viewDidLoad];
_AbcSort = [[NSMutableArray alloc] init];
_sectionHeadsKeys = [[NSMutableArray alloc] init];
_listArray = [[NSMutableArray alloc] initWithObjects:
@"白居易", @"柳驚濤", @"莫雨", @"王遺風",
@"唐大俠", @"李白", @"杜甫", nil];
// 一次呼叫拿到分組結果與索引鍵
_AbcSort = [self getChineseStringArr:_listArray andSck:_sectionHeadsKeys];
}
@end
拼音轉換在 iOS 上並不需要外部依賴,系統內建的 CFStringTransform 就能把中文轉成帶聲調的拼音,再取首字母即可:
- (NSString *)pinyinFirstLetterFromString:(NSString *)aString {
NSMutableString *str = [NSMutableString stringWithString:aString];
CFStringTransform((CFMutableStringRef)str, NULL, kCFStringTransformMandarinLatin, NO);
CFStringTransform((CFMutableStringRef)str, NULL, kCFStringTransformStripDiacritics, NO);
NSString *pinYin = [str capitalizedString];
return [pinYin substringToIndex:1];
}
實作時有三個容易忽略的點:一是英文、數字、符號開頭的項目要另外歸到「#」組,並把它排在最後;二是索引列要用 UITableViewIndexSearch 加上搜尋按鈕,體驗更完整;三是數據更新後必須重新計算分組,否則索引會與內容對不上。