ContactsSuggestionTextField

这是一个简单且适应性强的 UITextField 子类，它为文本框的输入附件视图附加了一个联系人选择器，以实现无缝的联系人访问。

键盘外观 – 深色 / 浅色

注意：此库使用 Contacts.framework，因此需要在一个合适的理由中在应用的 Info.plist 中提供 NSContactsUsageDescription。

功能

• 集成联系人访问和权限处理。
• 在电话号码和电子邮件地址之间进行选择。
• 适应性 UI。

用法

要开始使用此组件，请按照安装部分使用 Carthage 或手动添加到项目。

可以通过ContactsSuggestionTextField类使用UI组件。此控件的使用方法非常类似UITextField——既可以从Interface Builder中，也可以从代码中进行。

要创建类的实例，可以使用Interface Builder，或从代码中进行。以下示例将创建一个字段，显示联系人的简称和电子邮件地址。

let textField = ContactsSuggestionTextField(frame: CGRect(x: 10, y: 10, width: 200, height: 45))

/// customize the textfield.
/// For Interface Builder, an IBOutlet can be created and the customization can be done as illustrated below.
textField.customize = { builder in
    builder.contactNameStyle = .short
    builder.contactType = .emailAddress
}
self.view.addSubview(textField)

当用户选择联系人时，可以执行以下操作

tf.contactSelectedHandler = { [weak self] contact: String in
    // do something with contact
}

安装

CocoaPods

控件通过CocoaPods提供。可以使用Ruby gems安装CocoaPods。

$ gem install cocoapods

然后，只需将ContactsSuggestionTextField添加到Podfile中。

pod 'ContactsSuggestionTextField', '~> 0.0.3'

最后，运行以下命令以让CocoaPods获取组件的最新版本。

$ pod update

Carthage

组件支持Carthage。首先请确保已安装Carthage的最新版本。使用Homebrew运行以下命令：

$ brew update
$ brew install carthage

然后，将ContactsSuggestionTextField添加到Cartfile中。

github "paulsumit1993/ContactsSuggestionTextField"

最后，将框架添加到您的App的Xcode项目中。在“构建阶段”部分将框架链接到您的App并将框架复制到App的框架目录中。

手动

您可以从我们的发布页面下载最新的文件。之后，将ContactsSuggestionTextField文件夹中的文件复制到您的项目中。

贡献

我们欢迎所有的贡献。只需提出一个问题或提交合并请求，我们将继续推进。