Add word completion to your UITextFields.
Switch branches/tags
Nothing to show
Clone or download
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
AutocompleteField Updated documentation Nov 23, 2015
Example Bumped version in readme Nov 23, 2015
.gitignore First commit Nov 8, 2015
AutocompleteField.podspec Bump to v1.1 Nov 23, 2015
LICENSE.txt First commit Nov 8, 2015
README.md Bumped version in readme Nov 23, 2015

README.md

AutocompleteField

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

AutocompleteField

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.