Um pacote Flutter para exibir um seletor de código do país. Além disso, permite selecionar uma lista de países favoritos, bem como pesquisar usando uma caixa de pesquisa simples.
Orientação gerada a partir de informações públicas. Apenas para referência.
Um pacote Flutter que fornece um seletor de código do país com suporte a países favoritos e funcionalidade de pesquisa. Permite aos usuários selecionar facilmente um país de uma lista abrangente, personalizar seus países preferidos e encontrar rapidamente países usando uma caixa de pesquisa. Ideal para formulários que exigem entrada de números de telefone internacionais, oferece suporte a múltiplas plataformas, incluindo Android, iOS, Web, macOS, Windows e Linux. O pacote é leve, personalizável e integra-se perfeitamente em aplicativos Flutter existentes.
Casos de uso
Entrada de número de telefone internacional
Configuração do perfil do usuário com seleção de país
Recursos de aplicativo multilíngue ou baseados em região
Seleção de país do formulário de viagem ou envio
Lista personalizável de países favoritos
Principais recursos
Lista de países pesquisável
Gerenciamento de favoritos
Compatibilidade multiplataforma
Integração fácil com formulários do Flutter
UI e comportamento personalizáveis
Suporte para códigos de país ISO 3166
Indicado para
Aplicativos que exigem entrada de número de telefone internacional
Desenvolvedores construindo aplicativos voltados para o mundo
Formulários que precisam de dados específicos do país
Projetos que suportam múltiplas regiões ou idiomas
Usuários que querem um seletor de país limpo e interativo
Considerações
Requer manipulação manual do código de país selecionado nos formulários
Opções limitadas de personalização para o algoritmo de busca
Pode ser necessário estilos adicionais para aparência consistente entre plataformas
Não inclui validação embutida para números de telefone
Depende de fonte externa para dados de país
README original
Snapshot do README original do repositório-fonte vinculado. Consulte o repositório para o conteúdo mais recente.
A flutter package for showing a country code selector.
It supports i18n for 70 languages.
Check the example on web! https://imtoori.dev/CountryCodePicker/#/
Usage
Just put the component in your application setting the onChanged callback.
@overrideWidgetbuild(BuildContext context) => newScaffold(
body: Center(
child: CountryCodePicker(
onChanged: print,
// Initial selection and favorite can be one of code ('IT') OR dial_code('+39')
initialSelection: 'IT',
favorite: ['+39','FR'],
// optional. Shows only country name and flag
showCountryOnly: false,
// optional. Shows only country name and flag when popup is closed.
showOnlyCountryWhenClosed: false,
// optional. aligns the flag and the Text left
alignLeft: false,
),
),
);
Example:
void_onCountryChange(CountryCode countryCode) {
//TODO : manipulate the selected country code hereprint("New Country selected: " + countryCode.toString());
}
i18n
Just add the CountryLocalizations.delegate in the list of your app delegates
Here is a list of properties available to customizeccc your widget:
Name
Type
Description
onChanged
ValueChanged
callback invoked when the selection changes
onInit
ValueChanged
callback invoked during initialization of the widget
initialSelection
String
used to set the initial selected value
favorite
List
used to populate the favorite country list
textStyle
TextStyle
TextStyle applied to the widget button
padding
EdgeInsetsGeometry
the padding applied to the button
showCountryOnly
bool
true if you want to see only the countries in the selection dialog
searchDecoration
InputDecoration
decoration applied to the TextField search widget
searchStyle
TextStyle
style applied to the TextField search widget text
emptySearchBuilder
WidgetBuilder
use this to customize the widget used when the search returns 0 elements
builder
Function(CountryCode)
use this to build a custom widget instead of the default FlatButton
enabled
bool
set to false to disable the widget
textOverflow
TextOverflow
the button text overflow behaviour
dialogSize
Size
the size of the selection dialog
countryFilter
List
uses a list of strings to filter a sublist of countries
showOnlyCountryWhenClosed
bool
if true it'll show only the country
alignLeft
bool
aligns the flag and the Text to the left
showFlag
bool
shows the flag everywhere
showFlagMain
bool
shows the flag only when closed
showFlagDialog
bool
shows the flag only in dialog
flagWidth
double
the width of the flags
flagDecoration
Decoration
used for styling the flags
comparator
Comparator
use this to sort the countries in the selection dialog
hideSearch
bool
if true the search feature will be disabled
Contributions
Contributions of any kind are more than welcome! Feel free to fork and improve country_code_picker in any way you want, make a pull request, or open an issue.
Getting involved
First of all, thank you for even considering to get involved. You are a real super :star: and we :heart: you!
Reporting bugs and issues
Use the configured Github issue report template when reporting an issue. Make sure to state your observations and expectations
as objectively and informative as possible so that we can understand your need and be able to troubleshoot.
Discussions and ideas
We're happy to discuss and talk about ideas, post your
question to StackOverflow.
Contributors ✨
Thanks goes to these wonderful people (emoji key):