Close Menu

countrypicker

Introduction

CountryPicker is a versatile and easy-to-use library for iOS applications that allows users to select a country from a customizable country picker.

Features

  • Simple and intuitive interface
  • Customizable appearance and behavior
  • Search functionality to quickly find a specific country
  • Support for localized country names
  • Option to display country flags
  • Callback mechanism to handle the selected country

Requirements

The CountryPicker library requires iOS 9.0+ and Xcode 10.0+.

Installation

CountryPicker can be easily installed via CocoaPods. Add the following line to your Podfile:

pod 'CountryPicker'

Then, run the command pod install in the terminal.

Usage

Step 1: Import

In the Swift file where you want to use CountryPicker, import the module:

import CountryPicker

Step 2: Create an instance

Instantiate a CountryPickerViewController by specifying the desired appearance style (optional):

let countryPicker = CountryPickerViewController(style: .grouped)

Step 3: Configure behavior

Customize the picker’s behavior by modifying its properties (optional):

// Set the callback closure to handle the selected country
countryPicker.didSelectCountryClosure = { [weak self] country in
    // Handle the selected country
}

// Hide or show country flags
countryPicker.displayFlag = true

// Enable or disable search functionality
countryPicker.showSearchBar = true

// Set the current country
countryPicker.currentCountry = getCurrentCountry() // Replace with your own implementation

Step 4: Present the picker

To present the picker, embed it in a navigation controller and present it:

// Embed in navigation controller
let navigationController = UINavigationController(rootViewController: countryPicker)

// Present the picker
present(navigationController, animated: true, completion: nil)

Customization

CountryPicker Screenshot

You can easily customize the appearance of the country picker to match your app’s design. The following properties are available for customization:

countryPicker.barTintColor = .white
countryPicker.tableViewBackgroundColor = .lightGray
countryPicker.sectionIndexBackgroundColor = .darkGray
countryPicker.sectionIndexTextColor = .white
// ... and more

Additionally, you can customize the appearance of the country cells by using the cellConfigurationHandler property. For example, you can add a label in the accessory view of each cell:

countryPicker.cellConfigurationHandler = { cell, country in
    let label = UILabel(frame: CGRect(x: 0, y: 0, width: 60, height: 30))
    label.text = country.dialingCode
    cell.accessoryView = label
}

Localization

CountryPicker supports localization out of the box. The library uses the device’s current locale to display the country names in the appropriate language. Additionally, you can force a specific language to be used regardless of the device’s settings by setting the forceLocale property:

countryPicker.forceLocale = Locale(identifier: "fr_FR")

Conclusion

CountryPicker is a powerful and flexible library that makes it easy to integrate country selection functionality into your iOS app. It provides a customizable and user-friendly country picker, with support for localization and various configuration options. With CountryPicker, you can enhance the user experience and streamline the process of selecting countries in your app.