extended_phone_number_input

Visão geral do pacote

Orientação gerada a partir de informações públicas. Apenas para referência.

Um widget Flutter para lidar com a entrada de números de telefone com suporte integrado para seleção de código do país, validação em tempo real e integração com o seletor de contatos do dispositivo. Ele simplifica a digitação de números internacionais ao aplicar automaticamente formatação e validar a entrada com base no país selecionado. O pacote é projetado para melhorar a experiência do usuário em formulários que exigem números de telefone em diferentes regiões.

Casos de uso

Coleta de número de telefone internacional
Validação de formulário com regras específicas por país
integração do seletor de contatos
Seleção dinâmica de código do país
Interface de entrada de telefone amigável ao usuário
Fluxos de registro de aplicativos móveis

Principais recursos

Detecção automática de código do país
Validação em tempo real de entrada
integração do seletor de contatos
Estilo personalizável
Suporte a múltiplos locais
Formatação automática

Indicado para

Aplicações globais
formulários de registro de usuário
aplicativos de atendimento ao cliente
Aplicativos que exigem entrada de telefone internacional
Desenvolvedores que precisam de tratamento robusto de entrada de telefone

Considerações

Requer internet para dados completos do país
Pode ser necessário permissões adicionais para acesso aos contatos
Personalização limitada da lista de países
Depende de dependência externa para a lógica de formatação
Não otimizado para conjuntos de dados muito grandes
A configuração inicial pode exigir configuração

README original

Snapshot do README original do repositório-fonte vinculado. Consulte o repositório para o conteúdo mais recente.

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.

Buscar pacotes, repositórios e categorias de apps

Instalar pacote