country_picker 2.0.4
country_picker: ^2.0.4 copied to clipboard

A flutter package to select a country from a list of countries.

Country picker #

pub package

A flutter package to select a country from a list of countries.

n1

Getting Started #

Add the package to your pubspec.yaml:

 country_picker: ^2.0.4

In your dart file, import the library:

 import 'package:country_picker/country_picker.dart';

Show country picker using showCountryPicker:

showCountryPicker(
   context: context,
   showPhoneCode: true, // optional. Shows phone code before the country name.
   onSelect: (Country country) {
      print('Select country: ${country.displayName}');
   },
);

For localization: #

Add the CountryLocalizations.delegate in the list of your app delegates.

MaterialApp(
      supportedLocales: [
        const Locale('en'),
        const Locale('el'),
        const Locale.fromSubtags(languageCode: 'zh', scriptCode: 'Hans'), // Generic Simplified Chinese 'zh_Hans'
        const Locale.fromSubtags(languageCode: 'zh', scriptCode: 'Hant'), // Generic traditional Chinese 'zh_Hant'
      ],
      localizationsDelegates: [
        CountryLocalizations.delegate,
        GlobalMaterialLocalizations.delegate,
        GlobalWidgetsLocalizations.delegate,
      ],
      home: HomePage(),
 );

Parameters: #

  • onSelect: Called when a country is select. The country picker passes the new value to the callback (required)
  • onClosed: Called when CountryPicker is dismiss, whether a country is selected or not (optional).
  • showPhoneCode: Can be used to to show phone code before the country name.
  • countryListTheme: Can be used to customizing the country list bottom sheet. (optional).
    showCountryPicker(
      context: context,
      countryListTheme: CountryListThemeData(
        flagSize: 25,
        backgroundColor: Colors.white,
        textStyle: TextStyle(fontSize: 16, color: Colors.blueGrey),
      ),
      onSelect: (Country country) => print('Select country: ${country.displayName}'),
    );
    
  • exclude: Can be used to exclude(remove) one or more country from the countries list (optional).
    showCountryPicker(
      context: context,
      exclude: <String>['KN', 'MF'], //It takes a list of country code(iso2).
      onSelect: (Country country) => print('Select country: ${country.displayName}'),
    );
    
  • countryFilter: Can be used to uses filter the countries list (optional).
    • It takes a list of country code(iso2).
    • Can't provide both exclude and countryFilter

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.

16
likes
130
pub points
93%
popularity

A flutter package to select a country from a list of countries.

Homepage
Repository (GitHub)
View/report issues

Documentation

API reference

Uploader

dioann28@gmail.com

License

MIT (LICENSE)

Dependencies

flutter

More

Packages that depend on country_picker