✨ feat(datepicker): add full disabled state support across all picker modes

docs-site/src/components/Examples/config.tsx

@@ -56,6 +56,7 @@ import IncludeDatesMonthPicker from "../../examples/ts/includeDatesMonthPicker?r
 import IncludeTimes from "../../examples/ts/includeTimes?raw";
 import InjectTimes from "../../examples/ts/injectTimes?raw";
 import Inline from "../../examples/ts/inline?raw";
+import InlineDisabled from "../../examples/ts/disabledInline?raw";
 import InlineVisible from "../../examples/ts/inlineVisible?raw";
 import TimeInput from "../../examples/ts/timeInput?raw";
 import Locale from "../../examples/ts/locale?raw";
@@ -338,6 +339,10 @@ export const EXAMPLE_CONFIG: IExampleConfig[] = [
     title: "Inline version",
     component: Inline,
   },
+  {
+    title: "Inline version disabled",
+    component: InlineDisabled,
+  },
   {
     title: "Button to show Inline version",
     component: InlineVisible,

docs-site/src/examples/ts/disabledInline.tsx

@@ -0,0 +1,14 @@
+const DisabledInline = () => {
+  const [selectedDate, setSelectedDate] = useState<Date | null>(null);
+
+  return (
+    <DatePicker
+      selected={selectedDate}
+      onChange={(date: Date | null) => setSelectedDate(date)}
+      disabled
+      inline
+    />
+  );
+};
+
+render(DisabledInline);

src/calendar.tsx

@@ -468,6 +468,7 @@ export default class Calendar extends Component<CalendarProps, CalendarState> {
   };
 
   header = (date: Date = this.state.date): React.ReactElement[] => {
+    const disabled = this.props.disabled;
     const startOfWeek = getStartOfWeek(
       date,
       this.props.locale,
@@ -477,7 +478,11 @@ export default class Calendar extends Component<CalendarProps, CalendarState> {
     const dayNames: React.ReactElement[] = [];
     if (this.props.showWeekNumbers) {
       dayNames.push(
-        <div key="W" className="react-datepicker__day-name" role="columnheader">
+        <div
+          key="W"
+          className={`react-datepicker__day-name ${disabled ? "react-datepicker__day-name--disabled" : ""}`}
+          role="columnheader"
+        >
           <span className="react-datepicker__sr-only">Week number</span>
           <span aria-hidden="true">{this.props.weekLabel || "#"}</span>
         </div>,
@@ -496,7 +501,11 @@ export default class Calendar extends Component<CalendarProps, CalendarState> {
           <div
             key={offset}
             role="columnheader"
-            className={clsx("react-datepicker__day-name", weekDayClassName)}
+            className={clsx(
+              "react-datepicker__day-name",
+              weekDayClassName,
+              disabled ? "react-datepicker__day-name--disabled" : "",
+            )}
           >
             <span className="react-datepicker__sr-only">
               {formatDate(day, "EEEE", this.props.locale)}
@@ -551,6 +560,9 @@ export default class Calendar extends Component<CalendarProps, CalendarState> {
 
     let allPrevDaysDisabled;
     switch (true) {
+      case this.props.disabled:
+        allPrevDaysDisabled = true;
+        break;
       case this.props.showMonthYearPicker:
         allPrevDaysDisabled = yearDisabledBefore(this.state.date, this.props);
         break;
@@ -662,6 +674,9 @@ export default class Calendar extends Component<CalendarProps, CalendarState> {
 
     let allNextDaysDisabled: boolean;
     switch (true) {
+      case this.props.disabled:
+        allNextDaysDisabled = true;
+        break;
       case this.props.showMonthYearPicker:
         allNextDaysDisabled = yearDisabledAfter(this.state.date, this.props);
         break;

src/date_utils.ts

@@ -728,6 +728,10 @@ export interface DateFilterOptions {
   yearItemNumber?: number;
 }
 
+export type DateFilterOptionsWithDisabled = DateFilterOptions & {
+  disabled?: boolean;
+};
+
 /**
  * Checks if a day is disabled.
  *
@@ -745,8 +749,13 @@ export function isDayDisabled(
     includeDates,
     includeDateIntervals,
     filterDate,
-  }: DateFilterOptions = {},
+    disabled,
+  }: DateFilterOptionsWithDisabled = {},
 ): boolean {
+  if (disabled) {
+    return true;
+  }
+
   return (
     isOutOfBounds(day, { minDate, maxDate }) ||
     (excludeDates &&
@@ -898,11 +907,21 @@ export function isQuarterDisabled(
     excludeDates,
     includeDates,
     filterDate,
+    disabled,
   }: Pick<
-    DateFilterOptions,
-    "minDate" | "maxDate" | "excludeDates" | "includeDates" | "filterDate"
+    DateFilterOptionsWithDisabled,
+    | "minDate"
+    | "maxDate"
+    | "excludeDates"
+    | "includeDates"
+    | "filterDate"
+    | "disabled"
   > = {},
 ): boolean {
+  if (disabled) {
+    return true;
+  }
+
   return (
     isOutOfBounds(quarter, { minDate, maxDate }) ||
     excludeDates?.some((excludeDate) =>
@@ -941,11 +960,21 @@ export function isYearDisabled(
     excludeDates,
     includeDates,
     filterDate,
+    disabled,
   }: Pick<
-    DateFilterOptions,
-    "minDate" | "maxDate" | "excludeDates" | "includeDates" | "filterDate"
+    DateFilterOptionsWithDisabled,
+    | "minDate"
+    | "maxDate"
+    | "excludeDates"
+    | "includeDates"
+    | "filterDate"
+    | "disabled"
   > = {},
 ): boolean {
+  if (disabled) {
+    return true;
+  }
+
   const date = new Date(year, 0, 1);
   return (
     isOutOfBounds(date, {

src/day.tsx

@@ -16,7 +16,7 @@ import {
   getDayOfWeekCode,
   getStartOfWeek,
   formatDate,
-  type DateFilterOptions,
+  type DateFilterOptionsWithDisabled,
   type DateNumberType,
   type Locale,
   type HolidaysMap,
@@ -25,14 +25,15 @@ import {
 
 interface DayProps
   extends Pick<
-    DateFilterOptions,
+    DateFilterOptionsWithDisabled,
     | "minDate"
     | "maxDate"
     | "excludeDates"
     | "excludeDateIntervals"
     | "includeDateIntervals"
     | "includeDates"
     | "filterDate"
+    | "disabled"
   > {
   ariaLabelPrefixWhenEnabled?: string;
   ariaLabelPrefixWhenDisabled?: string;
@@ -210,6 +211,7 @@ export default class Day extends Component<DayProps> {
       includeDateIntervals: this.props.includeDateIntervals,
       includeDates: this.props.includeDates,
       filterDate: this.props.filterDate,
+      disabled: this.props.disabled,
     });
 
   isExcluded = () =>

src/month.tsx

@@ -250,6 +250,7 @@ export default class Month extends Component<MonthProps> {
       includeDateIntervals: this.props.includeDateIntervals,
       includeDates: this.props.includeDates,
       filterDate: this.props.filterDate,
+      disabled: this.props.disabled,
     });
 
   isExcluded = (day: Date) =>
@@ -783,8 +784,17 @@ export default class Month extends Component<MonthProps> {
     isDisabled: boolean;
     labelDate: Date;
   } => {
-    const { day, minDate, maxDate, excludeDates, includeDates } = this.props;
+    const { day, disabled, minDate, maxDate, excludeDates, includeDates } =
+      this.props;
     const labelDate = setMonth(day, month);
+
+    if (disabled) {
+      return {
+        isDisabled: true,
+        labelDate: setMonth(day, month),
+      };
+    }
+
     return {
       isDisabled:
         ((minDate || maxDate || excludeDates || includeDates) &&
@@ -919,10 +929,16 @@ export default class Month extends Component<MonthProps> {
       filterDate,
       preSelection,
       disabledKeyboardNavigation,
+      disabled,
     } = this.props;
 
     const isDisabled =
-      (minDate || maxDate || excludeDates || includeDates || filterDate) &&
+      (minDate ||
+        maxDate ||
+        excludeDates ||
+        includeDates ||
+        filterDate ||
+        disabled) &&
       isQuarterDisabled(setQuarter(day, q), this.props);
 
     return clsx(

src/stylesheets/datepicker.scss

@@ -399,6 +399,11 @@ h2.react-datepicker__current-month {
   line-height: $datepicker__item-size;
   text-align: center;
   margin: $datepicker__day-margin;
+
+  &--disabled {
+    cursor: default;
+    color: $datepicker__muted-color;
+  }
 }
 
 .react-datepicker__day,

src/test/datepicker_test.test.tsx

@@ -4883,4 +4883,76 @@ describe("DatePicker", () => {
       expect(eventObject.target?.value).toBe(inputValue);
     });
   });
+
+  describe("disabled", () => {
+    const validateAllDisabled = (container: HTMLElement, className: string) => {
+      const allDays = Array.from(container.querySelectorAll(`.${className}`));
+      expect(allDays.length).toBeGreaterThan(0);
+      expect(
+        allDays.every((day) =>
+          day.classList.contains(`${className}--disabled`),
+        ),
+      ).toBe(true);
+    };
+
+    const validateNonExistence = (
+      container: HTMLElement,
+      querySelector: string,
+    ) => {
+      const element = container.querySelector(querySelector);
+      expect(element).toBeFalsy();
+    };
+
+    it("should disable all days and headers in DatePicker when disabled prop is true", () => {
+      const { container } = render(<DatePicker inline disabled />);
+
+      validateAllDisabled(container, "react-datepicker__day");
+      validateAllDisabled(container, "react-datepicker__day-name");
+      validateNonExistence(container, "react-datepicker__navigation");
+    });
+
+    it("should disable all days and headers in DatePicker Range Selector when disabled prop is true", () => {
+      const { container } = render(<DatePicker selectsRange inline disabled />);
+
+      validateAllDisabled(container, "react-datepicker__day");
+      validateAllDisabled(container, "react-datepicker__day-name");
+      validateNonExistence(container, "react-datepicker__navigation");
+    });
+
+    it("should disable all days and headers in MonthPicker when disabled prop is true", () => {
+      const { container } = render(
+        <DatePicker showMonthYearPicker inline disabled />,
+      );
+
+      validateAllDisabled(container, "react-datepicker__month-text");
+      validateNonExistence(container, "react-datepicker__navigation");
+    });
+
+    it("should disable all days and headers in YearPicker when disabled prop is true", () => {
+      const { container } = render(
+        <DatePicker showYearPicker inline disabled />,
+      );
+
+      validateAllDisabled(container, "react-datepicker__year-text");
+      validateNonExistence(container, "react-datepicker__navigation");
+    });
+
+    it("should disable all days and headers in WeekPicker when disabled prop is true", () => {
+      const { container } = render(
+        <DatePicker showWeekNumbers showWeekPicker inline disabled />,
+      );
+
+      validateAllDisabled(container, "react-datepicker__day");
+      validateNonExistence(container, "react-datepicker__navigation");
+    });
+
+    it("should disable all days and headers in QuarterPicker when disabled prop is true", () => {
+      const { container } = render(
+        <DatePicker showQuarterYearPicker inline disabled />,
+      );
+
+      validateAllDisabled(container, "react-datepicker__quarter-text");
+      validateNonExistence(container, "react-datepicker__navigation");
+    });
+  });
 });

src/year.tsx

@@ -2,7 +2,7 @@ import { clsx } from "clsx";
 import React, { Component, createRef } from "react";
 
 import {
-  type DateFilterOptions,
+  type DateFilterOptionsWithDisabled,
   addYears,
   getStartOfYear,
   getYear,
@@ -24,8 +24,13 @@ const VERTICAL_NAVIGATION_OFFSET = 3;
 
 interface YearProps
   extends Pick<
-    DateFilterOptions,
-    "minDate" | "maxDate" | "excludeDates" | "includeDates" | "filterDate"
+    DateFilterOptionsWithDisabled,
+    | "minDate"
+    | "maxDate"
+    | "excludeDates"
+    | "includeDates"
+    | "filterDate"
+    | "disabled"
   > {
   clearSelectingDate?: VoidFunction;
   date?: Date;
@@ -381,6 +386,7 @@ export default class Year extends Component<YearProps> {
   getYearClassNames = (y: number) => {
     const {
       date,
+      disabled,
       minDate,
       maxDate,
       excludeDates,
@@ -396,7 +402,12 @@ export default class Year extends Component<YearProps> {
       {
         "react-datepicker__year-text--selected": this.isSelectedYear(y),
         "react-datepicker__year-text--disabled":
-          (minDate || maxDate || excludeDates || includeDates || filterDate) &&
+          (minDate ||
+            maxDate ||
+            excludeDates ||
+            includeDates ||
+            filterDate ||
+            disabled) &&
           isYearDisabled(y, this.props),
         "react-datepicker__year-text--keyboard-selected":
           this.isKeyboardSelected(y),