intl_mobile_field

- **New** Added `searchBy` to customize country search behavior in th…

…e picker dialog

- **New** Supports searching by country name, dial code, or both
- **New** `SearchBy.both` is now the default search behavior
- Readme file updated.

• New Added searchBy to customize country search behavior in the picker dialog
• New Supports searching by country name, dial code, or both
• New SearchBy.both is now the default search behavior
• Readme file updated.

• New Added searchBy to customize country search behavior in the picker dialog

• New Supports searching by country name, dial code, or both

• New SearchBy.both is now the default search behavior

• Readme file updated.

Fix image tag formatting in README.md

• New Added resetCountryOnClearField to restore the initial country when the field is cleared
• New Added excludeCountries to exclude specific countries from the picker
• New Added onMaxLengthReached callback for maximum number length detection

• New Added resetCountryOnClearField to restore the initial country when the field is cleared

• New Added excludeCountries to exclude specific countries from the picker

• New Added onMaxLengthReached callback for maximum number length detection

• Breaking: FlagDropDown renamed to CountryDropDown
• Flexible display: From CountryDropDown you can use what you need (country name, code, flag, or any combination)
• Full RTL & LTR support
• Complete UI customization control
• Example code: cleaner and more understandable

• Breaking : FlagDropDown renamed to CountryDropDown

• Flexible display : From CountryDropDown you can use what you need (country name, code, flag, or any combination)

• Full RTL & LTR support

• Complete UI customization control

• Example code: cleaner and more understandable

• ‍Dart format

Fixed

• Resolved issue with country search: now typing partial country names (e.g., “U”) correctly filters all matching countries instead of requiring exact matches. #52
• Updated getCountry method to allow specifying countryISOCode, preventing incorrect country selection when multiple countries share the same dial code. #53

Improved

• Search functionality is now case-insensitive and supports substring matching.

🙏 Thanks

Big thanks to @serhii-ovchar-ew for contributing validating mobile numbers that already have country information!

Fixed

• Resolved issue with country search: now typing partial country names (e.g., “U”) correctly filters all matching countries instead of requiring exact matches. #52

• Updated getCountry method to allow specifying countryISOCode , preventing incorrect country selection when multiple countries share the same dial code. #53

Improved

• Search functionality is now case-insensitive and supports substring matching.

🙏 Thanks

Big thanks to @serhii-ovchar-ew for contributing validating mobile numbers that already have country information !

Fixed

• +44 [UK] The limit on the length of the number is incorrect. #51

Fixed

• +44 [UK] The limit on the length of the number is incorrect. #51

Fixed

• Fixed disableLengthCounter true does not fully disable counter #45

Fixed

• Fixed disableLengthCounter true does not fully disable counter #45

v 2.1.0

Development

Fixed

• RangeError when typing input in IntlMobileField #39
• controller/initialValue issues fixed #35

Added

• 🌏 Vietnamese language support for translations
• countries now accepts a List<String> of country codes or dial codes see Example
• Limit which countries appear in the picker dialog
• Custom styling support for the maxLength counter using lengthCounterTextStyle
• Set the height of the country Picker DialogBox using countryPickerDialogBoxHeight

🙏 Thanks

Big thanks to @tAnAs7 for contributing Vietnamese language support!

Fixed

• RangeError when typing input in IntlMobileField #39

• controller / initialValue issues fixed #35

Added

• 🌏 Vietnamese language support for translations

• countries now accepts a List<String> of country codes or dial codes see Example

• Limit which countries appear in the picker dialog

• Custom styling support for the maxLength counter using lengthCounterTextStyle

• Set the height of the country Picker DialogBox using countryPickerDialogBoxHeight

🙏 Thanks

Big thanks to @tAnAs7 for contributing Vietnamese language support !

Merge pull request #34 from MdAshrafUllah/development

Development

Fixed

• Resolved an issue where onCountryChanged was not being invoked correctly.
• Fixed an issue where initialCountryCode was not setting the input length properly on initialization.

Fixed

• Resolved an issue where onCountryChanged was not being invoked correctly.

• Fixed an issue where initialCountryCode was not setting the input length properly on initialization.

Newly Added

• New Add translations for Portuguese languages.

Changed

• We have removed the prefixIcon from IntlMobileField. Now, users have to pass all attributes for FlagsDropDown directly in IntlMobileField.

Improved

• Now the length will not be stuck at 10 digits for all countries.
• Now able to make the field optional.
• Now initialValue will change the default country flag.

Notes

• The user can still use FlagsDropDown separately anywhere.

Newly Added

• New Add translations for Portuguese languages.

Changed

• We have removed the prefixIcon from IntlMobileField . Now, users have to pass all attributes for FlagsDropDown directly in IntlMobileField .

Improved

• Now the length will not be stuck at 10 digits for all countries.

• Now able to make the field optional.

• Now initialValue will change the default country flag.

Notes

• The user can still use FlagsDropDown separately anywhere.

Newly Added

• FlagImage widget - Easily display any country's flag anywhere in your UI.
• FlagsDropDown widget - A fully customizable country selector with dialog support.
• Support for custom validation - Pass a custom validator function with both sync and async validation handling.
• Users can now add prefixIcon and suffixIcon in IntlMobileField.
• FlagsDropDown appears in the prefixIcon by default for IntlMobileField, but can be overridden.

Changed

• Updated phone number length validation for Seychelles to match accurate formatting rules.

Improved

• Introduced debounced async validation to prevent overlapping validator calls and improve performance.
• Developers can fully customize or replace the flag dropdown by injecting their own FlagsDropDown.
• Added configuration options to hide flags, country codes, or dropdown icons both in the field and dialog.

Notes

• Flutter's native validator is not async, so async validation is handled internally via onChanged, with a debounce.
• For real-time validation feedback, use the onChanged callback and manage UI state accordingly.
• Explore the package for knowing what new in it.

Newly Added

• FlagImage widget - Easily display any country's flag anywhere in your UI.

• FlagsDropDown widget - A fully customizable country selector with dialog support.

• Support for custom validation - Pass a custom validator function with both sync and async validation handling.

• Users can now add prefixIcon and suffixIcon in IntlMobileField .

• FlagsDropDown appears in the prefixIcon by default for IntlMobileField , but can be overridden.

Changed

• Updated phone number length validation for Seychelles to match accurate formatting rules.

Improved

• Introduced debounced async validation to prevent overlapping validator calls and improve performance.

• Developers can fully customize or replace the flag dropdown by injecting their own FlagsDropDown .

• Added configuration options to hide flags, country codes , or dropdown icons both in the field and dialog.

Notes

• Flutter's native validator is not async, so async validation is handled internally via onChanged , with a debounce.

• For real-time validation feedback, use the onChanged callback and manage UI state accordingly.

• Explore the package for knowing what new in it.

• New Add translations for [Bangla], [Hindi], [Urdu] languages.
• New RTL Support for Translations of Right-to-Left Languages
• added Kosovo localization messages
• update [README.md] file with translations listed Country and RLT,LRT Output.
• New screenshot(thumbnail) added.

• fixed Readme file image URLs

• fixed Readme file image URLs

• New Add translations for [Bangla], [Hindi], [Urdu] languages.
• New RTL Support for Translations of Right-to-Left Languages
• added Kosovo localization messages
• update [README.md] file with translations listed Country and RLT,LRT Output.
• New screenshot(thumbnail) added.

• New Add translations for [Bangla], [Hindi], [Urdu] languages.

• New RTL Support for Translations of Right-to-Left Languages

• added Kosovo localization messages

• update [README.md] file with translations listed Country and RLT,LRT Output.

• New screenshot(thumbnail) added.

• Update Benin number format 8 to 10

• Update Benin number format 8 to 10

• fixed Readme file

• fixed Readme file

• make compatible for web.

• make compatible for web.

• A Custom mobile Input TextFormField.
• A Basic validator added.
• Added styling of the country selection button.
• Added support for input formatters.
• Added some more necessary parameters available for a normal textfield.
• Initial Value can now be set.
• mobile field now returns ISO County code as well in onSaved, onChanged.
• SearchBar label text can be now set.
• Picker popup bug fixed.
• Color change for Dropdown Icon and Dialog is now added.
• onCountryChanged param added.
• null-safe.
• Update maximum length of mobile numbers of several countries.
• Add dropDownArrowIcon parameter.
• Control autoValidateMode of text input added.
• showCountryFlag param added.
• textAlignVertical param added.
• Icon position feature added.
• Setting enabled to false disable the dropdown button too.
• Update maximum length of mobile numbers of several countries.
• dropDownArrowIcon and dropDownArrowColor parameters are now replaced by dropDownIcon.
• Add asynchronous validation.
• Add minimal country length.
• Update minimum and maximum length of mobile numbers of several countries.
• Support country search by dial code.
• Move flag button to TextFormField's prefixIcon (always displayed and get rid of alignment issues).
• Add dropdownTextStyle, customize style use for the country dial code.
• Add disableLengthCheck, disable view minimum and maximum length check.
• Add a CountryPickerDialog widget and PickerDialogStyle (set of styles to allow the country search dialog customization).
• Add flagsButtonPadding, set custom padding around flag button.
• Add invalidNumberMessage, te message to be displayed on validation error.
• Add cursor customization options: cursorColor, cursorHeight, cursorRadius, cursorWidth and showCursor.
• Switch from country List of Maps to List of Country objects.
• keyboardAppearance use default ThemeData.brightness.
• Rename dropDownIcon to dropdownIcon and iconPosition to dropdownIconPosition.
• Remove autoValidate.
• Add asynchronous validation.
• validator function parameter type is [MobileNumber] now instead of [String].
• Add width property to [PickerDialogStyle]
• Add flagsButtonMargin property
• Update mobile number length of several countries.
• Add magnifierConfiguration to customize the magnifier.
• Add formFieldKey for the Mobile input text field key.
• Update Mobile number length of several countries.
• New Add shape property of the Dialog.
• New Update Madagascar, Brazil, belarus, indonesia Min and Max.
• New Add Country Kosovo.
• New Correct name translation for some countries.
• New Able to style the text inside the search field.
• New allowing to pass list of favorite country codes as a list of string.
• New put the favorite countries always on the top.
• New changed the listView builder to slivers.
• New Fixed duplication of countries on the search.
• New Hungarian translation added to countries.
• New make itself visible by scrolling.
• New Enable project example for Linux, Mac and Windows.
• New Fix to select png asset for Linux and Windows.
• New Enable "expands" and "maxLines" parameters.
• New support phone numbers with spaces and dashes in fromCompleteNumber.
• New Border added to TextFormField Widget
• New Fill Color added.
• New Invalid Number Message added in validator on empty Mobile number.
• New Disable text field and flag Separately.
• New Disable Mobile Length Counter.
• New Add an onTapOutside function.
• New Control the size of the country flag. min is 32.
• New You can add Customizable favorite Icon in favorite country list.
• New You can can change the position of the favorite Icon.

• A Custom mobile Input TextFormField.

• A Basic validator added.

• Added styling of the country selection button.

• Added support for input formatters.

• Added some more necessary parameters available for a normal textfield.

• Initial Value can now be set.

• mobile field now returns ISO County code as well in onSaved, onChanged.

• SearchBar label text can be now set.

• Picker popup bug fixed.

• Color change for Dropdown Icon and Dialog is now added.

• onCountryChanged param added.

• null-safe.

• Update maximum length of mobile numbers of several countries.

• Add dropDownArrowIcon parameter.

• Control autoValidateMode of text input added.

• showCountryFlag param added.

• textAlignVertical param added.

• Icon position feature added.

• Setting enabled to false disable the dropdown button too.

• Update maximum length of mobile numbers of several countries.

• dropDownArrowIcon and dropDownArrowColor parameters are now replaced by dropDownIcon.

• Add asynchronous validation.

• Add minimal country length.

• Update minimum and maximum length of mobile numbers of several countries.

• Support country search by dial code.

• Move flag button to TextFormField's prefixIcon (always displayed and get rid of alignment issues).

• Add dropdownTextStyle , customize style use for the country dial code.

• Add disableLengthCheck , disable view minimum and maximum length check.

• Add a CountryPickerDialog widget and PickerDialogStyle (set of styles to allow the country search dialog customization).

• Add flagsButtonPadding , set custom padding around flag button.

• Add invalidNumberMessage , te message to be displayed on validation error.

• Add cursor customization options: cursorColor , cursorHeight , cursorRadius , cursorWidth and showCursor .

• Switch from country List of Maps to List of Country objects.

• keyboardAppearance use default ThemeData.brightness .

• Rename dropDownIcon to dropdownIcon and iconPosition to dropdownIconPosition .

• Remove autoValidate .

• Add asynchronous validation.

• validator function parameter type is [MobileNumber] now instead of [String].

• Add width property to [PickerDialogStyle]

• Add flagsButtonMargin property

• Update mobile number length of several countries.

• Add magnifierConfiguration to customize the magnifier.

• Add formFieldKey for the Mobile input text field key.

• Update Mobile number length of several countries.

• New Add shape property of the Dialog.

• New Update Madagascar, Brazil, belarus, indonesia Min and Max.

• New Add Country Kosovo.

• New Correct name translation for some countries.

• New Able to style the text inside the search field.

• New allowing to pass list of favorite country codes as a list of string.

• New put the favorite countries always on the top.

• New changed the listView builder to slivers.

• New Fixed duplication of countries on the search.

• New Hungarian translation added to countries.

• New make itself visible by scrolling.

• New Enable project example for Linux, Mac and Windows.

• New Fix to select png asset for Linux and Windows.

• New Enable "expands" and "maxLines" parameters.

• New support phone numbers with spaces and dashes in fromCompleteNumber.

• New Border added to TextFormField Widget

• New Fill Color added.

• New Invalid Number Message added in validator on empty Mobile number.

• New Disable text field and flag Separately.

• New Disable Mobile Length Counter.

• New Add an onTapOutside function.

• New Control the size of the country flag. min is 32.

• New You can add Customizable favorite Icon in favorite country list.

• New You can can change the position of the favorite Icon.

39

likes

160

points

4.91k

downloads

Documentation

API reference

Publisher

ratiodream.com

Weekly Downloads

Metadata

A customized Flutter TextFormField to input international Mobile number along with country code.

Repository (GitHub)

View/report issues

Topics

#intl-mobile-field #phone-field #number-field #international-phone-field #international-mobile-field

License

MIT ( license )

Dependencies

flutter

More

Packages that depend on intl_mobile_field

← Metadata

39

likes

160

points

4.91k

downloads

Documentation

API reference

Publisher

ratiodream.com

Weekly Downloads

Metadata

A customized Flutter TextFormField to input international Mobile number along with country code.

Repository (GitHub)

View/report issues

Topics

#intl-mobile-field #phone-field #number-field #international-phone-field #international-mobile-field

License

MIT ( license )

Dependencies

flutter

More

Packages that depend on intl_mobile_field

Back