https://github.com/kwallet/planet
A country picker view controller for iOS
https://github.com/kwallet/planet
Last synced: 18 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 9 years ago)
- Default Branch: master
- Last Pushed: 2019-12-20T18:21:10.000Z (about 6 years ago)
- Last Synced: 2025-12-02T08:15:46.305Z (3 months ago)
- Language: Swift
- Homepage:
- Size: 269 KB
- Stars: 72
- Watchers: 3
- Forks: 26
- 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)
- fucking-awesome-ios - 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