docs(material/datepicker): Added context to docs for date picker null value #29385 (#29387)

hhaasbroek · crisbeto · commit a0836199e7e6 · 2024-07-05T14:58:15.000+02:00
* Added context for why the null value is there * Fixed formatting * removed extra * (cherry picked from commit 39b15dc)
diff --git a/src/material/datepicker/datepicker-input-base.ts b/src/material/datepicker/datepicker-input-base.ts
@@ -56,7 +56,11 @@ export class MatDatepickerInputEvent<D, S = unknown> {
   }
 }
 
-/** Function that can be used to filter out dates from a calendar. */
+/**
+ * Function that can be used to filter out dates from a calendar.
+ * Datepicker can sometimes receive a null value as input for the date argument.
+ * This doesn't represent a "null date" but rather signifies that no date has been selected yet in the calendar.
+ */
 export type DateFilterFn<D> = (date: D | null) => boolean;
 
 /**

Original file line number	Diff line number	Diff line change
`@@ -56,7 +56,11 @@ export class MatDatepickerInputEvent<D, S = unknown> {`
`56`	`56`	`}`
`57`	`57`	`}`
`58`	`58`
`59`		`-/** Function that can be used to filter out dates from a calendar. */`
	`59`	`+/**`
	`60`	`+ * Function that can be used to filter out dates from a calendar.`
	`61`	`+ * Datepicker can sometimes receive a null value as input for the date argument.`
	`62`	`+ * This doesn't represent a "null date" but rather signifies that no date has been selected yet in the calendar.`
	`63`	`+ */`
`60`	`64`	`export type DateFilterFn<D> = (date: D \| null) => boolean;`
`61`	`65`
`62`	`66`	`/**`