{"id":15293693,"url":"https://github.com/paulsumit1993/contactssuggestiontextfield","last_synced_at":"2025-09-11T10:34:47.467Z","repository":{"id":56906553,"uuid":"160042705","full_name":"paulsumit1993/ContactsSuggestionTextField","owner":"paulsumit1993","description":"Contact Picker UITextField","archived":false,"fork":false,"pushed_at":"2019-11-30T15:33:41.000Z","size":21246,"stargazers_count":15,"open_issues_count":0,"forks_count":2,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-04-13T14:09:54.638Z","etag":null,"topics":["autocomplete","autocomplete-suggestions","carthage","interface-builder","ios","ios-contacts","keyboard","search","storyboard","swift4","textfield","ui-components","uicontrol","uikit","uitextfield","xcode10"],"latest_commit_sha":null,"homepage":"","language":"Swift","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/paulsumit1993.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2018-12-02T12:00:22.000Z","updated_at":"2025-02-24T04:07:13.000Z","dependencies_parsed_at":"2022-08-20T19:20:22.391Z","dependency_job_id":null,"html_url":"https://github.com/paulsumit1993/ContactsSuggestionTextField","commit_stats":null,"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/paulsumit1993%2FContactsSuggestionTextField","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/paulsumit1993%2FContactsSuggestionTextField/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/paulsumit1993%2FContactsSuggestionTextField/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/paulsumit1993%2FContactsSuggestionTextField/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/paulsumit1993","download_url":"https://codeload.github.com/paulsumit1993/ContactsSuggestionTextField/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248724629,"owners_count":21151561,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["autocomplete","autocomplete-suggestions","carthage","interface-builder","ios","ios-contacts","keyboard","search","storyboard","swift4","textfield","ui-components","uicontrol","uikit","uitextfield","xcode10"],"created_at":"2024-09-30T16:50:37.950Z","updated_at":"2025-04-13T14:10:11.672Z","avatar_url":"https://github.com/paulsumit1993.png","language":"Swift","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ContactsSuggestionTextField\n[![documentation](./docs/badge.svg)](https://paulsumit1993.github.io/ContactsSuggestionTextField/) [![iOS](https://img.shields.io/badge/platform-iOS_10+-blue.svg?style=flat)](https://developer.apple.com/ios/) [![Swift 4+](https://img.shields.io/badge/Swift-4.0+-F16D39.svg?style=flat)](https://swift.org) [![Carthage compatible](https://img.shields.io/badge/Carthage-compatible-4BC51D.svg?style=flat)](https://github.com/Carthage/Carthage) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n\nA simple and adaptive UITextField subclass which attaches a contact picker to the textfield's input accessory view for seamless contact access. \n\n#### Keyboard Appearance - Dark / Light\n\u003cimg src=\"/screenshots/screen-dark.png\" height=\"355\" width=\"200\"/\u003e  \u003cimg src=\"/screenshots/screen-light.png\" height=\"355\" width=\"200\"/\u003e\n\n\u003cimg src=\"/screenshots/white-accessory-view.gif\" height=\"355\" width=\"200\"/\u003e  \u003cimg src=\"/screenshots/dark-accessory-view.gif\" height=\"355\" width=\"200\"/\u003e\n\n##### Note: This Library uses Contacts.framework and hence one needs to provide `NSContactsUsageDescription` in the app's `Info.plist` specifying an appropriate reason.\n\n## Features\n\n* Integrated Contacts Access and Permission Handling.\n* Choose between phone number and e-mail address.\n* Adaptable UI.\n\n## Docs\n\nDocumentation can be found [here](https://paulsumit1993.github.io/ContactsSuggestionTextField/).\n## Usage\n\nTo start using the component add it to your project using Carthage or manually as per the [Installation](#installation) section.\n\nThe UI component can be used via the `ContactsSuggestionTextField` class. This control can be used very similar to `UITextField` - both from Interface Builder, or from code.\n\nTo create an instance of the class, use Interface builder, or do it from code. This example will create a field which shows a short name and email address of a contact:\n\n```swift\nlet textField = ContactsSuggestionTextField(frame: CGRect(x: 10, y: 10, width: 200, height: 45))\n\n/// customize the textfield.\n/// For Interface Builder, an IBOutlet can be created and the customization can be done as illustrated below.\ntextField.customize = { builder in\n    builder.contactNameStyle = .short\n    builder.contactType = .emailAddress\n}\nself.view.addSubview(textField)\n```\n\nDo something when the user selects a contact like the following:\n\n```swift\ntf.contactSelectedHandler = { [weak self] contact: String in\n    // do something with contact\n}\n```\n\n# Installation\n\n#### CocoaPods\nThe control is available through [CocoaPods](https://cocoapods.org/). CocoaPods can be installed using [Ruby gems](https://rubygems.org/):\n```shell\n$ gem install cocoapods\n```\n\nThen simply add `ContactsSuggestionTextField` to your Podfile:\n\n```\npod 'ContactsSuggestionTextField', '~\u003e 0.0.3'\n```\n\nLastly, let CocoaPods fetch the latest version of the component by running:\n```shell\n$ pod update\n```\n\n#### Carthage\nThe component supports [Carthage](https://github.com/Carthage/Carthage). Start by making sure you have the latest version of Carthage installed. Using [Homebrew](http://brew.sh/) run this:\n```shell\n$ brew update\n$ brew install carthage\n```\nThen add `ContactsSuggestionTextField` to your `Cartfile`:\n```\ngithub \"paulsumit1993/ContactsSuggestionTextField\"\n```\nFinally, add the framework to the Xcode project of your App. Link the framework to your App and copy it to the App’s Frameworks directory via the “Build Phases” section.\n\n#### Manual\n\nYou can download the latest files from our [Releases page](https://github.com/paulsumit1993/ContactsSuggestionTextField/releases). After doing so, copy the files in the `ContactsSuggestionTextField` folder to your project.\n\n## Contributing\n\nWe welcome all contributions. Just open an issue or submit pull requests, and we will take it forward.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpaulsumit1993%2Fcontactssuggestiontextfield","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpaulsumit1993%2Fcontactssuggestiontextfield","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpaulsumit1993%2Fcontactssuggestiontextfield/lists"}