musa-almatri / planet

A country picker view controller for iOS

Planet

A country picker view controller for iOS.

Installation

CocoaPods

You can use CocoaPods to install Planet by adding it to your Podfile:

platform :ios, '10.0'
use_frameworks!
pod 'Planet'

Manually

1. Download and drop /Planet folder in your project.
2. Congratulations!

Example

First, import the library:

 import Planet

Then, create the view controller:

let viewController = CountryPickerViewController()
viewController.delegate = self

after you present it and the user selects a country you will get a callback with the country name, ISO code, and calling code.

func countryPickerViewController(countryPickerViewController: CountryPickerViewController, didSelectCountry country: Country)

Customization

• You can hide the calling codes by toggling showsCallingCodes.
• And you can remove the cancel button, for example if you want to present the view controller by pushing it or in a popover by setting showsCancelButton to false.
• You can show a custom list of countries instead of all countries by supplying a list of ISO codes in the countryCodes property. See the comment in the example project

Contributing

1. Fork it
2. Create your feature branch (git checkout -b my-new-feature)
3. Commit your changes (git commit -am 'Add some feature')
4. Push to the branch (git push origin my-new-feature)
5. Create new Pull Request