ARAutocompleteTextView
  • October 19, 2023

Overview


ARAutocompleteTextView is a subclass of UITextView that automatically displays text suggestions in real-time. This is perfect for automatically suggesting the domain as a user types an email address, #hashtag or @handle.

Usage


Installation


Add the following files to your project:

  • ARAutocompleteTextView.m
  • ARAutocompleteTextView.h
  • ARAutocompleteManager.m
  • ARAutocompleteManager.h

Quickstar Guide


Create an ARAutocompleteTextView instance exactly as as you would UITextView. You can do eith either programmitcally or in Interface Builder. Programmatically, this looks like:

Objective-C

ARAutocompleteTextView* textField = [[ARAutocompleteTextView alloc] initWithFrame:CGRectMake(0,0,100,31)];

Swift

let textField = ARAutocompleteTextView(frame: CGRectMake(0, 0, 100, 31))

The data source is the brains of the autocomplete logic. If you just want to autocomplete email addresses, #hashtags or @handles, use ARAutocompleteManager from the example project as follows:

Objective-C

textField.autocompleteDataSource = [ARAutocompleteManager sharedManager];
textField.autocompleteType = ARAutocompleteTypeEmail;

Swift

textField.autocompleteDataSource = ARAutocompleteManager.sharedManager()
textField.autocompleteType = ARAutocompleteType.Mail

Customization


Autocompletion Data Source

ARAutocompleteManager (included in the example project) provides email address autocompletion out of the box. It comes with a list of the top email domains. You may want to tailor this list of email domains to match your own customers, or you may want to write autocomplete logic for a different type of text view (in the demo, names of colors are autocompleted).

Alternatively, you may wish to create your own data source class and user the autocompleteType property to differentiate between textviews with different data types. A ARAutocompleteTextView‘s data source must implement the following method, as part of the ARAutocompleteDataSource protocol.

– (NSString *)textField:(ARAutocompleteTextView*)textField completionForPrefix:(NSString *)prefix

You may also set a default dataSource for all instances of ARAutocompleteTextView. In the example project, we use a ARAutocompleteManager singleton:

[autocompleteTextOffset setDefaultAutocompleteDataSource:[ARAutocompleteManager sharedManager]];

Positioning and Formatting

To adjust the position of the autocomplete label by a fixed amount, set autocompleteTextOffset:

textField.autocompleteTextOffset = CGPointMake(10.0, 10.0);

For more dynamic positioning of the autocomplete label, subclass ARAutocompleteTextView and override - (CGRect)autocompleteRectForBounds:(CGRect)bounds.

To adjust the properties (i.e. fonttextColor) of the autocomplete label, do so via the `[AutocompleteTextField autocompleteLabel] property.

textField.autocompleteLabel.textColor = [UIColor grayColor];

Event Listening


In addition to observing the standard UITextView notifications (i.e. UITextViewTextDidChangeNotification and friends), you can use [ARAutocompleteTextView autoCompleteTextFieldDelegate] to listen for certain events. This is particularly useful if you are collecting analytics.

Etc.


  • Use this in your apps whenever you can, particularly email addresses — your users will appreciate it!
  • Contributions are very welcome.
  • Attribution is appreciated (let’s spread the word!), but not mandatory.

GitHub


View Github

#animation #autocomplete #awesemetextfield #carthage #cocoapods #currencytextfield #customtextfield #customwidgets #datasource #facetedsearch #geosearch #growingtextview #instantsearch #interfacebuilder #ios #ioslibrary #iosswift #objectivec #opensource #passwordtextfield #placeholder #placeholdertextview #realmswift #search #searchengine #searchinterface #searchsynonyms #styledtext #swift #swiftframework #swiftlibrary #swiftpackagemanager #swiftui #swiftuicomponents #text #textexpansion #textfield #texture #textview #tjtextfield #ui #uikit #uitextfield #uitextfieldnavigation #uitextview #uitextviewalgolia #widgets
YOU MIGHT ALSO LIKE...
🧭 NavigationKit

NavigationKit is a lightweight library which makes SwiftUI navigation super easy to use. 💻 Installation 📦 Swift Package Manager Using Swift Package Manager, add ...

swiftui-navigation-stack

An alternative SwiftUI NavigationView implementing classic stack-based navigation giving also some more control on animations and programmatic navigation. NavigationStack Installation ...

Stinsen

Simple, powerful and elegant implementation of the Coordinator pattern in SwiftUI. Stinsen is written using 100% SwiftUI which makes it ...

SwiftUI Router

With SwiftUI Router you can power your SwiftUI app with path-based routing. By utilizing a path-based system, navigation in your app becomes ...

FlowStacks

This package takes SwiftUI's familiar and powerful NavigationStack API and gives it superpowers, allowing you to use the same API not just ...