Description

This package provides drop-down items for selecting countries and states.

Features
  • Select Country
  • Select State per selected country
  • Pass validators to validate country and state when submitting form
Parameters
Param Required Default Type Description
onCountryChanged ✅ null Function (String) Handle Country Selection
onStateChanged ✅ null Function (String) Handle State Selection
onStateTap ❌ null void Handle Input onTap Event
onStateTap ❌ null void Handle Input onTap Event
flagSize ❌ 22.0 double Size of Country Flag on Input Label
listFlagSize ❌ 22.0 double Size of Country Flag on List Label
inputDecoration ❌ -- InputDecoration Style for InputFields
hintTextStyle ❌ -- TextStyle Style for Hint Text of Input
itemTextStyle ❌ -- TextStyle Style for Text of DropdownItem
dropdownColor ❌ Grey Color Style for Text of DropdownItem
elevation ❌ 0 int Elevation of Dropdown List
isExpanded ❌ true bool Determines if Input field should fill parent width
divider ❌ -- Widget Widget to create space or style between the country and state field
countryLabel ❌ -- Widget Label for country field
stateLabel ❌ -- Widget Label for state field
countryHintText ❌ -- String hintText for country field
stateHintText ❌ -- String hintText for state field
noStateFoundText ❌ -- String Hint to ack no states exist on the selected country (eg. Aruba)
onCountryChanged ❌ null Function (String) Validate Country Selection on Submition
onStateChanged ❌ null Function (String) Validate State Selection on Submition

How To Use

  1. Import the package

    import 'package:country_state_picker/country_state_picker.dart';

  2. Provide at least the required params

    CountryStatePicker(
  onCountryChanged: (ct) => setState(() {
      country = ct;
      state = null;
    }),
    onStateChanged: (st) => setState(() {
      state = st;
    }),
 ),

Todo

  • x Select Country
  • x Select State
  • x Validate Country
  • x Validate State
  • x Create Select City
  • Add Select City
  • Add Variants to the widget

Libraries

components/index
country_state_picker
models/country
models/state
utils/index