1. Add dependency
-
dependencies { implementation 'com.hbb20:android-country-picker:X.Y.Z' } - For latest version,
2. Decide your use-case
Default Country Picker View
i. add following to your XML layout <com.hbb20.CountryPickerView
android:id="@+id/countryPicker"
android:layout_width="wrap_content"
android:layout_height="wrap_content" />
ii. modify view / dialog / list config in activity or fragment
private fun setupCountryPickerView() {
val countryPicker = findViewById<CountryPickerView>(R.id.countryPicker)
// Modify CPViewConfig if you need. Access cpViewConfig through `cpViewHelper`
countryPicker.cpViewHelper.cpViewConfig.viewTextGenerator = { cpCountry: CPCountry ->
"${cpCountry.name} (${cpCountry.alpha2})"
}
// make sure to refresh view once view configuration is changed
countryPicker.cpViewHelper.refreshView()
// Modify CPDialogConfig if you need. Access cpDialogConfig through `countryPicker.cpViewHelper`
// countryPicker.cpViewHelper.cpDialogConfig.
// Modify CPListConfig if you need. Access cpListConfig through `countryPicker.cpViewHelper`
// countryPicker.cpViewHelper.cpListConfig.
// Modify CPRowConfig if you need. Access cpRowConfig through `countryPicker.cpViewHelper`
// countryPicker.cpViewHelper.cpRowConfig.
}
ii. Read More about Country Picker View and available configuration
Custom Country Picker View
i. Read how to create your Custom Country Picker View
Launch Country Picker Dialog
i. add following to your Activity/Fragment context.launchCountryPickerDialog { selectedCountry: CPCountry? ->
// your code to handle selected country
}
ii. Read More about CountryPicker Dialog and available configuration
Load countries in RecyclerView
i. add following to your Activity/Fragment recyclerView.loadCountries { selectedCountry: CPCountry ->
// your code to handle selected country
}
ii. Read More about Country List and available configuration
Credits
- ip2Location for country data
- Airbnb for Epoxy Recycler View library
2.5k Dec 23, 2022
468 Dec 9, 2022
22 Sep 7, 2022
5.1k Dec 26, 2022
1.2k Jan 7, 2023
129 Dec 24, 2022
547 Jan 5, 2023
5.6k Dec 30, 2022
755 Dec 29, 2022
1.3k Nov 25, 2022
77 Dec 9, 2022
503 Dec 30, 2022
615 Nov 14, 2022
3.6k Dec 29, 2022
799 Nov 14, 2022
786 Jan 6, 2023
53 Oct 17, 2022
2.6k Jan 3, 2023