JFContactsPicker 2.0.0

JFContactsPicker 2.0.0

TestsTested
LangLanguage SwiftSwift
License Unknown
ReleasedLast Release Sep 2018
SPMSupports SPM

Maintained by Anthony Miller, Jett Farmer.



  • By
  • Jett Farmer and Anthony Miller

JFContactsPicker

JFContactsPicker

A contacts picker component using Apple's Contacts framework.

Platform Swift 3 CocoaPods Compatible CI Status License Twitter: @AnthonyMDev

This library was originally forked from EPContactsPicker, which is no longer maintained.

Preview

Single SelectionMulti Selection

Installation

CocoaPods

JFContactsPicker is available on CocoaPods. Just add the following to your project Podfile:

pod 'JFContactsPicker', '~> 1.0'

Manual Installation

Just drag and drop the Source folder into your project

Requirements

  • iOS9+
  • Swift 3.0
  • ARC

For manual installation you may need to add these frameworks in your Build Phases: ContactsUI.framework and Contacts.framework.

Features

JFContacts Picker provides all common functionality and customization features:

[x] Single selection and multi-selection options. [x] Search Contacts [x] Configure the contact data to be shown. (Phone Number, Email, Birthday, or Organization) [x] Section indexes to easily navigate through the contacts. [x] Shows initials when image is not available. [x] Contact object to get the properties of the contacts

If you would like additional support for additional customization features, please Create a New Issue.

Initialization

Initialize the picker by passing the delegate, multiselection option, and the secondary data type to be displayed (Phone Number, Email, Birthday, or Organization).

let contactPicker = ContactsPicker(delegate: self, multiSelection:false, subtitleCellType: .email)
let navigationController = UINavigationController(rootViewController: contactPicker)
self.present(navigationController, animated: true, completion: nil)

Delegates

ContactsPicker provides you four delegate methods for responding to the picker's events.

func contactPicker(_: ContactsPicker, didContactFetchFailed error : NSError)
func contactPicker(_: ContactsPicker, didCancel error : NSError)
func contactPicker(_: ContactsPicker, didSelectContact contact : Contact)
func contactPicker(_: ContactsPicker, didSelectMultipleContacts contacts : [Contact])

Contact Object

The Contact object provides you the properties of a contact. This contains properties like displayName, initials, firstName, lastName, company, birthday, etc.

License

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

Contributors

@JettF
@AnthonyMDev

Original Authors
@ipraba
@Sorix