Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/ziqq/flutter_simple_country_picker
The Flutter package that provides an easy-to-use country selection widget. It allows users to select a country from a comprehensive list of countries, making it simple to integrate country picking functionality into your Flutter applications. The package supports Android, iOS, and web platforms, and offers customization options for fonts and styles
https://github.com/ziqq/flutter_simple_country_picker
countries dart flutter flutter-package picker
Last synced: 17 days ago
JSON representation
The Flutter package that provides an easy-to-use country selection widget. It allows users to select a country from a comprehensive list of countries, making it simple to integrate country picking functionality into your Flutter applications. The package supports Android, iOS, and web platforms, and offers customization options for fonts and styles
- Host: GitHub
- URL: https://github.com/ziqq/flutter_simple_country_picker
- Owner: ziqq
- License: mit
- Created: 2024-10-04T08:18:04.000Z (3 months ago)
- Default Branch: master
- Last Pushed: 2024-10-17T11:52:37.000Z (2 months ago)
- Last Synced: 2024-10-22T20:08:04.212Z (2 months ago)
- Topics: countries, dart, flutter, flutter-package, picker
- Language: Dart
- Homepage:
- Size: 29.1 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
[](https://pub.dev/packages/flutter_simple_country_picker)
[](https://pub.dev/packages/flutter_simple_country_picker)
[](https://github.com/ziqq/flutter_simple_country_picker/actions/workflows/checkout.yml)
[](https://camo.githubusercontent.com/acf27a132bef86c9cd722078b5c6cd66762ec77873aec8323703da46b55431ce/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f74657374732d3130372532307061737365642d73756363657373)
[](https://codecov.io/gh/ziqq/flutter_simple_country_picker)
[](https://opensource.org/licenses/MIT)
[](https://pub.dev/packages/flutter_lints)
# flutter_simple_country_picker
## Description
The Flutter package that provides an easy-to-use country selection widget. It allows users to select a country from a comprehensive list of countries, making it simple to integrate country picking functionality into your Flutter applications. The package supports Android, iOS, and web platforms, and offers customization options for fonts and styles.
## Getting Started
Add the package to your pubspec.yaml:
```yaml
flutter_simple_country_picker:
```
## Installation
In your dart file, import the library:
```Dart
import 'package:flutter_simple_country_picker/flutter_simple_country_picker.dart';
```
## Example
Add the `CountriesLocalization.delegate` in the list of your app delegates. Set supported locales [Locale('ru'), Locale('en')]. And set your locale `ru` or `en`.
```Dart
MaterialApp(
locale: const Locale('ru'), // Locale('en'),
supportedLocales: const [
Locale('ru'),
Locale('en'),
],
localizationsDelegates: [
GlobalCupertinoLocalizations.delegate,
GlobalMaterialLocalizations.delegate,
GlobalWidgetsLocalizations.delegate,
/// Add [CountriesLocalization] in app [localizationsDelegates]
CountriesLocalization.delegate,
],
home: HomePage(),
);
```
Example usage of the `showCountryPicker` function:
```Dart
showCountryPicker(
context: context,
exclude: ['RU', 'EN'],
onDone: () {
print('CountryPicker dismissed');
},
onSelect: (Country country) {
print('Selected country: ${country.displayName}');
},
);
```
Optional argumets of the `showCountryPicker` function:
| Argument | Description |
|---------------------|-------------------------------------------------------------------------------------|
| `exclude` | List of countries to exclude from the list. |
| `filter` | List of countries to filter the list. |
| `favorite` | List of countries to show at the top of the list. |
| `showPhoneCode` | Displays the phone code before the country name. |
| `showWorldWide` | Shows the "World Wide" option at the beginning of the list. |
| `useAutofocus` | Automatically opens the keyboard when the picker is loaded. |
| `showSearch` | Enables or disables the search bar. |
| `isDismissible` | Allows the user to close the modal by swiping it down. |
| `isScrollControlled`| Controls the scrolling behavior of the modal window. |
| `useHaptickFeedback`| Enables haptic feedback. |
| `useSafeArea` | Enables the safe area for the modal window. |
| `onSelect` | Callback when the select a country. |
| `onDone` | Callback when the CountryPicker is dismissed, whether a country is selected or not. |
## All countries list
To view a complete list of countries, please refer to the [All countries list](https://github.com/ziqq/flutter_simple_country_picker/wiki/All-Countries-list).
## Changelog
Refer to the [Changelog](https://github.com/ziqq/flutter_simple_country_picker/blob/master/CHANGELOG.md) to get all release notes.
## Maintainers
[Anton Ustinoff (ziqq)](https://github.com/ziqq)
## Funding
If you want to support the development of our library, there are several ways you can do it:
- [Buy me a coffee](https://www.buymeacoffee.com/ziqq)
- [Support on Patreon](https://www.patreon.com/ziqq)
- [Subscribe through Boosty](https://boosty.to/ziqq)
## License
[MIT](https://github.com/ziqq/flutter_simple_country_picker/blob/master/LICENSE)
## Coverage
