在 iOS 的 UITableView 中,索引功能可以讓使用者快速跳轉到特定分組。常見做法包括英文字母索引與漢字拼音索引。以下說明實作概念。
若資料本身已經是英文名稱,可以先建立字典,把相同首字母的資料放入同一陣列。再將所有 key 排序,作為 section 標題與索引列。
NSString *path = [[NSBundle mainBundle] pathForResource:@"sortednames" ofType:@"plist"];
NSDictionary *names = [NSDictionary dictionaryWithContentsOfFile:path];
NSArray *keys = [names allKeys];
keys = [keys sortedArrayUsingSelector:@selector(compare:)];
在 UITableViewDataSource 中,可透過 keys 取得每個 section 的標題與資料。
若資料是中文城市或姓名,通常需要先取得拼音首字母。實作時可先建立 a 到 z 的可變陣列,再依每筆資料的首字母分類。最後移除空集合,並排序索引。
for (char character = 'a'; character <= 'z'; character++) {
NSString *key = [NSString stringWithFormat:@"%c", character];
NSMutableArray *array = [NSMutableArray array];
[dictionary setObject:array forKey:key];
}
這裡的 pinyinFirstLetter 是自行實作或第三方函式,用來把漢字轉成拼音首字母。完成分類後,再把 dictionary 的 key 排序,作為索引來源。
UITableViewDelegate 可實作 sectionIndexTitlesForTableView:,回傳索引陣列。系統會自動在右側顯示索引列,使用者點擊後即可跳轉到對應 section。
- (NSArray *)sectionIndexTitlesForTableView:(UITableView *)tableView {
return self.keys;
}
整體重點是:先建立 key 與資料的對應關係,再提供排序後的索引陣列。這樣就能讓長列表更容易瀏覽。