Latest0.3.0
Homepagehttps://github.com/nferocious76/AutoCompleteTextField
LicenseMIT
Platformsios 8.0, requires ARC
Authors

CI Status
Version
License
Carthage compatible
Platform

ezgif com-resize 1

Features

  • [x] Provides a subclass of UITextField that has suggestion from input
  • [x] Has autocomplete input feature
  • [x] Data suggestion are provided by users
  • [x] Enable store smart domains
  • [x] Optimized and light weight

Requirements

  • iOS 8.0+ / Mac OS X 10.9+
  • Xcode 9.0+

Installation

CocoaPods

You can use CocoaPods to install AutoCompleteTextField by adding it to your Podfile:

pod "AutoCompleteTextField"

Carthage

Create a Cartfile that lists the framework and run carthage bootstrap. Follow the instructions to add $(SRCROOT)/Carthage/Build/iOS/AutoCompleteTextField.framework to an iOS project.

github "nferocious76/AutoCompleteTextField"

Manually

  1. Download and drop /Pod/Classesfolder in your project.
  2. Congratulations!

Usage


// Initializing `AutoCompleteTextField` 
let myTextField = AutoCompleteTextField(frame: CGRect(x: 20, y: 64, width: view.frame.width - 40, height: 40), dataSource: `YourDataSource`, delegate: `YourDelegate`)

// Setting `dataSource`, it can be set from the XCode IB like `TextFieldDelegate` in which will appear as `actfDataSource`
myTextField.dataSource = `YourDataSource`

// Setting delimiter (optional). If set, it will only look for suggestion after the delimiter
myTextField.setDelimiter("@")

// Show `AutoCompleteButton`
myTextField.showAutoCompleteButtonWithImage(UIImage(named: "checked"), viewMode: .whileEditing)

// Providing data source to get the suggestion from inputs
func autoCompleteTextFieldDataSource(_ autoCompleteTextField: AutoCompleteTextField) -> [ACTFWeightedDomain] {

    return weightedDomains // AutoCompleteTextField.domainNames // [ACTFDomain(text: "gmail.com", weight: 0), ACTFDomain(text: "hotmail.com", weight: 0), ACTFDomain(text: "domain.net", weight: 0)]
}

ACTFDomain

ACTFDomain is struct type that conforms to the Codable. User can store and retrieve smart domains.

One example may be ‘gmail.com’ and ‘georgetown.edu’. Users are more likely to have a ‘gmail.com’ account so we would want that to show up before ‘georgetown.edu’, even though that is out of alphabetical order.

ACTFDomain is sorted based on its usage.

This is just one example. Manually providing a suggestion gives more flexibility and does not force the usage of an array of strings.


// Usage
let g1 = ACTFDomain(text: "gmail.com", weight: 10)
let g2 = ACTFDomain(text: "googlemail.com", weight: 5)
let g3 = ACTFDomain(text: "google.com", weight: 4)
let g4 = ACTFDomain(text: "georgetown.edu", weight: 1)

let weightedDomains = [g1, g2, g3, g4] // [ACTFDomain]

// Storing

// store single
if g1.storeDomainForKey("Domain") {
    print("Store success")
}

// store multiple
if ACTFDomain.storeDomainsForKey(domains: weightedDomains, key: "Domains") {
    print("Store success")
}

// retrieved single
if let domain = ACTFDomain.retrievedDomainForKey("Domain") {
    print("Retrieved: ", domain)
}

// retrieved multiple
if let domains = ACTFDomain.retrievedDomainsForKey("Domains") {
    print("Retrieved: ", domains)
}

Contribute

We would love for you to contribute to AutoCompleteTextField. See the LICENSE file for more info.

Author

Neil Francis Ramirez Hipona, [email protected]

About

This project was inpired by ‘HTAutocompleteTextField’ an Objc-C framework of the same feature.

License

AutoCompleteTextField is available under the MIT license. See the LICENSE file for more info.

Latest podspec

{
    "name": "AutoCompleteTextField",
    "version": "0.3.0",
    "summary": "TextField Subclass with auto completion feature.",
    "description": ""A TextField Subclass that has input suggestion for user's convenience, when auto completion feature kicks in, it uses the suggestions from the datasource provided by the user or from the default domain."",
    "homepage": "https://github.com/nferocious76/AutoCompleteTextField",
    "license": "MIT",
    "authors": {
        "Neil Francis Ramirez Hipona": "[email protected]"
    },
    "source": {
        "git": "https://github.com/nferocious76/AutoCompleteTextField.git",
        "tag": "0.3.0"
    },
    "platforms": {
        "ios": "8.0"
    },
    "requires_arc": true,
    "source_files": "Pod/Classes/**/*",
    "resources": "Pod/Assets/*.xcassets",
    "pushed_with_swift_version": "3.0-GM-CANDIDATE"
}

Pin It on Pinterest

Share This