feat: Add option to prevent navigation before/after minDate or maxDate (resolves #94)

Author: Jasenkoo

index.d.ts

@@ -183,6 +183,7 @@ interface Vue3DatePicker {
     multiDates?: boolean;
     presetRanges?: { label: string; range: Date[] | string[] }[];
     flow?: ('month' | 'year' | 'calendar' | 'time' | 'minutes' | 'hours' | 'seconds')[];
+    preventMinMaxNavigation?: boolean;
 }
 
 interface PublicMethods extends MethodOptions {

src/Vue3DatePicker/Vue3DatePicker.vue

@@ -108,6 +108,7 @@
                     multiDates,
                     presetRanges,
                     flow,
+                    preventMinMaxNavigation,
                 }"
                 v-model:internalModelValue="internalModelValue"
                 @close-picker="closeMenu"
@@ -274,6 +275,7 @@
         multiDates: { type: Boolean as PropType<boolean>, default: false },
         presetRanges: { type: Array as PropType<PresetRange[]>, default: () => [] },
         flow: { type: Array as PropType<Flow>, default: () => [] },
+        preventMinMaxNavigation: { type: Boolean as PropType<boolean>, default: false },
     });
     const slots = useSlots();
     const isOpen = ref(false);

src/Vue3DatePicker/components/DatepickerMenu.vue

@@ -50,6 +50,7 @@
                                 instance,
                                 minDate,
                                 maxDate,
+                                preventMinMaxNavigation,
                             }"
                             @mount="childMount('monthYearInput')"
                             @reset-flow="resetFlow"
@@ -284,6 +285,7 @@
         multiDates: { type: Boolean as PropType<boolean>, default: false },
         presetRanges: { type: Array as PropType<PresetRange[]>, default: () => [] },
         flow: { type: Array as PropType<Flow>, default: () => [] },
+        preventMinMaxNavigation: { type: Boolean as PropType<boolean>, default: false },
     });
     const slots = useSlots();
     const calendarWrapperRef = ref(null);

src/Vue3DatePicker/components/MonthYearInput.vue

@@ -43,7 +43,13 @@
             <transition :name="transitionName(showMonthPicker)" :css="showTransition">
                 <SelectionGrid
                     v-if="showMonthPicker"
-                    v-bind="{ modelValue: month, items: groupedMonths, disabledValues: filters.months }"
+                    v-bind="{
+                        modelValue: month,
+                        items: groupedMonths,
+                        disabledValues: filters.months,
+                        minValue: minMonth,
+                        maxValue: maxMonth,
+                    }"
                     @update:model-value="onMonthUpdate"
                     @toggle="toggleMonthPicker"
                 >
@@ -59,7 +65,13 @@
             <transition :name="transitionName(showYearPicker)" :css="showTransition">
                 <SelectionGrid
                     v-if="showYearPicker"
-                    v-bind="{ modelValue: year, items: groupedYears, disabledValues: filters.years }"
+                    v-bind="{
+                        modelValue: year,
+                        items: groupedYears,
+                        disabledValues: filters.years,
+                        minValue: minYear,
+                        maxValue: maxYear,
+                    }"
                     @update:model-value="onYearUpdate"
                     @toggle="toggleYearPicker"
                     ><template #button-icon>
@@ -187,6 +199,7 @@
         multiCalendarsSolo: { type: Boolean as PropType<boolean>, default: false },
         minDate: { type: [Date, String] as PropType<Date | string>, default: null },
         maxDate: { type: [Date, String] as PropType<Date | string>, default: null },
+        preventMinMaxNavigation: { type: Boolean as PropType<boolean>, default: false },
     });
 
     const { transitionName, showTransition } = useTransitions();
@@ -225,7 +238,7 @@
     const maxMonth = computed(() => {
         if (props.maxDate && maxYear.value) {
             if (maxYear.value < props.year) return -1;
-            if (maxYear.value === props.year) return getMonth(new Date(props.maxDate));
+            if (maxYear.value === props.year) return getMonth(new Date(props.maxDate)) - 1;
         }
         return null;
     });

src/Vue3DatePicker/components/composition/month-year.ts

@@ -1,5 +1,6 @@
 import { addMonths, addYears, getMonth, getYear, set, subMonths, subYears } from 'date-fns';
 import { UseMonthYearPick, VueEmit } from '../../interfaces';
+import { isDateAfter, isDateBefore } from '../../utils/date-utils';
 
 export const useMontYearPick = (
     props: UseMonthYearPick,
@@ -23,6 +24,23 @@ export const useMontYearPick = (
         return yearDate;
     };
 
+    const getDateForCompare = (propValue: 'minDate' | 'maxDate', month: number, year: number): [Date, Date] => {
+        return [new Date(props[propValue]), set(new Date(), { month, year })];
+    };
+
+    const validateMonthYear = (month: number, year: number, isNext: boolean): void => {
+        if (props.preventMinMaxNavigation && (props.minDate || props.maxDate)) {
+            if (props.maxDate && isNext && isDateAfter(...getDateForCompare('maxDate', month, year))) {
+                updateMonthYear(month, year);
+            }
+            if (props.minDate && !isNext && isDateBefore(...getDateForCompare('minDate', month, year))) {
+                updateMonthYear(month, year);
+            }
+        } else {
+            updateMonthYear(month, year);
+        }
+    };
+
     const handleMonthYearChange = (isNext: boolean): void => {
         const initialDate = set(new Date(), { month: props.month, year: props.year });
         let date = isNext ? addMonths(initialDate, 1) : subMonths(initialDate, 1);
@@ -40,7 +58,7 @@ export const useMontYearPick = (
             date = recursiveYearAdjust(date, isNext);
             year = getYear(date);
         }
-        updateMonthYear(month, year);
+        validateMonthYear(month, year, isNext);
     };
 
     const updateMonthYear = (month: number, year: number): void => {

src/Vue3DatePicker/interfaces.ts

@@ -95,6 +95,9 @@ export interface UseMonthYearPick {
     filters: IDateFilter;
     year: number;
     month: number;
+    preventMinMaxNavigation: boolean;
+    maxDate: Date | string;
+    minDate: Date | string;
 }
 
 export type MaybeRef<T> = T | Ref<T>;