https://github.com/kwallet/planet

A country picker view controller for iOS
https://github.com/kwallet/planet

Last synced: 6 days ago
JSON representation

A country picker view controller for iOS

• Host: GitHub
• URL: https://github.com/kwallet/planet
• Owner: kwallet
• License: mit
• Created: 2016-07-12T17:23:58.000Z (over 8 years ago)
• Default Branch: master
• Last Pushed: 2019-12-20T18:21:10.000Z (almost 5 years ago)
• Last Synced: 2024-04-24T14:51:01.126Z (8 months ago)
• Language: Swift
• Homepage:
• Size: 269 KB
• Stars: 70
• Watchers: 5
• Forks: 27
• Open Issues: 5
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-ios - planet - A country picker (UI / PickerView)
• awesome-ios-star - planet - A country picker (UI / PickerView)

README

        
# Planet

A country picker view controller for iOS.



## Installation

#### CocoaPods

You can use [CocoaPods](http://cocoapods.org/) to install `Planet` by adding it to your `Podfile`:

```ruby

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:

```swift

 import Planet

```

Then, create the view controller:

```swift

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.

```swift

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