Kompose Country Code Picker is a Jetpack Compose library based on Material 3 (M3) that provides a country code picker for Android apps.
Picker | Dialog | Picker Only |
---|---|---|
![]() |
![]() |
![]() |
Jetpack compose material three
dependency - implementation("androidx.compose.material3:material3:<version>")
Note: The library is now hosted on Maven Central. If you were using the previous version hosted on Jitpack, please update your dependencies to the latest version. The last version hosted on Jitpack was :
implementation("com.github.JoelKanyi:KomposeCountryCodePicker:1.1.2")
repositories {
mavenCentral()
}
dependencies {
implementation("io.github.joelkanyi:komposecountrycodepicker:<latest-version>")
}
[versions]
komposecountrycodepicker = "<latest-version>"
[libraries]
komposecountrycodepicker = { module = "io.github.joelkanyi:komposecountrycodepicker", version.ref = "komposecountrycodepicker" }
val state = rememberKomposeCountryCodePickerState()
The state
parameter is used to set and access different variables/methods that are available in the KomposeCountryCodePicker
composable.
val state = rememberKomposeCountryCodePickerState(
limitedCountries = listOf("KE", "UG", "TZ", "RW", "SS"),
showCountryCode = true,
showCountryFlag = true,
defaultCountryCode = "TZ",
)
showCountryCode
- Iftrue
, the country code will be displayed in the country code pickerTextField
showCountryFlag
- Iftrue
, the country flag will be displayed in the country code pickerTextField
defaultCountryCode
- Sets the default country code to be displayed in the country code pickerlimitedCountries
- Limits the list of countries to be displayed in the country code picker by specify the country codes, country names or country phone codes i.elistOf("KE", "UG", "TZ")
,listOf("Kenya", "Uganda", "Tanzania")
orlistOf("+254", "+256", "+255")
val phoneNumber = rememberSaveable { mutableStateOf("") }
val state = rememberKomposeCountryCodePickerState()
KomposeCountryCodePicker(
modifier = Modifier
.fillMaxWidth(),
text = phoneNumber.value,
onValueChange = { phoneNumber.value = it },
placeholder = { Text(text = "Phone Number") },
shape = MaterialTheme.shapes.medium,
colors = TextFieldDefaults.colors(
unfocusedContainerColor = Color.Transparent,
focusedContainerColor = Color.Transparent,
),
state = state,
interactionSource = MutableInteractionSource(),
)
With the showOnlyCountryCodePicker
parameter set to true
, the KomposeCountryCodePicker
composable can be used without the TextField
.
val state = rememberKomposeCountryCodePickerState()
KomposeCountryCodePicker(
modifier = Modifier,
showOnlyCountryCodePicker = true,
text = phoneNumber.value,
state = state,
)
val phoneNumber = rememberSaveable { mutableStateOf("") }
val state = rememberKomposeCountryCodePickerState()
TextField(
modifier = Modifier
.fillMaxWidth(),
value = phoneNumber.value,
onValueChange = { phoneNumber.value = it },
placeholder = { Text(text = "Phone Number") },
leadingIcon = {
KomposeCountryCodePicker(
modifier = Modifier,
showOnlyCountryCodePicker = true,
text = phoneNumber.value,
state = state,
)
},
colors = TextFieldDefaults.colors(
unfocusedContainerColor = Color.Transparent,
focusedContainerColor = Color.Transparent,
),
)
Customization | Description |
---|---|
placeholder |
Sets the placeholder Composable for the country code picker |
shape |
Sets the shape of the country code picker TextField |
error |
Sets the error state on the TextField for the country code picker |
colors |
Sets the colors for the country code picker TextField |
showOnlyCountryCodePicker |
Shows only the country code picker without the TextField |
state |
The state of the country code picker |
countrySelectionDialogContainerColor |
The color of the country selection dialog container |
countrySelectionDialogContentColor |
The color of the country selection dialog content |
pickerContentColor |
The color of the country code picker content i.e country name, code, and dropdown icon |
interactionSource |
The MutableInteractionSource representing the stream of Interactions for this text field. |
Use the state that you defined (val state = rememberKomposeCountryCodePickerState()
) to access the
following methods/variables:
Description | Method |
---|---|
countryCode |
Returns the country code for the selected country |
phoneNumber |
Returns the phone number entered by the user |
Country Phone No Code | state.getCountryPhoneCodeWithoutPrefix() |
Country Name | state.getCountryName() |
Country Language Code | state.getCountryCodeWithoutPrefix() |
Phone Number Without Prefix | state.getPhoneNumberWithoutPrefix() |
Full Phone Number | state.getFullPhoneNumber() |
Full Phone Number Without Prefix | state.getFullPhoneNumberWithoutPrefix() |
Phone Number State | state.isPhoneNumberValid() |
Any contributions, large or small, major features, bug fixes, are welcomed and appreciated but will be thoroughly reviewed.
Copyright 2023 Joel Kanyi
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.