AutocompleteTextfieldSwift

Simple and straightforward sublass of UITextfield to manage string suggestions

Simple	Attributed

Installation

Drag AutocompleteTextfield Folder in yuor project

##How to use

####Customize Customize autocomplete suggestions! You can override the provided properties to create your desired appearance. Properties are pretty self explanatory, but description has been provided as well.

 /// Font for the text suggestions
  var autoCompleteTextFont = UIFont(name: "HelveticaNeue-Light", size: 12)
  
  /// Color of the text suggestions
  var autoCompleteTextColor = UIColor.blackColor()
  
  /// Used to set the height of cell for each suggestions
  var autoCompleteCellHeight:CGFloat = 44.0
  
  /// The maximum visible suggestion
  var maximumAutoCompleteCount = 3
  
  /// Used to set your own preferred separator inset
  var autoCompleteSeparatorInset = UIEdgeInsetsZero
  
  /// Hides autocomplete tableview when the textfield is empty
  var hideWhenEmpty = true
  
  /// Hides autocomplete tableview after selecting a suggestion
  var hideWhenSelected = true
  
  /// Shows autocomplete text with formatting
  var enableAttributedText = false
  
  /// User Defined Attributes
  var autoCompleteAttributes:Dictionary<String,AnyObject>?
  
  /// The table view height
  var autoCompleteTableHeight:CGFloat = 100.0

The most important property to use is the autoCompleteStrings. As what is declared in the description setting the value of this will automatically reload the tableview, through the use of didSet

/// The strings to be shown on as suggestions, setting the value of this automatically reload the tableview
 var autoCompleteStrings:[String]?{
   didSet{
     reloadAutoCompleteData()
   }
 }

####Protocol Conform with AutocompleteTextFieldDelegate

class ViewController: UIViewController, AutocompleteTextFieldDelegate{...}

and add:

autocompleTextfield.autoCompleteDelegate = self

After this you can do whatever you want with the provided delegates! In here i used textFieldDidChange(text:String) to request autocomplete places to google api

func autoCompleteTextFieldDidChange(text: String) {
    if !text.isEmpty{
      if connection != nil{
        connection!.cancel()
        connection = nil
      }
      let urlString = "\(baseURLString)?key=\(googleMapsKey)&input=\(text)"
      let url = NSURL(string: urlString.stringByAddingPercentEscapesUsingEncoding(NSASCIIStringEncoding)!)
      if url != nil{
        let urlRequest = NSURLRequest(URL: url!)
        connection = NSURLConnection(request: urlRequest, delegate: self)
      }
    }
  }

and didSelectAutocompleteText(text:String, indexPath:NSIndexPath) to process the selected string, in which I performed geocoding using CLGeocoder to retrieve placemark and add annotation to our mapview.

func didSelectAutocompleteText(text: String, indexPath: NSIndexPath) {
    println("You selected: \(text)")
    Location.geocodeAddressString(text, completion: { (placemark, error) -> Void in
      if placemark != nil{
        let coordinate = placemark!.location.coordinate
        self.addAnnotation(coordinate, address: text)
        self.mapView.setCenterCoordinate(coordinate, zoomLevel: 12, animated: true)
      }
    })
  }

It's that easy!

##Example Code: In the example project, I used Google Places Autocomplete API to show the usage of this library. For testing purposes i created my own googl api key

#####Note: If you want to create your own Google Api Key follow the steps in this link

##License AutocompleteTextfield is under MIT license. See LICENSE for details.