[material-ui][Snackbar] Skip default behaviour when defaultMuiPrevent… (#45629)

Author: sai6855

docs/data/material/components/snackbars/snackbars.md

@@ -67,6 +67,23 @@ You can use the `TransitionComponent` prop to change the transition of the Snack
 
 ## Customization
 
+### Preventing default click away event
+
+If you would like to prevent the default onClickAway behavior, you can set the event's `defaultMuiPrevented` property to `true`:
+
+```jsx
+<Snackbar
+  slotProps={{
+    clickAwayListener: {
+      onClickAway: (event) => {
+        // Prevent's default 'onClickAway' behavior.
+        event.defaultMuiPrevented = true;
+      },
+    },
+  }}
+/>
+```
+
 ### Use with Alerts
 
 Use an Alert inside a Snackbar for messages that communicate a certain severity.

packages/mui-material/src/Snackbar/Snackbar.js

@@ -188,7 +188,11 @@ const Snackbar = React.forwardRef(function Snackbar(inProps, ref) {
       externalForwardedProps,
       getSlotProps: (handlers) => ({
         onClickAway: (...params) => {
+          const event = params[0];
           handlers.onClickAway?.(...params);
+          if (event?.defaultMuiPrevented) {
+            return;
+          }
           onClickAway(...params);
         },
       }),

packages/mui-material/src/Snackbar/Snackbar.test.js

@@ -622,4 +622,27 @@ describe('<Snackbar />', () => {
       expect(child).toHaveComputedStyle({ transitionDuration: '0.001s, 0.001s' });
     });
   });
+
+  it('should skip default clickAway behavior when defaultMuiPrevented is true', () => {
+    const handleClose = spy();
+    render(
+      <Snackbar
+        open
+        onClose={handleClose}
+        message="message"
+        slotProps={{
+          clickAwayListener: {
+            onClickAway: (event) => {
+              event.defaultMuiPrevented = true;
+            },
+          },
+        }}
+      />,
+    );
+
+    const event = new window.Event('click', { bubbles: true, cancelable: true });
+    document.body.dispatchEvent(event);
+
+    expect(handleClose.callCount).to.equal(0);
+  });
 });