persian_calendar_widget 0.5.0

Pick a date with a custom dialog box in Persian calendar that can be used in any project.

persian_calendar_widget

A Flutter package that provides users access to pick a date using a Persian calendar.

Minimal Calendar	Custom Decoration Calendar

Usage

MinimalPersianCalendar.pickFullDate widget

/// pickFullDate dialog box
ElevatedButton(
    onPressed: () {
        /// open date picker widget
        /// user have access to pick day, month and year
        MinimalPersianCalendar.pickFullDate(
            context: context,
            onSubmit: (jalaliDate, dateInText) {
                /// when user choose date from dialog box and submit two
                /// types of `Jalali` date returned here
                /// Jalali [jalaliDate]: Jalali(year, month, day, hour, minute, second, millisecond)
                /// String [dateInText]: '12 ordibehesht 1403'
                setState(() {
                    selectedDate = dateInText;
                });
                log('dateInText of pick full date: $dateInText');
                log('jalaliDate of pick full date: $jalaliDate');
            },
            showTodayBanner: true,
            useGoToTodayButton: true,
        );
    },
    child: const Text('انتخاب روز ماه و سال')),

CustomDecorationPersianCalendar.pickFullDate widget

/// pickFullDate dialog box
ElevatedButton(
    onPressed: () {
        /// open date picker widget
        /// user have access to pick day, month and year
        CustomDecorationPersianCalendar.pickFullDate(
            context: context,
            onSubmit: (jalaliDate, dateInText) {
                /// when user choose date from dialog box and submit two
                /// types of `Jalali` date returned here
                /// Jalali [jalaliDate]: Jalali(year, month, day, hour, minute, second, millisecond)
                /// String [dateInText]: '12 ordibehesht 1403'
                setState(() {
                    selectedDate = dateInText;
                });
                log('dateInText of pick full date: $dateInText');
                log('jalaliDate of pick full date: $jalaliDate');
            },
             background: Colors.cyan.shade50,

            /// change cancel button decoration
            cancelTitle: 'لغو',
            cancelButtonStyle: TextButton.styleFrom(),
            cancelTextStyle: TextStyle(color: Colors.cyan.shade700),

            /// change submit button decoration
            submitTitle: 'ثبت',
            submitButtonStyle: ElevatedButton.styleFrom(
                elevation: 10,
                shadowColor: Colors.cyan.shade400,
                backgroundColor: Colors.cyan.shade700,
                shape: RoundedRectangleBorder(
                    borderRadius: BorderRadius.circular(5.0),
                ),
            ),
            submitTextStyle: TextStyle(color: Colors.cyan.shade100),

            /// change date button decoration
            dateButtonStyle: TextButton.styleFrom(),
            dateSelectedButtonStyle: TextButton.styleFrom(
                elevation: 0,
                backgroundColor: Colors.cyan.shade700,
                shape: RoundedRectangleBorder(
                    borderRadius: BorderRadius.circular(5.0),
                ),
            ),
            dateTextStyle: TextStyle(
                color: Colors.cyan.shade700,
            ),
            dateSelectedTextStyle: const TextStyle(
                color: Colors.white54,
            ),

            /// change title decoration
            titleBoxStyle: BoxDecoration(
                borderRadius: const BorderRadius.all(Radius.circular(8)),
                border: Border.all(color: Colors.cyan.shade500, width: 1.5),
                color: Colors.cyan.shade600,
                boxShadow: [
                    BoxShadow(
                        color: Colors.cyan.shade500,
                       offset: Offset.zero,
                       blurRadius: 25)
            ]),
            titleButtonStyle: TextButton.styleFrom(),
            titleSelectedButtonStyle: TextButton.styleFrom(
                elevation: 0,
                backgroundColor: Colors.cyan.shade700,
                shape: RoundedRectangleBorder(
                    borderRadius: BorderRadius.circular(5.0),
                ),
            ),
            titleTextStyle: const TextStyle(
                color: Colors.white,
            ),
            titleSelectedTextStyle: const TextStyle(
                color: Colors.white54,
            ),

            /// change week days decoration
            weekDaysBoxStyle: BoxDecoration(
                borderRadius: const BorderRadius.all(Radius.circular(8)),
                border:
                    Border.all(color: Colors.cyan.shade500, width: 1.5),
                color: Colors.cyan.shade600,
            ),
            weekDaysTextStyle: const TextStyle(color: Colors.white));
        );
    },
    child: const Text('انتخاب روز ماه و سال')),

toPersianDigit extension

/// show this digits with persian format

Text(
    '123'.toPersianDigit(),
)

Documentation

MinimalPersianCalendar Parameters

Parameter	Description	Type	Default
context	Callback function returning the picked date	BuildContext	Required
onSubmit	Callback function returning the picked date	Function(Jalali jalaliDate, String dateInText)	Required
initialDate	Initial date displayed in the calendar	DateTime	DateTime.now()
borderRadius	Border radius of the dialog box	double	20
maxYear	Maximum selectable year	int	DateTime.now() + 11
minYear	Minimum selectable year	int	DateTime.now()
primaryColor	Choose primary color	Color	null
onPrimaryColor	Choose on primary color	Color	null
background	Choose background color	Color	null
titleTextStyle	Change text style of the title texts	TextStyle	null
titleSelectedTextStyle	Change text style of the selected title texts	TextStyle	null
dateTextStyle	Change text style of the date texts	TextStyle	null
dateSelectedTextStyle	Change text style of the selected date texts	TextStyle	null
submitTextStyle	Change text style of the submit text	TextStyle	null
submitTitle	Change the title of the submit button	String	null
cancelTextStyle	Change text style of the cancel text	TextStyle	null
cancelTitle	Change the title of the cancel button	String	null
showTodayBanner	Show a banner to see current day date	bool	null
todayDateBannerTextStyle	Change text style of the today banner text	TextStyle	null
useGoToTodayButton	Show go to today button	bool	null
goTitle	Change the title of the banner button title	String	null
goTextStyle	Change text style of the banner button title	TextStyle	null
weekDaysPadding	Change the padding of the week days tiles	EdgeInsetsGeometry	null
weekDaysTextStyle	Change text style of the week days tiles text	TextStyle	null

CustomDecorationPersianCalendar Parameters

Parameter	Description	Type	Default
context	Callback function returning the picked date	BuildContext	Required
onSubmit	Callback function returning the picked date	Function(Jalali jalaliDate, String dateInText)	Required
initialDate	Initial date displayed in the calendar	DateTime	DateTime.now()
borderRadius	Border radius of the dialog box	double	20
maxYear	Maximum selectable year	int	DateTime.now() + 11
minYear	Minimum selectable year	int	DateTime.now()
primaryColor	Choose primary color	Color	null
onPrimaryColor	Choose on primary color	Color	null
background	Choose background color	Color	null
titleBoxStyle	Change the decoration of the title box	BoxDecoration	null
titleButtonStyle	Change the button style of the title buttons	ButtonStyle	null
titleSelectedButtonStyle	Change the button style of the selected title buttons	ButtonStyle	null
titleTextStyle	Change text style of the title texts	TextStyle	null
titleSelectedTextStyle	Change text style of the selected title texts	TextStyle	null
dateButtonStyle	Change the button style of the date buttons	ButtonStyle	null
dateSelectedButtonStyle	Change the button style of the selected date buttons	ButtonStyle	null
dateTextStyle	Change text style of the date texts	TextStyle	null
dateSelectedTextStyle	Change text style of the selected date texts	TextStyle	null
submitButtonStyle	Change the button style of the submit buttons	ButtonStyle	null
submitTextStyle	Change text style of the submit text	TextStyle	null
submitTitle	Change the title of the submit button	String	null
cancelButtonStyle	Change the button style of the cancel buttons	ButtonStyle	null
cancelTextStyle	Change text style of the cancel text	TextStyle	null
cancelTitle	Change the title of the cancel button	String	null
showTodayBanner	Show a banner to see current day date	bool	null
todayDateBannerTextStyle	Change text style of the today banner text	TextStyle	null
useGoToTodayButton	Show go to today button	bool	null
goTitle	Change the title of the banner button title	String	null
goTextStyle	Change text style of the banner button title	TextStyle	null
goButtonStyle	Change the button style of the go today buttons	ButtonStyle	null
weekDaysBoxStyle	Change the decoration of the week days tiles	BoxDecoration	null
weekDaysPadding	Change the padding of the week days tiles	EdgeInsetsGeometry	null
weekDaysTextStyle	Change text style of the week days tiles text	TextStyle	null

Contributing

Contributions are always welcome! If you have any suggestions, bug reports, or feature requests, please open an issue on the GitHub repository.

If you would like to contribute to the project, please read the CONTRIBUTING.md file for more information on how to contribute.