feat(Datagrid): call onClearFilters when clearing filters from tag su…

…mmary (carbon-design-system#5892)

* feat: add onClearFilters to FilterFlyoutProps

* feat: call onClearFilters callback in filter summary

* fix: remove undefined check

* chore: add onClearFilters method docs

packages/ibm-products/src/components/Datagrid/Datagrid/DatagridContent.tsx

@@ -217,7 +217,12 @@ export const DatagridContent = ({
       <FilterSummary
         className={`${blockClass}__filter-summary`}
         filters={filterTags}
-        clearFilters={() => EventEmitter.dispatch(CLEAR_FILTERS, tableId)}
+        clearFilters={() => {
+          EventEmitter.dispatch(CLEAR_FILTERS, tableId);
+          if (typeof filterProps?.onClearFilters === 'function') {
+            filterProps.onClearFilters();
+          }
+        }}
         renderLabel={filterProps?.renderLabel}
         overflowType="tag"
       />

packages/ibm-products/src/components/Datagrid/Extensions/Filtering/Filtering.docs-page.js

@@ -430,6 +430,27 @@ const datagridState = useDatagrid({
     }
   });
 
+  return <Datagrid datagridState={datagridState} />;
+          `,
+        },
+      },
+      {
+        subTitle: `onClearFilters method`,
+        source: {
+          language: 'jsx',
+          code: `
+/*
+  This method is called when the user clears filters from the filters summary.
+*/
+
+const datagridState = useDatagrid({
+    columns,
+    data,
+    filterProps: {
+      onClearFilters: () => console.log('callback to be run after clearing all filters'),
+    }
+  });
+
   return <Datagrid datagridState={datagridState} />;
           `,
         },

packages/ibm-products/src/components/Datagrid/types/index.ts

@@ -136,6 +136,7 @@ export interface FilterFlyoutProps {
   flyoutIconDescription?: string;
   onFlyoutClose?: () => void;
   onFlyoutOpen?: () => void;
+  onClearFilters?: () => void;
   panelIconDescription?: string;
   primaryActionLabel?: string;
   reactTableFiltersState?: ReactTableFiltersState[];