/EPContactsPicker

A contacts picker component for iOS

Primary LanguageSwiftMIT LicenseMIT

EPContactsPicker

EPContactsPicker

A contacts picker component for iOS. Created in swift using the new contacts framework by apple.

Platform Swift 2.0 Cocoapods Compatible CI Status License

Preview

Single Selection Multi Selection

Installation

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

pod 'EPContactsPicker'
use_frameworks!

####Manual Installation

Just drag and drop the EPContactsPicker folder into your project

Requirements

iOS9+ Swift 2.0+ ARC

For manual installation you might have to add these frameworks in your Build Phases ContactsUI.framework and Contacts.framework.

Features

EPContacts Picker provides lot of features which lets you customize the picker

  1. Single selection and multiselection option
  2. Making the secondary data to show as requested(Phonenumbers, Emails, Birthday and Organisation)
  3. Section Indexes to easily navigate throught the contacts
  4. Showing initials when image is not available
  5. EPContact object to get the properties of the contacts

Initialization

Init the picker by passing delegate, multiselection option and the secondary data(Phone number, Email, brithday and Organisation) to be displayed

let contactPickerScene = EPContactsPicker(delegate: self, multiSelection:false, subtitleCellType: SubtitleCellValue.Email)
let navigationController = UINavigationController(rootViewController: contactPickerScene)
self.presentViewController(navigationController, animated: true, completion: nil)

Delegates

EPContactsPicker provides you four delegates for getting the callbacks on the picker

optional    func epContactPicker(_: EPContactsPicker, didContactFetchFailed error : NSError)
optional    func epContactPicker(_: EPContactsPicker, didCancel error : NSError)
optional    func epContactPicker(_: EPContactsPicker, didSelectContact contact : EPContact)
optional    func epContactPicker(_: EPContactsPicker, didSelectMultipleContacts contacts : [EPContact])

EPContact Object

EPContact object provides you the properties of a contact. This contains properties like displayname, initials, firstname, lastname, organisation, birthdayString etc

License

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

Contributors

@ipraba