Buscar pacotes, repositórios e categorias de apps

Capa de canopas_country_picker
Detalhes do pacotev0.0.10

canopas_country_picker

Um seletor de país do Flutter simples e personalizável para selecionar um país ou código de discagem com funcionalidade de pesquisa.

AndroidiOSWebmacOSWindowsLinux
Downloads em 30 dias
427
Curtidas
18
Pontos Pub
150

Instalar pacote

flutter pub add canopas_country_picker

Visão geral do pacote

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

Um pacote simples e personalizável do Flutter para selecionar um país ou seu código de discagem, com funcionalidade de busca embutida. Projetado para melhorar a experiência do usuário em formulários que exigem seleção de país, suporta múltiplas plataformas, incluindo Android, iOS, Web, macOS, Windows e Linux. O seletor é leve, fácil de integrar e permite aos desenvolvedores personalizar aparência e comportamento conforme as necessidades do aplicativo.

Casos de uso

  • Registro de usuário com seleção de país
  • Entrada de número de telefone com código do país
  • Campos de formulário internacionais
  • Coleta de endereço de viagem ou envio
  • Suporte a múltiplos idiomas nos nomes dos países

Principais recursos

  • Lista de países pesquisável
  • UI personalizável
  • Suporta códigos de discagem
  • Compatibilidade multiplataforma
  • Leve e rápido
  • Integração fácil com formulários do Flutter

Indicado para

  • Aplicativos móveis e web que exigem seleção de país
  • Aplicativos com foco em usuários internacionais
  • Formulários que exigem entrada de número de telefone
  • Desenvolvedores em busca de um seletor de país simples
  • Projetos com dependências mínimas

Considerações

  • Limitado aos dados de país predefinidos
  • Sem atualizações em tempo real do país
  • A personalização pode exigir conhecimento adicional sobre estilos
  • Não inclui recursos de geolocalização
  • Pode ser necessário atualizações manuais para novos acréscimos de países

README original

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

A Simple, Customizable Flutter Country picker for picking a Country or Dialing code with Search functionality.

Preview

How to use

If you want to show the country picker bottom sheet, use:

CountryCode? code = await showCountryCodePickerSheet(context: context);

If you want to show the country picker dialog, use:

CountryCode? code = await showCountryCodePickerDialog(context: context);

If you want to show the country list as a UI component, use the CountryCodeSelector widget:

CountryCodeSelector(
   onCountryCodeTap: (CountryCode code) {
      /// Specify country code tap event
   },
    //Note: Cannot provide both onCountryCodeTap and codeBuilder, as onCountryCodeTap will not work if you have provided codeBuilder.
)

How to get a country code from the country alpha-2:,

CountryCode code = CountryCode.getCountryCodeByAlpha2(
    countryAlpha2Code:"IN", // its case-insensitive you can use both IN or in
);

You can use await Alpha2CountryCode,getCurrentCountryCode() to obtain the current alpha-2 code:

String countryAlpha2Code = await Alpha2CountryCode.getCurrentCountryCode();

CountryCode code = CountryCode.getCountryCodeByAlpha2(
  countryAlpha2Code: countryAlpha2Code,
);

Note: Using await Alpha2CountryCode.getCurrentCountryCode() will return the current country alpha-2 code based on the IP location from the 'http://ip-api.com/json/' API.


You can also get the current country alpha-2 code based on the user's device region, using PlatformDispatcher locale.

CountryCode code = CountryCode.getCountryCodeByAlpha2(
    countryAlpha2Code: WidgetsBinding.instance.platformDispatcher.locale.countryCode, 
    /// if you have context, use View.of(context).platformDispatcher.locale.countryCode
);

Note: WidgetsBinding and View.of(context) are provided by the Flutter SDK.


How to get a country code from the country dial code,

CountryCode code = CountryCode.getCountryCodeByDialCode(
    dialCode: "+91",
);

Note: Instead of using a dial code, which can be shared by multiple countries, we recommend using the alpha-2 code.


How to get a country codes from the country dial code,

List<CountryCode> code = CountryCode.getCountryCodesByDialCode(
    dialCode: "+47",
);

If you want to show the localized country name, use:

String? l10nCountryName = countryCode.localizedName("en");

Customizations

For customizations, we are providing the CustomizationBuilders class to customize each section.

customizationBuilders: CustomizationBuilders(
  codeBuilder: (CountryCode code) {
    // Return something to change the country list item UI.
    // Note: onCountryCodeTap will be overridden by codeBuilder in customizationBuilders.

   // If want to do some customization in default country code view, you can use
    return DefaultCountryCodeListItemView(
      onCountryCodeTap: () {},
      code: code,
      locale: 'US', // To show a localized country name,
    );
  },
  
  codeSeparatorBuilder: (BuildContext context, int index) {
    // Return something to add a separator between country codes.
    return const SizedBox(); // Default
  },
  
  countryListBuilder: (List<CountryCode> codes, ScrollController? controller) {
    // Return something to customize the country list
  },
  
  textFieldBuilder: (void Function(String)? filter) {
    // Return the search text field widget
    //
    // If you want to do some customization in the default text field, you can use
    return DefaultCountryCodeFilterTextField(
      filter: filter,
    );

    // Use filter(searchText); to update the country code list.
  },
),

Bugs and Feedback

For bugs, feedback, questions and discussions please use the Github Issues.

Credits

Canopas Country Picker is owned and maintained by the Canopas team. You can follow us on Twitter at @canopassoftware for project updates and releases.

We regularly upload blogs on new topics, which you can read here.

Categorias

Repositório-fonte

Projetos que usam este pacote