JFContactsPicker
使用 Apple 的 Contacts 框架的联系人选择器组件。
此库最初是从 EPContactsPicker 分支出来的,该库目前已不再维护。
预览
安装
CocoaPods
JFContactsPicker 可在 CocoaPods 上找到。只需将其添加到您的项目 Podfile 中即可
pod 'JFContactsPicker', '~> 1.0'
手动安装
只需将“源”文件夹拖放到您的项目中
需求
- iOS9+
- Swift 3.0
- ARC
对于手动安装,您可能需要在其构建阶段中添加以下框架:ContactsUI.framework
和 Contacts.framework
。
功能
JFContacts Picker 提供所有常见的功能定制选项
[x] 单选和多选选项。[x] 搜索联系人。[x] 配置要显示的联系人数据。(电话号码、电子邮件、生日或组织)[x] 章节索引,可轻松浏览联系人。[x] 图片不可用时代码显示。 [x] 联系人体对象,用于获取联系人的属性
如果您需要支持额外的自定义功能,请创建新问题。
初始化
通过传递代理、多选选项以及要显示的二级数据类型(电话号码、电子邮件、生日或组织)来初始化选择器。
let contactPicker = ContactsPicker(delegate: self, multiSelection:false, subtitleCellType: .email)
let navigationController = UINavigationController(rootViewController: contactPicker)
self.present(navigationController, animated: true, completion: nil)
代理
ContactsPicker 提供四个代理方法,以响应用户选择器的事件。
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》对象为您提供了联系人的属性。这包括属性如displayName、initials、firstName、lastName、company、birthday等。
许可
JFContactsPicker 以 MIT 许可协议可供使用。有关更多信息,请参阅LICENSE文件。