Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/Macacoazul01/month_picker_dialog
Internationalized dialog for picking a single month from an infinite list of years.
https://github.com/Macacoazul01/month_picker_dialog
flutter flutter-package flutter-widget
Last synced: 9 days ago
JSON representation
Internationalized dialog for picking a single month from an infinite list of years.
- Host: GitHub
- URL: https://github.com/Macacoazul01/month_picker_dialog
- Owner: Macacoazul01
- License: mit
- Created: 2018-12-08T20:03:11.000Z (almost 6 years ago)
- Default Branch: master
- Last Pushed: 2024-09-07T17:16:08.000Z (2 months ago)
- Last Synced: 2024-09-07T18:36:55.323Z (2 months ago)
- Topics: flutter, flutter-package, flutter-widget
- Language: Dart
- Homepage: https://pub.dev/packages/month_picker_dialog
- Size: 878 KB
- Stars: 70
- Watchers: 2
- Forks: 96
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# month_picker_dialog
[](https://pub.dev/packages/month_picker_dialog)
Internationalized material style dialog for picking a single month from an infinite list of years.
This package makes use of the intl package and flutter's i18n abilities to provide labels in all languages known to flutter.
[Setting up an internationalized app: the flutter localization package](https://flutter.io/docs/development/accessibility-and-localization/internationalization#setting-up-an-internationalized-app-the-flutter_localizations-package)
## How to use it:
Just add:
`showMonthPicker()` to select a single month;
`showMonthRangePicker()` to select a range of months;
`showYearPicker()` to select only a year;
...inside your button function like a normal date picker dialog (context parameter is required):
### Example:
```dart
FloatingActionButton(
onPressed: () {
showMonthPicker(
context: context,
initialDate: DateTime.now(),
).then((date) {
if (date != null) {
setState(() {
selectedDate = date;
});
}
});
},
child: Icon(Icons.calendar_today),
),
FloatingActionButton(
onPressed: () {
showMonthRangePicker(
context: context,
initialDate: DateTime.now(),
rangeList: true,
).then((List? dates) {
if (dates != null) {
print(dates);
print(dates.last.lastDayOfMonth());
}
});
},
child: Icon(Icons.calendar_today),
),
FloatingActionButton(
onPressed: () {
showYearPicker(
context: context,
initialDate: DateTime.now(),
).then((year) {
if (year != null) {
setState(() {
selectedYear = year;
});
}
});
},
child: Icon(Icons.calendar_today),
),
```
## Migrating to 5.0:
Starting with version 5.0.0 of the package, everything related to the behavior/style of it that isn't a function, date parameter or custom widget is now under the new `MonthPickerDialogSettings` class.
It contains three subclasses:
`PickerDialogSettings` to customize the dialog part of the package;
`PickerHeaderSettings` to customize the header part of the package;
`PickerButtonsSettings` to customize the buttons part of the package;
And will be used like this:
```dart
FloatingActionButton(
onPressed: () {
showMonthPicker(
context: context,
initialDate: DateTime.now(),
monthPickerDialogSettings: const MonthPickerDialogSettings(
headerSettings: PickerHeaderSettings(
headerCurrentPageTextStyle: TextStyle(fontSize: 14),
headerSelectedIntervalTextStyle: TextStyle(fontSize: 16),
),
dialogSettings: PickerDialogSettings(
locale: const Locale('en'),
dialogRoundedCornersRadius: 20,
dialogBackgroundColor: Colors.blueGrey[50],
),
buttonsSettings: PickerButtonsSettings(
buttonBorder: const RoundedRectangleBorder(),
selectedMonthBackgroundColor: Colors.amber[900],
selectedMonthTextColor: Colors.white,
unselectedMonthsTextColor: Colors.black,
currentMonthTextColor: Colors.green,
yearTextStyle: const TextStyle(
fontSize: 10,
),
monthTextStyle: const TextStyle(
fontWeight: FontWeight.bold,
fontSize: 18,
),
),
),
).then((date) {
if (date != null) {
setState(() {
selectedDate = date;
});
}
});
},
child: Icon(Icons.calendar_today),
),
```
If you have any doubts on how to use this new settings class (that the sample app can't solve), please feel free to open an issue on the github project.
## Contributors:
[Gian Bettega](https://github.com/Macacoazul01)
[Dimitri Krivoj](https://github.com/hmkrivoj) (the original creator of the package)
[Fabio Henrique](https://github.com/FabioClem)
[Leon Colt](https://github.com/LeonColt)
[Wesley Gonzaga](https://github.com/wesleygonalv)
[Efrain Bastidas](https://github.com/Wolfteam)
[Volodymyr Hyrka](https://github.com/Vov4yk)
[Bern](https://github.com/Berneyw)
[just1982](https://github.com/just1982)
[Sagar Zala](https://github.com/sagarzala123)
[Pong Loong Yeat](https://github.com/pongloongyeat)
[Masayuki Ono](https://github.com/mono0926)
[Alecsplus](https://github.com/Alecsplus)
[Lautaro Zanuttini](https://github.com/lautarozanuttini)
[sinelser](https://github.com/sinelser)