intl_phone_number_input 0.4.5 copy "intl_phone_number_input: ^0.4.5" to clipboard
intl_phone_number_input: ^0.4.5 copied to clipboard

outdated

A simple and customizable flutter package on International Phone Number Input.

Intl Phone Number Input #

A simple and customizable flutter package for international phone number input

CustomDecoration CustomBorder Default
Screenshot_1587652933 Screenshot_1587652933 Screenshot_1587652933

What's new #

* Updated package documentation
* Added selector button padding on error
* Fixed issue with first digit getting removed

Features #

* Support for RTL languages
* Selector mode dropdown, bottom sheet and dialog
* As You Type Formatter: formats inputs to its selected international format
* Get Region Info with PhoneNumber.getRegionInfoFromPhoneNumber(String phoneNumber, [String isoCode]);
* Format PhoneNumber with PhoneNumber.getParsableNumber(String phoneNumber, String isoCode) or `PhoneNumber Reference`.parseNumber()
* Custom list of countries e.g. ['NG', 'GH', 'BJ' 'TG', 'CI']
    String phoneNumber =  '+234 500 500 5005';
    PhoneNumber number = await PhoneNumber.getRegionInfoFromPhoneNumber(phoneNumber);
    String parsableNumber = number.parseNumber();
    `controller reference`.text = parsableNumber

Note #

    PhoneNumber.getRegionInfoFromPhoneNumber(String phoneNumber, [String isoCode])

Could throw an Exception if the phoneNumber isn't recognised its a good pattern to pass the country's isoCode or have '+' at the beginning of the string

isoCode could be null if PhoneNumber is not recognised

Usage #

Constructors #

s/n Constructor
1 InternationalPhoneNumberInput
2 InternationalPhoneNumberInput.withCustomDecoration
3 InternationalPhoneNumberInput.withCustomBorder

Available Parameters #

InternationalPhoneNumberInput({
    Key key,
    this.selectorType,
    @required this.onInputChanged,
    this.onInputValidated,
    this.focusNode,
    this.textFieldController,
    this.onSubmit,
    this.keyboardAction,
    this.countries,
    this.textStyle,
    this.selectorTextStyle,
    this.inputBorder,
    this.inputDecoration,
    this.searchBoxDecoration,
    this.initialValue,
    this.selectorButtonOnErrorPadding = 24,
    this.maxLength = 15,
    this.hintText = 'Phone Number',
    this.isEnabled = true,
    this.autoFocus = false,
    this.autoValidate = false,
    this.formatInput = true,
    this.errorMessage = 'Invalid phone number',
    this.ignoreBlank = false,
    this.locale,
    this.countrySelectorScrollControlled = true,
    });
Parameter Datatype Initial Value Default [1] Decoration [2] CustomBorder [3]
onInputChanged function(PhoneNumber) null ✔️ ✔️ ✔️
onInputValidated function(bool) null ✔️ ✔️ ✔️
focusNode FocusNode null ✔️ ✔️ ✔️
textFieldController TextEditingController TextEditingController() ✔️ ✔️ ✔️
onSubmit Function() null ✔️ ✔️ ✔️
keyboardAction TextInputAction null ✔️ ✔️ ✔️
countries List null ✔️ ✔️ ✔️
textStyle TextStyle null ✔️ ✔️ ✔️
selectorTextStyle TextStyle null ✔️ ✔️ ✔️
inputBorder InputBorder null ✔️ ✔️
inputDecoration InputDecoration null ✔️ ✔️
initialValue PhoneNumber null ✔️ ✔️ ✔️
hintText String Phone Number ✔️ ✔️
selectorButtonOnErrorPadding double 24 ✔️ ✔️ ✔️
maxLength integer 15 ✔️ ✔️ ✔️
isEnabled boolean true ✔️ ✔️ ✔️
autoFocus boolean false ✔️ ✔️ ✔️
autoValidate boolean false ✔️ ✔️ ✔️
formatInput boolean true ✔️ ✔️ ✔️
errorMessage String Invalid phone number ✔️ ✔️
selectorType PhoneInputSelectorType PhoneInputSelectorType.DROPDOWN ✔️ ✔️ ✔️
ignoreBlank boolean false ✔️ ✔️ ✔️
locale String null ✔️ ✔️ ✔️
searchBoxDecoration InputDecoration null ✔️ ✔️
countrySelectorScrollControlled boolean true ✔️ ✔️ ✔️

Selector Types #

DROPDOWN BOTTOMSHEET DIALOG
Screenshot_1587652933 Screenshot_1587652933 Screenshot_1587652933

Testing #

Widget Key parameters and Helper classe are now available for integration testing check out this example 🎯 Integration Testing Example

Contributions #

If you encounter any problem or the library is missing a feature feel free to open an issue. Feel free to fork, improve the package and make pull request.

Contributors #

Made with contributors-img.

Dependencies #

Credits #

A special thanks to niinyarko

769
likes
0
pub points
99%
popularity

Publisher

unverified uploader

A simple and customizable flutter package on International Phone Number Input.

Repository (GitHub)
View/report issues

License

unknown (LICENSE)

Dependencies

equatable, flutter, libphonenumber

More

Packages that depend on intl_phone_number_input