josejulio/autocompletefield

Add word completion to your UITextFields.

AutocompleteField let's you add word completion to your UITextFields.

Autocomplete, or word completion, is a feature in which an application predicts the rest of a word a user is typing.

How it works

Installation

Manual installation

Import AutocompleteField.swift into your project.

CocoaPods

platform :ios, '8.0'
pod "AutocompleteField", "~> 1.1" 

Usage

The easiest way is to add a UITextField in your Storyboard, and then giving it the AutocompleteField subclass. You can use the property editor to change both the padding and the completion color of the textfield.

If you want to add a field using code, there's a custom init method you can use:

import AutocompleteField

let textField = AutocompleteField(frame: CGRectMake(10, 10, 200, 40), suggestions: ["Abraham", "George", "Franklin"])
view.addSubview(textField)

Customization

AutocompleteField is a subclass of UITextField, so you can modify it in the same way you normally would, without any restrictions. The new properties you can set are:

Property	Type	Description
padding	CGFloat	Left/right padding.
completionColor	UIColor	The color of the suggestion. Defaults to the default placeholder color.
suggestion	String	The current suggestion shown. Can be used to force a suggestion.
suggestions	[String]	Array of suggestions.
autocompleteType	AutocompleteType	The type of autocomplete that should be used. .Word will only hint the the next word in the suggestion and .Sentence will show all words.
pixelCorrection	CGFloat	Move the suggestion label up or down. Sometimes there's a small difference, and this can be used to fix it.

Demo

Check out the Example project.

Todo

• Smarter suggestions. If both John Doe and John Smith are in the suggestion array, only Joe should be suggested.
• Tests

License

AutocompleteField is provided under the MIT License. See LICENSE for details.