Skip to content

chika-kasymov/UITextField_AutoSuggestion

Repository files navigation

UITextField_AutoSuggestion

[CI Status](https://travis-ci.org/Kassymov Shyngys/UITextField_AutoSuggestion) Version License Platform

Final auto suggestion feature

Example

To run the example project, clone the repo, and run pod install from the Example directory first.

Requirements

  • Xcode >= 7
  • iOS >= 8.0

Installation

UITextField_AutoSuggestion is available through CocoaPods. To install it, simply add the following line to your Podfile:

pod "UITextField_AutoSuggestion"

Usage

You can use library this way:

  1. Conform to UITextFieldAutoSuggestionDataSource:

    @interface ViewController () <UITextFieldAutoSuggestionDataSource>
  2. Set data source to some UITextField and start observing changes

    // `fieldIdentifier` is optional
    self.textField.autoSuggestionDataSource = self;
    self.textField.fieldIdentifier = @"FIELD_ID";
    [self.textField observeTextFieldChanges];
  3. Implement required data source methods

    #pragma mark - UITextFieldAutoSuggestionDataSource
    
    - (UITableViewCell *)autoSuggestionField:(UITextField *)field tableView:(UITableView *)tableView cellForRowAtIndexPath:(NSIndexPath *)indexPath forText:(NSString *)text {
        static NSString *cellIdentifier = @"AutoSuggestionCell";
        UITableViewCell *cell = [tableView dequeueReusableCellWithIdentifier:cellIdentifier];
        
        if (!cell) {
            cell = [[UITableViewCell alloc] initWithStyle:UITableViewCellStyleDefault reuseIdentifier:cellIdentifier];
        }
        
        // configure cell
        cell.textLabel.text = DATA[indexPath.row];
        
        return cell;
    }
    
    - (NSInteger)autoSuggestionField:(UITextField *)field tableView:(UITableView *)tableView numberOfRowsInSection:(NSInteger)section forText:(NSString *)text {
        return DATA.count;
    }
  4. Implement optional data source methods if needed

    - (void)autoSuggestionField:(UITextField *)field textChanged:(NSString *)text {
    	// can be useful in some scenarious, see example project
        [self loadDataFromInternet];
    }
    
    - (CGFloat)autoSuggestionField:(UITextField *)field tableView:(UITableView *)tableView heightForRowAtIndexPath:(NSIndexPath *)indexPath forText:(NSString *)text {
        return 50;
    }
    
    - (void)autoSuggestionField:(UITextField *)field tableView:(UITableView *)tableView didSelectRowAtIndexPath:(NSIndexPath *)indexPath forText:(NSString *)text {    	    
    	// do something if suggestion row selected
    	NSLog(@"%@", DATA[indexPath.row]);
    }

Author

Kassymov Shyngys, [email protected]

License

UITextField_AutoSuggestion is available under the MIT license. See the LICENSE file for more info.