Skip to content

lfarah/AutocompleteField

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

9 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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.

About

Add word completion to your UITextFields.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Swift 87.5%
  • Ruby 12.5%