Advance Country Picker

advance_country_picker is a Flutter package that provides a customizable country picker widget. This package includes functionalities for selecting countries, displaying flags, and parsing phone numbers with country codes. It is easy to integrate into your Flutter applications. You can get countries list, get country by name, by country code, by nationality and by dial code. There two ways to select a country using dialogue and bottomsheet.

Package Functionality

Features

Customizable country picker widget
Customizable country phone input field
Customizable dialoge and bottomsheet
Displays country flags
get countries list
Provides methods to get and set phone number and country programmatically
get country by country code
get country by country name
get country by dial code
get country by nationality
Parses phone numbers with country codes
phone number formatters
Validation: Validate based on type (mobile, fixed line, voip)
Formatting: Format phone number for a specific country
Phone ranges: find all phone numbers in a range of phone numbers
Find phone numbers in a text
Supports eastern arabic digits
Uses best-in-class metadata from Google's libPhoneNumber project.

Installation

Add advance_country_picker to your pubspec.yaml:

dependencies:
  advance_country_picker: ^1.0.0

Then run flutter pub get to install the package.

Usage

You can use the AdvanceCountryPickerWidget to display a list of countries with search functionality:

import 'package:flutter/material.dart';
import 'package:advance_country_picker/advance_country_picker.dart';

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: Text('Advance Country Picker Example'),
        ),
        body: Center(
          child: AdvanceCountryPickerWidget(
            onSelected: (Country? country) {
              // Handle country selection
              print('Selected country: ${country?.name}');
            },
          ),
        ),
      ),
    );
  }
}

Phone Number Input with Country Code

The PhoneNumberInput widget allows users to input phone numbers with a customizable country code selector. You can get the input phone number and set the country and phone number programmatically.

import 'package:flutter/material.dart';
import 'package:advance_country_picker/advance_country_picker.dart';

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: Text('Phone Number Input Example'),
        ),
        body: Center(
          child: PhoneNumberInput(
            onPhoneNumberChanged: (phoneNumber, country) {
              // Handle phone number change
              print('Phone number: $phoneNumber, Country: ${country?.name}');
            },
          ),
        ),
      ),
    );
  }
}

Getting and Setting Phone Number Programmatically

You can get the input phone number and set the country and phone number programmatically using methods provided by the PhoneNumberInput widget.

import 'package:flutter/material.dart';
import 'package:advance_country_picker/advance_country_picker.dart';

class MyAppState extends State<MyApp> {
  final PhoneNumberInput _phoneNumberInput = PhoneNumberInput();

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: Text('Phone Number Input Example'),
        ),
        body: Column(
          children: [
            _phoneNumberInput,
            ElevatedButton(
              onPressed: () {
                // Get the input phone number
                String phoneNumber = _phoneNumberInput.phoneNumber;
                print('Phone number: $phoneNumber');
              },
              child: Text('Get Phone Number'),
            ),
            ElevatedButton(
              onPressed: () {
                // Set the country and phone number programmatically
                _phoneNumberInput.setCountryAndPhoneNumber(
                  Country(name: 'United States', countryCode: 'US', dialCode: '+1', flag: 'assets/flags/us.png'),
                  '1234567890',
                );
              },
              child: Text('Set Country and Phone Number'),
            ),
          ],
        ),
      ),
    );
  }
}

Parsing Phone Numbers

The advance_country_picker package also includes functionality from the phone_numbers_parser package to parse and validate phone numbers.

import 'package:advance_country_picker/phone_numbers_parser.dart';

void main() {
  PhoneNumberParser parser = PhoneNumberParser();
  PhoneNumber phoneNumber = parser.parse('+14155552671');

  print('Country: ${phoneNumber.country}');
  print('National Number: ${phoneNumber.nationalNumber}');
}

Customizing Widgets

You can customize various aspects of the widgets provided by advance_country_picker: