country_list_picker 1.0.2⧉

CountryListPicker is flutter package for customizable country selection package with multi-languages support.

Installation

Run this command:

With Flutter:

 $ flutter pub add country_list_picker

This will add a line like this to your package's pubspec.yaml (and run an implicit flutter pub get):

dependencies:
  country_list_picker: ^1.0.2

Alternatively, your editor might support flutter pub get. Check the docs for your editor to learn more.

Now in your Dart code, you can use:

import 'package:country_list_picker/country_list_picker.dart'

Usage

import  'package:country_list_picker/country_list_picker.dart';
void  main() {
    //simple code
    CountryListPicker(
          onCountryChanged: ((value) {
              // do something
          }),
          onChanged: (value) {
             // do something
          },
}

Getting started

Supported 250 countries with common/offical name, iso_3166_1_alpha2, iso_3166_1_alpha3, dialing_code, default_number_length, default_number_format, local_number_sample.

Supported languages:

• Arabic
• Chinese
• Croatian
• Czech
• English
• Estonian
• Finnish
• French
• German
• Hungarian
• Italian
• Japanese
• Korean
• Persian
• Polish
• Portuguese
• Russian
• Slovak
• Spanish
• Swedish
• Urdu

Picker Paramters

    CountryListPicker(
        onCountryChanged: ((value) {
            // do something
        }),
        onChanged: (value) {
            // do something
        },
        initialCountry: Countries.Egypt,
        language: Languages.Arabic,
        isShowDownIcon: picker.isDownIcon,
        isShowCountryTitle: false,   // if you need to hide country title
        displayName: Names.offical,  // if you need to display country offical name
    )

Input Paramters

you can set mask and hintString to default value of each country using onCountryChanged.

    String _hintString ="";
    String _mask ="";
    CountryListPicker(
        onCountryChanged: ((value) {
            _hintString = value.local_number_sample;
            _mask = value.default_number_format;lue
            // do something
        }),
        onChanged: (value) {
            // do something
        },
        inputTheme: InputThemeData(
            hintText: _hintString
            hintStyle: input.hintTextStyle,
            border:  InputBorder.UnderlineInputBorder
            mask: _mask,
          ),
    )

Dialog Paramters

    CountryListPicker(
        onCountryChanged: ((value) {
            // do something
        }),
        onChanged: (value) {
            // do something
        },
        dialogTheme: DialogThemeData(
            isShowFlag: false,          // <- hide dialog flags 
            isShowDialCode: false,      // <- hide dial code 
            isShowFloatButton: false,   // <- hide float button 
            isShowSearchTile: false,    // <- hide search tile 
            isShowLastPickTile: false,  // <- hide last pick tile
            isShowAlphabetsBar: false,  // <- hide alphabets bar 
    )

Alphabets Paramters

Note that: the Country List Picker doesn't support alpabets bar with Chinese, Japanese and Korean languages.

   CountryListPicker(
       onCountryChanged: ((value) {
           // do something
       }),
       onChanged: (value) {
           // do something
       },
       dialogTheme: DialogThemeData(
           alphabetsBarTheme: AlphabetsBarThemeData(
             backgroundColor: Colors.transparent,
             selectedBackgroundColor: Colors.green,  //<- change background of selected item
             // style: ,           // to change unselected alphabet items text style
             // selectedStyle: ,   // to change selected alphabet items text style
           ),
   )

Dialog Tiles Paramters

if you need to show CurrentLocationTile, you must set the localCountry value to country what you want.

Features and bugs

Please file feature requests and bugs at the [issue tracker][tracker]. issue tracker

References.

1. country_list_pick
2. getworld]
3. mask_text_input_formatter