Ein Flutter-Paket zum Anzeigen eines Ländercodes-Auswahl-Widgets. Darüber hinaus ermöglicht es die Auswahl einer Liste bevorzugter Länder sowie die Suche über eine einfache Suchleiste.
Aus öffentlichen Paketdaten erstellte Orientierung.
Ein Flutter-Paket, das einen Ländercode-Auswähler mit Unterstützung für bevorzugte Länder und Suchfunktion bietet. Es ermöglicht Benutzern, einfach ein Land aus einer umfangreichen Liste auszuwählen, ihre bevorzugten Länder anzupassen und Länder mithilfe einer Suchleiste schnell zu finden. Ideal für Formulare, die internationale Telefonnummern erfordern, unterstützt es mehrere Plattformen wie Android, iOS, Web, macOS, Windows und Linux. Das Paket ist leichtgewichtig, anpassbar und lässt sich nahtlos in bestehende Flutter-Anwendungen integrieren.
Anwendungsfälle
Internationale Telefonnummer-Eingabe
Benutzerprofil-Einrichtung mit Länderauswahl
Mehrsprachige oder regionenbasierte App-Funktionen
Landauswahl für Reise- oder Versandformular
Anpassbare Länder-Favoritenliste
Hauptmerkmale
Suchbare Länderliste
Favoritenverwaltung
Plattformübergreifende Kompatibilität
Einfache Integration mit Flutter-Formularen
Anpassbare Benutzeroberfläche und Verhalten
Unterstützung für ISO 3166-Ländercodes
Geeignet für
Apps, die internationale Telefonnummern erforderlich machen
Entwickler, die weltweit ausgerichtete Anwendungen erstellen
Formulare, die landesspezifische Daten erfordern
Projekte, die mehrere Regionen oder Sprachen unterstützen
Benutzer, die einen sauberen, interaktiven Länderauswahl-Widget möchten
Hinweise
Manuelle Handhabung des ausgewählten Landcodes in Formularen erforderlich
Begrenzte Anpassungsmöglichkeiten für den Suchalgorithmus
Möglicherweise sind zusätzliche Stile erforderlich, um eine konsistente Darstellung über Plattformen hinweg zu gewährleisten
Enthält keine integrierte Überprüfung für Telefonnummern
Hängt von externer Quelle für Länderdaten ab
Original-README
Originaler README-Schnappschuss aus dem verknüpften Quell-Repository. Aktuelle Inhalte finden Sie im Repository.
A flutter package for showing a country code selector.
It supports i18n for 70 languages.
Check the example on web! https://imtoori.dev/CountryCodePicker/#/
Usage
Just put the component in your application setting the onChanged callback.
@overrideWidgetbuild(BuildContext context) => newScaffold(
body: Center(
child: CountryCodePicker(
onChanged: print,
// Initial selection and favorite can be one of code ('IT') OR dial_code('+39')
initialSelection: 'IT',
favorite: ['+39','FR'],
// optional. Shows only country name and flag
showCountryOnly: false,
// optional. Shows only country name and flag when popup is closed.
showOnlyCountryWhenClosed: false,
// optional. aligns the flag and the Text left
alignLeft: false,
),
),
);
Example:
void_onCountryChange(CountryCode countryCode) {
//TODO : manipulate the selected country code hereprint("New Country selected: " + countryCode.toString());
}
i18n
Just add the CountryLocalizations.delegate in the list of your app delegates
Here is a list of properties available to customizeccc your widget:
Name
Type
Description
onChanged
ValueChanged
callback invoked when the selection changes
onInit
ValueChanged
callback invoked during initialization of the widget
initialSelection
String
used to set the initial selected value
favorite
List
used to populate the favorite country list
textStyle
TextStyle
TextStyle applied to the widget button
padding
EdgeInsetsGeometry
the padding applied to the button
showCountryOnly
bool
true if you want to see only the countries in the selection dialog
searchDecoration
InputDecoration
decoration applied to the TextField search widget
searchStyle
TextStyle
style applied to the TextField search widget text
emptySearchBuilder
WidgetBuilder
use this to customize the widget used when the search returns 0 elements
builder
Function(CountryCode)
use this to build a custom widget instead of the default FlatButton
enabled
bool
set to false to disable the widget
textOverflow
TextOverflow
the button text overflow behaviour
dialogSize
Size
the size of the selection dialog
countryFilter
List
uses a list of strings to filter a sublist of countries
showOnlyCountryWhenClosed
bool
if true it'll show only the country
alignLeft
bool
aligns the flag and the Text to the left
showFlag
bool
shows the flag everywhere
showFlagMain
bool
shows the flag only when closed
showFlagDialog
bool
shows the flag only in dialog
flagWidth
double
the width of the flags
flagDecoration
Decoration
used for styling the flags
comparator
Comparator
use this to sort the countries in the selection dialog
hideSearch
bool
if true the search feature will be disabled
Contributions
Contributions of any kind are more than welcome! Feel free to fork and improve country_code_picker in any way you want, make a pull request, or open an issue.
Getting involved
First of all, thank you for even considering to get involved. You are a real super :star: and we :heart: you!
Reporting bugs and issues
Use the configured Github issue report template when reporting an issue. Make sure to state your observations and expectations
as objectively and informative as possible so that we can understand your need and be able to troubleshoot.
Discussions and ideas
We're happy to discuss and talk about ideas, post your
question to StackOverflow.
Contributors ✨
Thanks goes to these wonderful people (emoji key):