NSSearchFieldに入力された文字でデータを検索する

概要

• NSSearchFieldを使用し、入力した単語でデータを検索して、絞り込み表示するものを作成しました。
  • 今回のものは最低限だけですが、公式のドキュメントをざっと見た所、検索履歴を残したり色々できそうでした。

GitHub

コード全体

//  AppDelegate.m
//  NSSearchFieldSample

# import "AppDelegate.h"
# import "Function.h"

@interface AppDelegate ()
@property NSArray *allPokemonNames; // 全てのポケモン名
@property NSArray *pokemonNames;    // テーブルビューに表示するポケモン名
@property (weak) IBOutlet NSSearchField *searchField;   // 検索窓
@property (weak) IBOutlet NSTableView   *tableView;
@property (weak) IBOutlet NSWindow      *window;
@end

@implementation AppDelegate

- (void)awakeFromNib {
    [self loadPokemonNames];    // テーブルビューに表示するデータを作成する
}

- (void)applicationDidFinishLaunching:(NSNotification *)aNotification {
    // Insert code here to initialize your application
}


- (void)applicationWillTerminate:(NSNotification *)aNotification {
    // Insert code here to tear down your application
}

// テキストからポケモン名のデータを取得する
// またテーブルビューに表示するデータを作成する
- (void)loadPokemonNames {
    NSURL *pokemonList = [[[NSBundle mainBundle] resourceURL] URLByAppendingPathComponent:@"PokemonList"];
    NSMutableArray *pokemonNames = [NSMutableArray arrayWithArray:[Function loadFile:pokemonList]];
    _allPokemonNames = [NSArray arrayWithArray:pokemonNames];
    [self fontSearchFieldIsChanged:nil];
}

# pragma mark - NSSearch Field Method
// 検索窓のテキストに変更があった場合に呼ばれる
- (IBAction)fontSearchFieldIsChanged:(id)sender {
    _pokemonNames = [self createListWithSearchWord:_searchField.stringValue list:_allPokemonNames];
    [_tableView reloadData];
}

/**
 @brief 対象文字列の含まれる要素の配列を作成する
 @parama word 検索する文字列（※ひらがな・カタカナを区別しない）
 @param oldList 検索対象の配列
 @return 対象文字列が含まれる要素の配列
 */
- (NSArray *)createListWithSearchWord:(NSString *)word list:(NSArray<NSString *> *)oldList {
    NSString *searchWord = [word stringByApplyingTransform:NSStringTransformHiraganaToKatakana reverse:NO];  // ひらがなをカタカナに変換（検索時の統一のため）
    searchWord = [searchWord uppercaseString];  // 大文字へキャスト
    if (searchWord.length == 0) {
        return oldList; // 検索文字列がない場合は、元の配列をそのまま返す
    }
    NSMutableArray *newList = [NSMutableArray array];
    [oldList enumerateObjectsUsingBlock:^(NSString *element, NSUInteger idx, BOOL * _Nonnull stop) {
        NSString *fixedElement = [element stringByApplyingTransform:NSStringTransformHiraganaToKatakana reverse:NO]; // 日本語フォント名（ひらがなをカタカナに変換）
        fixedElement = [fixedElement uppercaseString];  // 大文字へキャスト
        
        NSRange searchResult = [fixedElement rangeOfString:searchWord];
        if (searchResult.location != NSNotFound) {
            [newList addObject:element];  // 対象文字列が含まれる場合
        }
    }];
    return newList;
}

# pragma mark - NSTableView data source
- (NSInteger)numberOfRowsInTableView:(NSTableView *)tableView{
    return _pokemonNames.count;
}

- (NSView *)tableView:(NSTableView *)tableView
   viewForTableColumn:(NSTableColumn *)tableColumn
                  row:(NSInteger)row{
    NSString        *identifier = tableColumn.identifier;
    NSTableCellView *cellView   = [tableView makeViewWithIdentifier:identifier owner:self];
    cellView.textField.stringValue = _pokemonNames[row];
    return cellView;
}

@end

/**
 @brief     テキストファイルを読み込んで内容を配列で返す
 @param     sourceUrl テキストファイルのパスURL
 @return    行区切りの配列
 */
+ (NSArray *)loadFile:(NSURL *)sourceUrl {
    NSError  *loadError = nil;
    // ファイルの生データ
    NSString *source = [[NSString alloc] initWithContentsOfURL:sourceUrl
                                                      encoding:NSUTF8StringEncoding
                                                         error:&loadError];
    if (loadError) {
        NSLog(@"%@", [loadError localizedDescription]);
        return [NSArray array];
    }
    NSMutableArray *contents = [NSMutableArray array];     // return value
    [source enumerateLinesUsingBlock:^(NSString *line, BOOL * _Nonnull stop) {
        [contents addObject:line];
    }];
    return contents;
}

• 別クラスFunction.h/mには、上記のメソッドを定義しているだけである。

• データはこちらからお借りしました。PokemonListをプロジェクト内に作成しています。

  • ポケモンの種族値データシートの配布【第7世代】

コード説明

TableView（ViewBase）の設定（StoryBoard）

• dataSourceとdelegateをバインドしておく

NSSearchFieldのテキストが変更されたとき

@property (weak) IBOutlet NSSearchField *searchField;   // 検索窓

• テキストを取得するため@IBOutletを作成しバインディングをしておく

# pragma mark - NSSearch Field Method
// 検索窓のテキストに変更があった場合に呼ばれる
- (IBAction)fontSearchFieldIsChanged:(id)sender {
    _pokemonNames = [self createListWithSearchWord:_searchField.stringValue list:_allPokemonNames];
    [_tableView reloadData];
}

• NSSearchFieldをアクションにバインドした場合、中のテキストが変更されたときにアクションが呼ばれる・
• 下記のように少し一般化したメソッドを定義した。
• 結局やっていることとしては、リストと検索文字列を渡して新たに表示するデータをプロパティに格納し、テーブルビューを更新する、というだけ。

特定の文字列が含まれる要素の配列を作成するメソッド

/**
 @brief 対象文字列の含まれる要素の配列を作成する
 @parama word 検索する文字列（※ひらがな・カタカナを区別しない）
 @param oldList 検索対象の配列
 @return 対象文字列が含まれる要素の配列
 */
- (NSArray *)createListWithSearchWord:(NSString *)word list:(NSArray<NSString *> *)oldList {
    NSString *searchWord = [word stringByApplyingTransform:NSStringTransformHiraganaToKatakana reverse:NO];  // ひらがなをカタカナに変換（検索時の統一のため）
    searchWord = [searchWord uppercaseString];  // 大文字へキャスト
    if (searchWord.length == 0) {
        return oldList; // 検索文字列がない場合は、元の配列をそのまま返す
    }
    NSMutableArray *newList = [NSMutableArray array];
    [oldList enumerateObjectsUsingBlock:^(NSString *element, NSUInteger idx, BOOL * _Nonnull stop) {
        NSString *fixedElement = [element stringByApplyingTransform:NSStringTransformHiraganaToKatakana reverse:NO]; // 日本語フォント名（ひらがなをカタカナに変換）
        fixedElement = [fixedElement uppercaseString];  // 大文字へキャスト
        
        NSRange searchResult = [fixedElement rangeOfString:searchWord];
        if (searchResult.location != NSNotFound) {
            [newList addObject:element];  // 対象文字列が含まれる場合
        }
    }];
    return newList;
}

• 検索する場合にひらがな・カタカナを区別しないようにするため、文字列比較時にはカタカナに統一している。
  • [iOS 10] 全角文字列を半角文字列に変換する
  • （Apple）stringByApplyingTransform:reverse:
    
• 今回は関係ないが、同様に大文字・小文字を区別しないようにするため、文字列比較時には大文字に統一している。
  • （Apple）uppercaseString
• 文字列検索にはrangeOfStringを用いる
  • 2012-11-19 ObjectiveCでNSString内の文字列検索をする方法のまとめAdd Star