extended_phone_number_input

Paketübersicht

Aus öffentlichen Paketdaten erstellte Orientierung.

Ein Flutter-Widget zur Verarbeitung von Telefonnummern mit integrierter Unterstützung für die Auswahl der Ländercodes, Echtzeit-Validierung und Integration mit dem Kontaktauswähler des Geräts. Es vereinfacht die Eingabe internationaler Telefonnummern durch automatische Formatierung und Validierung basierend auf dem ausgewählten Land. Das Paket ist darauf ausgelegt, die Benutzererfahrung bei Formularen zu verbessern, die Telefonnummern in verschiedenen Regionen erfordern.

Anwendungsfälle

Internationale Telefonnummererfassung
Formularvalidierung mit landesspezifischen Regeln
Kontaktpicker-Integration
Dynamische Ländercode-Auswahl
Benutzerfreundliche Telefon-Eingabeschnittstelle
Mobile-App-Registrierungsflüsse

Hauptmerkmale

Automatische Erkennung der Ländercode
Echtzeit-Eingabeverifizierung
Kontaktpicker-Integration
Anpassbare Stilisierung
Unterstützt mehrere Lokalisierungen
Automatische Formatierung

Geeignet für

Globale Anwendungen
Benutzerregistrierungsformulare
Kundenservice-Apps
Apps, die internationale Telefon-Eingabe erfordern
Entwickler, die eine robuste Telefon-Eingabehandlung benötigen

Hinweise

Benötigt Internet für vollständige Länderdaten
Zusätzliche Berechtigungen für den Kontaktzugriff können erforderlich sein
Begrenzte Anpassung der Länderliste
Abhängig von externer Abhängigkeit für Formatierungslogik
Nicht für sehr große Datensätze optimiert
Die Initialkonfiguration erfordert möglicherweise eine Konfiguration

Original-README

Originaler README-Schnappschuss aus dem verknüpften Quell-Repository. Aktuelle Inhalte finden Sie im Repository.

A Highly customizable Phone input Flutter widget that supports country code, validation and contact picker.

Features

Phone number with international validation
Include only specific countries
Exclude specific countries
Set a phone number using a controller (Selected country will be updated automatically)
Pick a phone number from contacts list

Getting started

Install the package extended_phone_number_input:

flutter pub add extended_phone_number_input

If you target Android 11+ (API 30+) and want to use the build-in contact picker you need to add the android.permission.READ_CONTACTS permission on the AndroidManifest.xml as this permission will be requested automatically.

Usage

A full and rich example can be found in /example folder.

Simple usage

 PhoneNumberInput(initialCountry: 'SA', locale: 'ar')

Show countries as dialog (default is bottom sheet)

 const PhoneNumberInput(
    initialCountry: 'US',
    locale: 'en',
    countryListMode: CountryListMode.dialog,
    contactsPickerPosition: ContactsPickerPosition.suffix,
    )

Custom borders

 PhoneNumberInput(
    initialCountry: 'TN',
    locale: 'fr',
    countryListMode: CountryListMode.dialog,
    contactsPickerPosition: ContactsPickerPosition.suffix,
    enabledBorder: OutlineInputBorder(
    borderRadius: BorderRadius.circular(10),
    borderSide: const BorderSide(color: Colors.purple)),
    focusedBorder: OutlineInputBorder(
        borderRadius: BorderRadius.circular(10),
        borderSide: const BorderSide(color: Colors.purple))
    )

Select Phone number programmatically

To be able to select a phone number programmatically, we first need to define a PhoneInputController :

PhoneInputController _controller = PhoneInputController(context);

 PhoneNumberInput(
     controller: _controller
    ...

Select the desired phone number:

_controller.phoneNumber = '+1-....'

Note:

If you want to set the phone number from contact, The widget already support this feature without the need to use the controller.

Pakete, Repositories und App-Kategorien suchen

Paket installieren