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.
Import AutocompleteField.swift
into your project.
platform :ios, '8.0'
pod "AutocompleteField", "~> 1.1"
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)
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. |
Check out the Example project.
- Smarter suggestions. If both John Doe and John Smith are in the suggestion array, only Joe should be suggested.
- Tests
AutocompleteField is provided under the MIT License. See LICENSE for details.