패키지, 저장소 및 앱 카테고리 검색

country_code_picker 표지
패키지 상세v3.4.1

country_code_picker

국가 코드 선택기를 표시하기 위한 플러터 패키지입니다. 또한 좋아하는 국가 목록을 선택할 수 있으며, 간단한 검색 상자로 검색할 수도 있습니다.

AndroidiOSWebmacOSWindowsLinux
30일 다운로드
17.3만
좋아요
932
Pub 점수
160

패키지 설치

flutter pub add country_code_picker

패키지 개요

공개 정보를 바탕으로 생성한 선택 가이드입니다.

즐겨찾는 국가와 검색 기능을 지원하는 국가 코드 선택기 기능을 제공하는 플러터 패키지입니다. 포괄적인 목록에서 사용자가 쉽게 국가를 선택하고 선호하는 국가를 사용자 정의하며 검색 상자를 통해 빠르게 국가를 찾을 수 있습니다. 국제 전화번호 입력이 필요한 양식에 적합하며, 안드로이드, iOS, 웹, macOS, Windows, 리눅스 등 여러 플랫폼을 지원합니다. 가볍고 커스터마이징 가능하며 기존 플러터 애플리케이션에 원활하게 통합됩니다.

사용 사례

  • 국제 전화번호 입력
  • 국가 선택과 함께 사용자 프로필 설정
  • 다국어 또는 지역 기반 앱 기능
  • 여행 또는 배송 양식 국가 선택
  • 사용자 정의 가능한 국가 즐겨찾기 목록

주요 기능

  • 검색 가능한 국가 목록
  • 즐겨찾기 관리
  • 크로스 플랫폼 호환성
  • Flutter 폼과의 간편한 통합
  • 사용자 정의 가능한 UI 및 동작
  • ISO 3166 국가 코드 지원

적합한 대상

  • 국제 전화번호 입력이 필요한 앱
  • 글로벌 대상 애플리케이션을 개발하는 개발자
  • 국가별 데이터가 필요한 양식
  • 여러 지역 또는 언어를 지원하는 프로젝트
  • 깨끗하고 상호작용 가능한 국가 선택기를 원하는 사용자

고려 사항

  • 양식에서 선택한 국가 코드를 수동으로 처리해야 합니다
  • 검색 알고리즘에 대한 사용자 지정 옵션이 제한되어 있습니다
  • 다양한 플랫폼 간에 일관된 외관을 유지하기 위해 추가적인 스타일링이 필요할 수 있습니다
  • 전화번호에 대한 내장 검증을 포함하지 않습니다
  • 국가 데이터에 대해 외부 소스에 의존합니다

원본 README

연결된 소스 저장소의 README 원문 스냅샷입니다. 최신 내용은 저장소에서 확인하세요.

GitHub code size

All Contributors

GitHub contributors Pub Linkedin LinkedIn Linkedin LinkedIn

country_code_picker

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.


@override
 Widget build(BuildContext context) => new Scaffold(
     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 here
    print("New Country selected: " + countryCode.toString());
  }

i18n

Just add the CountryLocalizations.delegate in the list of your app delegates

Default Usage (Localization Enabled)
 return new MaterialApp(
      supportedLocales: [
         Locale("af"),
        Locale("am"),
        Locale("ar"),
        Locale("az"),
        Locale("be"),
        Locale("bg"),
        Locale("bn"),
        Locale("bs"),
        Locale("ca"),
        Locale("cs"),
        Locale("da"),
        Locale("de"),
        Locale("el"),
        Locale("en"),
        Locale("es"),
        Locale("et"),
        Locale("fa"),
        Locale("fi"),
        Locale("fr"),
        Locale("gl"),
        Locale("ha"),
        Locale("he"),
        Locale("hi"),
        Locale("hr"),
        Locale("hu"),
        Locale("hy"),
        Locale("id"),
        Locale("is"),
        Locale("it"),
        Locale("ja"),
        Locale("ka"),
        Locale("kk"),
        Locale("km"),
        Locale("ko"),
        Locale("ku"),
        Locale("ky"),
        Locale("lt"),
        Locale("lv"),
        Locale("mk"),
        Locale("ml"),
        Locale("mn"),
        Locale("ms"),
        Locale("nb"),
        Locale("nl"),
        Locale("nn"),
        Locale("no"),
        Locale("pl"),
        Locale("ps"),
        Locale("pt"),
        Locale("ro"),
        Locale("ru"),
        Locale("sd"),
        Locale("sk"),
        Locale("sl"),
        Locale("so"),
        Locale("sq"),
        Locale("sr"),
        Locale("sv"),
        Locale("ta"),
        Locale("tg"),
        Locale("th"),
        Locale("tk"),
        Locale("tr"),
        Locale("tt"),
        Locale("uk"),
        Locale("ug"),
        Locale("ur"),
        Locale("uz"),
        Locale("vi"),
        Locale("zh")
      ],
      localizationsDelegates: [
        CountryLocalizations.delegate,
        GlobalMaterialLocalizations.delegate,
        GlobalWidgetsLocalizations.delegate,
      ],
Force English (Localization Disabled)
 return new MaterialApp(
      localizationsDelegates: [
        CountryLocalizations.delegate(enableLocalization: false),
        GlobalMaterialLocalizations.delegate,
        GlobalWidgetsLocalizations.delegate,
      ],

Customization

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):

Chandra Abdul Fattah
Chandra Abdul Fattah

🚇 💻
Salvatore Giordano
Salvatore Giordano

🚇 💻
Nilashish Roy
Nilashish Roy

🚇 💻

This project follows the all-contributors specification. Contributions of any kind welcome!

카테고리

의존성

의존성 목록 2 개

소스 저장소

이 패키지를 사용하는 프로젝트

순위