VDContactPicker

使用 Apple 的 Contacts 框架制作的联系人选择组件。

这个库最初是 fork 自 JFContactsPicker

预览

安装

CocoaPods

VDContactPicker 可在 CocoaPods 上使用。只需将以下内容添加到您的项目 Podfile 中

pod 'VDContactPicker', '~> 1.0'

手动安装

只需将 Source 文件夹拖放到您的项目中即可。

需求

• iOS9+
• Swift 4.1
• ARC

对于手动安装，您可能需要在构建阶段添加以下框架： ContactsUI.framework 和 Contacts.framework。

特性

VDContactPicker 提供所有常用功能及自定义功能

[x] 单选和多选选项。[x] 搜索联系人 [x] 配置要显示的联系人数据。（电话号码、电子邮件、生日或组织） [x] 部分索引，方便浏览联系人。 [x] 当图片不可用时显示首字母。 [x] 联系人对象以获取联系人的属性

如果您需要额外的定制功能支持，请创建新问题。

初始化

通过传递委托、多选选项以及要显示的次要数据类型（电话号码、电子邮件、生日或组织）来初始化选择器。

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

委托

VDContactPicker 为您提供了四个用于响应用户选择器事件的方法。

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

联系人对象

VDContact 对象提供了联系人的属性。这包括 displayName、initials、firstName、lastName、company、birthday 等属性。

许可证

VDContactPicker是在MIT许可证下提供的。请参考LICENSE文件以获取更多信息。

贡献者

@vdeep

原始作者 @JettF
@AnthonyMDev
@ipraba
@Sorix