paradiego
This commit is contained in:
130
node_modules/@mui/material/Snackbar/Snackbar.d.ts
generated
vendored
Normal file
130
node_modules/@mui/material/Snackbar/Snackbar.d.ts
generated
vendored
Normal file
@@ -0,0 +1,130 @@
|
||||
import * as React from 'react';
|
||||
import { SxProps } from '@mui/system';
|
||||
import { ClickAwayListenerProps } from '../ClickAwayListener';
|
||||
import { Theme } from '../styles';
|
||||
import { InternalStandardProps as StandardProps } from '..';
|
||||
import { SnackbarContentProps } from '../SnackbarContent';
|
||||
import { TransitionProps } from '../transitions/transition';
|
||||
import { SnackbarClasses } from './snackbarClasses';
|
||||
|
||||
export interface SnackbarOrigin {
|
||||
vertical: 'top' | 'bottom';
|
||||
horizontal: 'left' | 'center' | 'right';
|
||||
}
|
||||
|
||||
export type SnackbarCloseReason = 'timeout' | 'clickaway' | 'escapeKeyDown';
|
||||
|
||||
export interface SnackbarProps extends StandardProps<React.HTMLAttributes<HTMLDivElement>> {
|
||||
/**
|
||||
* The action to display. It renders after the message, at the end of the snackbar.
|
||||
*/
|
||||
action?: SnackbarContentProps['action'];
|
||||
/**
|
||||
* The anchor of the `Snackbar`.
|
||||
* On smaller screens, the component grows to occupy all the available width,
|
||||
* the horizontal alignment is ignored.
|
||||
* @default { vertical: 'bottom', horizontal: 'left' }
|
||||
*/
|
||||
anchorOrigin?: SnackbarOrigin;
|
||||
/**
|
||||
* The number of milliseconds to wait before automatically calling the
|
||||
* `onClose` function. `onClose` should then set the state of the `open`
|
||||
* prop to hide the Snackbar. This behavior is disabled by default with
|
||||
* the `null` value.
|
||||
* @default null
|
||||
*/
|
||||
autoHideDuration?: number | null;
|
||||
/**
|
||||
* Replace the `SnackbarContent` component.
|
||||
*/
|
||||
children?: React.ReactElement<unknown, any>;
|
||||
/**
|
||||
* Override or extend the styles applied to the component.
|
||||
*/
|
||||
classes?: Partial<SnackbarClasses>;
|
||||
/**
|
||||
* Props applied to the `ClickAwayListener` element.
|
||||
*/
|
||||
ClickAwayListenerProps?: Partial<ClickAwayListenerProps>;
|
||||
/**
|
||||
* Props applied to the [`SnackbarContent`](https://mui.com/material-ui/api/snackbar-content/) element.
|
||||
*/
|
||||
ContentProps?: Partial<SnackbarContentProps>;
|
||||
/**
|
||||
* If `true`, the `autoHideDuration` timer will expire even if the window is not focused.
|
||||
* @default false
|
||||
*/
|
||||
disableWindowBlurListener?: boolean;
|
||||
/**
|
||||
* When displaying multiple consecutive snackbars using a single parent-rendered
|
||||
* `<Snackbar/>`, add the `key` prop to ensure independent treatment of each message.
|
||||
* For instance, use `<Snackbar key={message} />`. Otherwise, messages might update
|
||||
* in place, and features like `autoHideDuration` could be affected.
|
||||
*/
|
||||
key?: any;
|
||||
/**
|
||||
* The message to display.
|
||||
*/
|
||||
message?: SnackbarContentProps['message'];
|
||||
/**
|
||||
* Callback fired when the component requests to be closed.
|
||||
* Typically `onClose` is used to set state in the parent component,
|
||||
* which is used to control the `Snackbar` `open` prop.
|
||||
* The `reason` parameter can optionally be used to control the response to `onClose`,
|
||||
* for example ignoring `clickaway`.
|
||||
*
|
||||
* @param {React.SyntheticEvent<any> | Event} event The event source of the callback.
|
||||
* @param {string} reason Can be: `"timeout"` (`autoHideDuration` expired), `"clickaway"`, or `"escapeKeyDown"`.
|
||||
*/
|
||||
onClose?: (event: React.SyntheticEvent<any> | Event, reason: SnackbarCloseReason) => void;
|
||||
/**
|
||||
* If `true`, the component is shown.
|
||||
*/
|
||||
open?: boolean;
|
||||
/**
|
||||
* The number of milliseconds to wait before dismissing after user interaction.
|
||||
* If `autoHideDuration` prop isn't specified, it does nothing.
|
||||
* If `autoHideDuration` prop is specified but `resumeHideDuration` isn't,
|
||||
* we default to `autoHideDuration / 2` ms.
|
||||
*/
|
||||
resumeHideDuration?: number;
|
||||
/**
|
||||
* The system prop that allows defining system overrides as well as additional CSS styles.
|
||||
*/
|
||||
sx?: SxProps<Theme>;
|
||||
/**
|
||||
* The component used for the transition.
|
||||
* [Follow this guide](https://mui.com/material-ui/transitions/#transitioncomponent-prop) to learn more about the requirements for this component.
|
||||
* @default Grow
|
||||
*/
|
||||
TransitionComponent?: React.JSXElementConstructor<
|
||||
TransitionProps & { children: React.ReactElement<unknown, any> }
|
||||
>;
|
||||
/**
|
||||
* The duration for the transition, in milliseconds.
|
||||
* You may specify a single timeout for all transitions, or individually with an object.
|
||||
* @default {
|
||||
* enter: theme.transitions.duration.enteringScreen,
|
||||
* exit: theme.transitions.duration.leavingScreen,
|
||||
* }
|
||||
*/
|
||||
transitionDuration?: TransitionProps['timeout'];
|
||||
/**
|
||||
* Props applied to the transition element.
|
||||
* By default, the element is based on this [`Transition`](https://reactcommunity.org/react-transition-group/transition/) component.
|
||||
* @default {}
|
||||
*/
|
||||
TransitionProps?: TransitionProps;
|
||||
}
|
||||
|
||||
/**
|
||||
*
|
||||
* Demos:
|
||||
*
|
||||
* - [Snackbar](https://mui.com/material-ui/react-snackbar/)
|
||||
*
|
||||
* API:
|
||||
*
|
||||
* - [Snackbar API](https://mui.com/material-ui/api/snackbar/)
|
||||
*/
|
||||
export default function Snackbar(props: SnackbarProps): React.JSX.Element;
|
||||
342
node_modules/@mui/material/Snackbar/Snackbar.js
generated
vendored
Normal file
342
node_modules/@mui/material/Snackbar/Snackbar.js
generated
vendored
Normal file
@@ -0,0 +1,342 @@
|
||||
'use client';
|
||||
|
||||
import * as React from 'react';
|
||||
import PropTypes from 'prop-types';
|
||||
import composeClasses from '@mui/utils/composeClasses';
|
||||
import useSlotProps from '@mui/utils/useSlotProps';
|
||||
import useSnackbar from "./useSnackbar.js";
|
||||
import ClickAwayListener from "../ClickAwayListener/index.js";
|
||||
import { styled, useTheme } from "../zero-styled/index.js";
|
||||
import memoTheme from "../utils/memoTheme.js";
|
||||
import { useDefaultProps } from "../DefaultPropsProvider/index.js";
|
||||
import capitalize from "../utils/capitalize.js";
|
||||
import Grow from "../Grow/index.js";
|
||||
import SnackbarContent from "../SnackbarContent/index.js";
|
||||
import { getSnackbarUtilityClass } from "./snackbarClasses.js";
|
||||
import { jsx as _jsx } from "react/jsx-runtime";
|
||||
const useUtilityClasses = ownerState => {
|
||||
const {
|
||||
classes,
|
||||
anchorOrigin
|
||||
} = ownerState;
|
||||
const slots = {
|
||||
root: ['root', `anchorOrigin${capitalize(anchorOrigin.vertical)}${capitalize(anchorOrigin.horizontal)}`]
|
||||
};
|
||||
return composeClasses(slots, getSnackbarUtilityClass, classes);
|
||||
};
|
||||
const SnackbarRoot = styled('div', {
|
||||
name: 'MuiSnackbar',
|
||||
slot: 'Root',
|
||||
overridesResolver: (props, styles) => {
|
||||
const {
|
||||
ownerState
|
||||
} = props;
|
||||
return [styles.root, styles[`anchorOrigin${capitalize(ownerState.anchorOrigin.vertical)}${capitalize(ownerState.anchorOrigin.horizontal)}`]];
|
||||
}
|
||||
})(memoTheme(({
|
||||
theme
|
||||
}) => ({
|
||||
zIndex: (theme.vars || theme).zIndex.snackbar,
|
||||
position: 'fixed',
|
||||
display: 'flex',
|
||||
left: 8,
|
||||
right: 8,
|
||||
justifyContent: 'center',
|
||||
alignItems: 'center',
|
||||
variants: [{
|
||||
props: ({
|
||||
ownerState
|
||||
}) => ownerState.anchorOrigin.vertical === 'top',
|
||||
style: {
|
||||
top: 8,
|
||||
[theme.breakpoints.up('sm')]: {
|
||||
top: 24
|
||||
}
|
||||
}
|
||||
}, {
|
||||
props: ({
|
||||
ownerState
|
||||
}) => ownerState.anchorOrigin.vertical !== 'top',
|
||||
style: {
|
||||
bottom: 8,
|
||||
[theme.breakpoints.up('sm')]: {
|
||||
bottom: 24
|
||||
}
|
||||
}
|
||||
}, {
|
||||
props: ({
|
||||
ownerState
|
||||
}) => ownerState.anchorOrigin.horizontal === 'left',
|
||||
style: {
|
||||
justifyContent: 'flex-start',
|
||||
[theme.breakpoints.up('sm')]: {
|
||||
left: 24,
|
||||
right: 'auto'
|
||||
}
|
||||
}
|
||||
}, {
|
||||
props: ({
|
||||
ownerState
|
||||
}) => ownerState.anchorOrigin.horizontal === 'right',
|
||||
style: {
|
||||
justifyContent: 'flex-end',
|
||||
[theme.breakpoints.up('sm')]: {
|
||||
right: 24,
|
||||
left: 'auto'
|
||||
}
|
||||
}
|
||||
}, {
|
||||
props: ({
|
||||
ownerState
|
||||
}) => ownerState.anchorOrigin.horizontal === 'center',
|
||||
style: {
|
||||
[theme.breakpoints.up('sm')]: {
|
||||
left: '50%',
|
||||
right: 'auto',
|
||||
transform: 'translateX(-50%)'
|
||||
}
|
||||
}
|
||||
}]
|
||||
})));
|
||||
const Snackbar = /*#__PURE__*/React.forwardRef(function Snackbar(inProps, ref) {
|
||||
const props = useDefaultProps({
|
||||
props: inProps,
|
||||
name: 'MuiSnackbar'
|
||||
});
|
||||
const theme = useTheme();
|
||||
const defaultTransitionDuration = {
|
||||
enter: theme.transitions.duration.enteringScreen,
|
||||
exit: theme.transitions.duration.leavingScreen
|
||||
};
|
||||
const {
|
||||
action,
|
||||
anchorOrigin: {
|
||||
vertical,
|
||||
horizontal
|
||||
} = {
|
||||
vertical: 'bottom',
|
||||
horizontal: 'left'
|
||||
},
|
||||
autoHideDuration = null,
|
||||
children,
|
||||
className,
|
||||
ClickAwayListenerProps,
|
||||
ContentProps,
|
||||
disableWindowBlurListener = false,
|
||||
message,
|
||||
onBlur,
|
||||
onClose,
|
||||
onFocus,
|
||||
onMouseEnter,
|
||||
onMouseLeave,
|
||||
open,
|
||||
resumeHideDuration,
|
||||
TransitionComponent = Grow,
|
||||
transitionDuration = defaultTransitionDuration,
|
||||
TransitionProps: {
|
||||
onEnter,
|
||||
onExited,
|
||||
...TransitionProps
|
||||
} = {},
|
||||
...other
|
||||
} = props;
|
||||
const ownerState = {
|
||||
...props,
|
||||
anchorOrigin: {
|
||||
vertical,
|
||||
horizontal
|
||||
},
|
||||
autoHideDuration,
|
||||
disableWindowBlurListener,
|
||||
TransitionComponent,
|
||||
transitionDuration
|
||||
};
|
||||
const classes = useUtilityClasses(ownerState);
|
||||
const {
|
||||
getRootProps,
|
||||
onClickAway
|
||||
} = useSnackbar({
|
||||
...ownerState
|
||||
});
|
||||
const [exited, setExited] = React.useState(true);
|
||||
const rootProps = useSlotProps({
|
||||
elementType: SnackbarRoot,
|
||||
getSlotProps: getRootProps,
|
||||
externalForwardedProps: other,
|
||||
ownerState,
|
||||
additionalProps: {
|
||||
ref
|
||||
},
|
||||
className: [classes.root, className]
|
||||
});
|
||||
const handleExited = node => {
|
||||
setExited(true);
|
||||
if (onExited) {
|
||||
onExited(node);
|
||||
}
|
||||
};
|
||||
const handleEnter = (node, isAppearing) => {
|
||||
setExited(false);
|
||||
if (onEnter) {
|
||||
onEnter(node, isAppearing);
|
||||
}
|
||||
};
|
||||
|
||||
// So we only render active snackbars.
|
||||
if (!open && exited) {
|
||||
return null;
|
||||
}
|
||||
return /*#__PURE__*/_jsx(ClickAwayListener, {
|
||||
onClickAway: onClickAway,
|
||||
...ClickAwayListenerProps,
|
||||
children: /*#__PURE__*/_jsx(SnackbarRoot, {
|
||||
...rootProps,
|
||||
children: /*#__PURE__*/_jsx(TransitionComponent, {
|
||||
appear: true,
|
||||
in: open,
|
||||
timeout: transitionDuration,
|
||||
direction: vertical === 'top' ? 'down' : 'up',
|
||||
onEnter: handleEnter,
|
||||
onExited: handleExited,
|
||||
...TransitionProps,
|
||||
children: children || /*#__PURE__*/_jsx(SnackbarContent, {
|
||||
message: message,
|
||||
action: action,
|
||||
...ContentProps
|
||||
})
|
||||
})
|
||||
})
|
||||
});
|
||||
});
|
||||
process.env.NODE_ENV !== "production" ? Snackbar.propTypes /* remove-proptypes */ = {
|
||||
// ┌────────────────────────────── Warning ──────────────────────────────┐
|
||||
// │ These PropTypes are generated from the TypeScript type definitions. │
|
||||
// │ To update them, edit the d.ts file and run `pnpm proptypes`. │
|
||||
// └─────────────────────────────────────────────────────────────────────┘
|
||||
/**
|
||||
* The action to display. It renders after the message, at the end of the snackbar.
|
||||
*/
|
||||
action: PropTypes.node,
|
||||
/**
|
||||
* The anchor of the `Snackbar`.
|
||||
* On smaller screens, the component grows to occupy all the available width,
|
||||
* the horizontal alignment is ignored.
|
||||
* @default { vertical: 'bottom', horizontal: 'left' }
|
||||
*/
|
||||
anchorOrigin: PropTypes.shape({
|
||||
horizontal: PropTypes.oneOf(['center', 'left', 'right']).isRequired,
|
||||
vertical: PropTypes.oneOf(['bottom', 'top']).isRequired
|
||||
}),
|
||||
/**
|
||||
* The number of milliseconds to wait before automatically calling the
|
||||
* `onClose` function. `onClose` should then set the state of the `open`
|
||||
* prop to hide the Snackbar. This behavior is disabled by default with
|
||||
* the `null` value.
|
||||
* @default null
|
||||
*/
|
||||
autoHideDuration: PropTypes.number,
|
||||
/**
|
||||
* Replace the `SnackbarContent` component.
|
||||
*/
|
||||
children: PropTypes.element,
|
||||
/**
|
||||
* Override or extend the styles applied to the component.
|
||||
*/
|
||||
classes: PropTypes.object,
|
||||
/**
|
||||
* @ignore
|
||||
*/
|
||||
className: PropTypes.string,
|
||||
/**
|
||||
* Props applied to the `ClickAwayListener` element.
|
||||
*/
|
||||
ClickAwayListenerProps: PropTypes.object,
|
||||
/**
|
||||
* Props applied to the [`SnackbarContent`](https://mui.com/material-ui/api/snackbar-content/) element.
|
||||
*/
|
||||
ContentProps: PropTypes.object,
|
||||
/**
|
||||
* If `true`, the `autoHideDuration` timer will expire even if the window is not focused.
|
||||
* @default false
|
||||
*/
|
||||
disableWindowBlurListener: PropTypes.bool,
|
||||
/**
|
||||
* When displaying multiple consecutive snackbars using a single parent-rendered
|
||||
* `<Snackbar/>`, add the `key` prop to ensure independent treatment of each message.
|
||||
* For instance, use `<Snackbar key={message} />`. Otherwise, messages might update
|
||||
* in place, and features like `autoHideDuration` could be affected.
|
||||
*/
|
||||
key: () => null,
|
||||
/**
|
||||
* The message to display.
|
||||
*/
|
||||
message: PropTypes.node,
|
||||
/**
|
||||
* @ignore
|
||||
*/
|
||||
onBlur: PropTypes.func,
|
||||
/**
|
||||
* Callback fired when the component requests to be closed.
|
||||
* Typically `onClose` is used to set state in the parent component,
|
||||
* which is used to control the `Snackbar` `open` prop.
|
||||
* The `reason` parameter can optionally be used to control the response to `onClose`,
|
||||
* for example ignoring `clickaway`.
|
||||
*
|
||||
* @param {React.SyntheticEvent<any> | Event} event The event source of the callback.
|
||||
* @param {string} reason Can be: `"timeout"` (`autoHideDuration` expired), `"clickaway"`, or `"escapeKeyDown"`.
|
||||
*/
|
||||
onClose: PropTypes.func,
|
||||
/**
|
||||
* @ignore
|
||||
*/
|
||||
onFocus: PropTypes.func,
|
||||
/**
|
||||
* @ignore
|
||||
*/
|
||||
onMouseEnter: PropTypes.func,
|
||||
/**
|
||||
* @ignore
|
||||
*/
|
||||
onMouseLeave: PropTypes.func,
|
||||
/**
|
||||
* If `true`, the component is shown.
|
||||
*/
|
||||
open: PropTypes.bool,
|
||||
/**
|
||||
* The number of milliseconds to wait before dismissing after user interaction.
|
||||
* If `autoHideDuration` prop isn't specified, it does nothing.
|
||||
* If `autoHideDuration` prop is specified but `resumeHideDuration` isn't,
|
||||
* we default to `autoHideDuration / 2` ms.
|
||||
*/
|
||||
resumeHideDuration: PropTypes.number,
|
||||
/**
|
||||
* The system prop that allows defining system overrides as well as additional CSS styles.
|
||||
*/
|
||||
sx: PropTypes.oneOfType([PropTypes.arrayOf(PropTypes.oneOfType([PropTypes.func, PropTypes.object, PropTypes.bool])), PropTypes.func, PropTypes.object]),
|
||||
/**
|
||||
* The component used for the transition.
|
||||
* [Follow this guide](https://mui.com/material-ui/transitions/#transitioncomponent-prop) to learn more about the requirements for this component.
|
||||
* @default Grow
|
||||
*/
|
||||
TransitionComponent: PropTypes.elementType,
|
||||
/**
|
||||
* The duration for the transition, in milliseconds.
|
||||
* You may specify a single timeout for all transitions, or individually with an object.
|
||||
* @default {
|
||||
* enter: theme.transitions.duration.enteringScreen,
|
||||
* exit: theme.transitions.duration.leavingScreen,
|
||||
* }
|
||||
*/
|
||||
transitionDuration: PropTypes.oneOfType([PropTypes.number, PropTypes.shape({
|
||||
appear: PropTypes.number,
|
||||
enter: PropTypes.number,
|
||||
exit: PropTypes.number
|
||||
})]),
|
||||
/**
|
||||
* Props applied to the transition element.
|
||||
* By default, the element is based on this [`Transition`](https://reactcommunity.org/react-transition-group/transition/) component.
|
||||
* @default {}
|
||||
*/
|
||||
TransitionProps: PropTypes.object
|
||||
} : void 0;
|
||||
export default Snackbar;
|
||||
5
node_modules/@mui/material/Snackbar/index.d.ts
generated
vendored
Normal file
5
node_modules/@mui/material/Snackbar/index.d.ts
generated
vendored
Normal file
@@ -0,0 +1,5 @@
|
||||
export { default } from './Snackbar';
|
||||
export * from './Snackbar';
|
||||
|
||||
export { default as snackbarClasses } from './snackbarClasses';
|
||||
export * from './snackbarClasses';
|
||||
3
node_modules/@mui/material/Snackbar/index.js
generated
vendored
Normal file
3
node_modules/@mui/material/Snackbar/index.js
generated
vendored
Normal file
@@ -0,0 +1,3 @@
|
||||
export { default } from "./Snackbar.js";
|
||||
export { default as snackbarClasses } from "./snackbarClasses.js";
|
||||
export * from "./snackbarClasses.js";
|
||||
6
node_modules/@mui/material/Snackbar/package.json
generated
vendored
Normal file
6
node_modules/@mui/material/Snackbar/package.json
generated
vendored
Normal file
@@ -0,0 +1,6 @@
|
||||
{
|
||||
"sideEffects": false,
|
||||
"module": "./index.js",
|
||||
"main": "../node/Snackbar/index.js",
|
||||
"types": "./index.d.ts"
|
||||
}
|
||||
20
node_modules/@mui/material/Snackbar/snackbarClasses.d.ts
generated
vendored
Normal file
20
node_modules/@mui/material/Snackbar/snackbarClasses.d.ts
generated
vendored
Normal file
@@ -0,0 +1,20 @@
|
||||
export interface SnackbarClasses {
|
||||
/** Styles applied to the root element. */
|
||||
root: string;
|
||||
/** Styles applied to the root element if `anchorOrigin={{ 'top', 'center' }}`. */
|
||||
anchorOriginTopCenter: string;
|
||||
/** Styles applied to the root element if `anchorOrigin={{ 'bottom', 'center' }}`. */
|
||||
anchorOriginBottomCenter: string;
|
||||
/** Styles applied to the root element if `anchorOrigin={{ 'top', 'right' }}`. */
|
||||
anchorOriginTopRight: string;
|
||||
/** Styles applied to the root element if `anchorOrigin={{ 'bottom', 'right' }}`. */
|
||||
anchorOriginBottomRight: string;
|
||||
/** Styles applied to the root element if `anchorOrigin={{ 'top', 'left' }}`. */
|
||||
anchorOriginTopLeft: string;
|
||||
/** Styles applied to the root element if `anchorOrigin={{ 'bottom', 'left' }}`. */
|
||||
anchorOriginBottomLeft: string;
|
||||
}
|
||||
export type SnackbarClassKey = keyof SnackbarClasses;
|
||||
export declare function getSnackbarUtilityClass(slot: string): string;
|
||||
declare const snackbarClasses: SnackbarClasses;
|
||||
export default snackbarClasses;
|
||||
7
node_modules/@mui/material/Snackbar/snackbarClasses.js
generated
vendored
Normal file
7
node_modules/@mui/material/Snackbar/snackbarClasses.js
generated
vendored
Normal file
@@ -0,0 +1,7 @@
|
||||
import generateUtilityClasses from '@mui/utils/generateUtilityClasses';
|
||||
import generateUtilityClass from '@mui/utils/generateUtilityClass';
|
||||
export function getSnackbarUtilityClass(slot) {
|
||||
return generateUtilityClass('MuiSnackbar', slot);
|
||||
}
|
||||
const snackbarClasses = generateUtilityClasses('MuiSnackbar', ['root', 'anchorOriginTopCenter', 'anchorOriginBottomCenter', 'anchorOriginTopRight', 'anchorOriginBottomRight', 'anchorOriginTopLeft', 'anchorOriginBottomLeft']);
|
||||
export default snackbarClasses;
|
||||
14
node_modules/@mui/material/Snackbar/useSnackbar.d.ts
generated
vendored
Normal file
14
node_modules/@mui/material/Snackbar/useSnackbar.d.ts
generated
vendored
Normal file
@@ -0,0 +1,14 @@
|
||||
import { UseSnackbarParameters, UseSnackbarReturnValue } from './useSnackbar.types';
|
||||
/**
|
||||
* The basic building block for creating custom snackbar.
|
||||
*
|
||||
* Demos:
|
||||
*
|
||||
* - [Snackbar](https://mui.com/base-ui/react-snackbar/#hook)
|
||||
*
|
||||
* API:
|
||||
*
|
||||
* - [useSnackbar API](https://mui.com/base-ui/react-snackbar/hooks-api/#use-snackbar)
|
||||
*/
|
||||
declare function useSnackbar(parameters?: UseSnackbarParameters): UseSnackbarReturnValue;
|
||||
export default useSnackbar;
|
||||
133
node_modules/@mui/material/Snackbar/useSnackbar.js
generated
vendored
Normal file
133
node_modules/@mui/material/Snackbar/useSnackbar.js
generated
vendored
Normal file
@@ -0,0 +1,133 @@
|
||||
'use client';
|
||||
|
||||
import * as React from 'react';
|
||||
import { unstable_useEventCallback as useEventCallback, unstable_useTimeout as useTimeout } from '@mui/utils';
|
||||
import extractEventHandlers from '@mui/utils/extractEventHandlers';
|
||||
/**
|
||||
* The basic building block for creating custom snackbar.
|
||||
*
|
||||
* Demos:
|
||||
*
|
||||
* - [Snackbar](https://mui.com/base-ui/react-snackbar/#hook)
|
||||
*
|
||||
* API:
|
||||
*
|
||||
* - [useSnackbar API](https://mui.com/base-ui/react-snackbar/hooks-api/#use-snackbar)
|
||||
*/
|
||||
function useSnackbar(parameters = {}) {
|
||||
const {
|
||||
autoHideDuration = null,
|
||||
disableWindowBlurListener = false,
|
||||
onClose,
|
||||
open,
|
||||
resumeHideDuration
|
||||
} = parameters;
|
||||
const timerAutoHide = useTimeout();
|
||||
React.useEffect(() => {
|
||||
if (!open) {
|
||||
return undefined;
|
||||
}
|
||||
|
||||
/**
|
||||
* @param {KeyboardEvent} nativeEvent
|
||||
*/
|
||||
function handleKeyDown(nativeEvent) {
|
||||
if (!nativeEvent.defaultPrevented) {
|
||||
if (nativeEvent.key === 'Escape') {
|
||||
// not calling `preventDefault` since we don't know if people may ignore this event e.g. a permanently open snackbar
|
||||
onClose?.(nativeEvent, 'escapeKeyDown');
|
||||
}
|
||||
}
|
||||
}
|
||||
document.addEventListener('keydown', handleKeyDown);
|
||||
return () => {
|
||||
document.removeEventListener('keydown', handleKeyDown);
|
||||
};
|
||||
}, [open, onClose]);
|
||||
const handleClose = useEventCallback((event, reason) => {
|
||||
onClose?.(event, reason);
|
||||
});
|
||||
const setAutoHideTimer = useEventCallback(autoHideDurationParam => {
|
||||
if (!onClose || autoHideDurationParam == null) {
|
||||
return;
|
||||
}
|
||||
timerAutoHide.start(autoHideDurationParam, () => {
|
||||
handleClose(null, 'timeout');
|
||||
});
|
||||
});
|
||||
React.useEffect(() => {
|
||||
if (open) {
|
||||
setAutoHideTimer(autoHideDuration);
|
||||
}
|
||||
return timerAutoHide.clear;
|
||||
}, [open, autoHideDuration, setAutoHideTimer, timerAutoHide]);
|
||||
const handleClickAway = event => {
|
||||
onClose?.(event, 'clickaway');
|
||||
};
|
||||
|
||||
// Pause the timer when the user is interacting with the Snackbar
|
||||
// or when the user hide the window.
|
||||
const handlePause = timerAutoHide.clear;
|
||||
|
||||
// Restart the timer when the user is no longer interacting with the Snackbar
|
||||
// or when the window is shown back.
|
||||
const handleResume = React.useCallback(() => {
|
||||
if (autoHideDuration != null) {
|
||||
setAutoHideTimer(resumeHideDuration != null ? resumeHideDuration : autoHideDuration * 0.5);
|
||||
}
|
||||
}, [autoHideDuration, resumeHideDuration, setAutoHideTimer]);
|
||||
const createHandleBlur = otherHandlers => event => {
|
||||
const onBlurCallback = otherHandlers.onBlur;
|
||||
onBlurCallback?.(event);
|
||||
handleResume();
|
||||
};
|
||||
const createHandleFocus = otherHandlers => event => {
|
||||
const onFocusCallback = otherHandlers.onFocus;
|
||||
onFocusCallback?.(event);
|
||||
handlePause();
|
||||
};
|
||||
const createMouseEnter = otherHandlers => event => {
|
||||
const onMouseEnterCallback = otherHandlers.onMouseEnter;
|
||||
onMouseEnterCallback?.(event);
|
||||
handlePause();
|
||||
};
|
||||
const createMouseLeave = otherHandlers => event => {
|
||||
const onMouseLeaveCallback = otherHandlers.onMouseLeave;
|
||||
onMouseLeaveCallback?.(event);
|
||||
handleResume();
|
||||
};
|
||||
React.useEffect(() => {
|
||||
// TODO: window global should be refactored here
|
||||
if (!disableWindowBlurListener && open) {
|
||||
window.addEventListener('focus', handleResume);
|
||||
window.addEventListener('blur', handlePause);
|
||||
return () => {
|
||||
window.removeEventListener('focus', handleResume);
|
||||
window.removeEventListener('blur', handlePause);
|
||||
};
|
||||
}
|
||||
return undefined;
|
||||
}, [disableWindowBlurListener, open, handleResume, handlePause]);
|
||||
const getRootProps = (externalProps = {}) => {
|
||||
const externalEventHandlers = {
|
||||
...extractEventHandlers(parameters),
|
||||
...extractEventHandlers(externalProps)
|
||||
};
|
||||
return {
|
||||
// ClickAwayListener adds an `onClick` prop which results in the alert not being announced.
|
||||
// See https://github.com/mui/material-ui/issues/29080
|
||||
role: 'presentation',
|
||||
...externalProps,
|
||||
...externalEventHandlers,
|
||||
onBlur: createHandleBlur(externalEventHandlers),
|
||||
onFocus: createHandleFocus(externalEventHandlers),
|
||||
onMouseEnter: createMouseEnter(externalEventHandlers),
|
||||
onMouseLeave: createMouseLeave(externalEventHandlers)
|
||||
};
|
||||
};
|
||||
return {
|
||||
getRootProps,
|
||||
onClickAway: handleClickAway
|
||||
};
|
||||
}
|
||||
export default useSnackbar;
|
||||
59
node_modules/@mui/material/Snackbar/useSnackbar.types.d.ts
generated
vendored
Normal file
59
node_modules/@mui/material/Snackbar/useSnackbar.types.d.ts
generated
vendored
Normal file
@@ -0,0 +1,59 @@
|
||||
export type SnackbarCloseReason = 'timeout' | 'clickaway' | 'escapeKeyDown';
|
||||
export interface UseSnackbarParameters {
|
||||
/**
|
||||
* The number of milliseconds to wait before automatically calling the
|
||||
* `onClose` function. `onClose` should then set the state of the `open`
|
||||
* prop to hide the Snackbar. This behavior is disabled by default with
|
||||
* the `null` value.
|
||||
* @default null
|
||||
*/
|
||||
autoHideDuration?: number | null;
|
||||
/**
|
||||
* If `true`, the `autoHideDuration` timer will expire even if the window is not focused.
|
||||
* @default false
|
||||
*/
|
||||
disableWindowBlurListener?: boolean;
|
||||
/**
|
||||
* Callback fired when the component requests to be closed.
|
||||
* Typically `onClose` is used to set state in the parent component,
|
||||
* which is used to control the `Snackbar` `open` prop.
|
||||
* The `reason` parameter can optionally be used to control the response to `onClose`,
|
||||
* for example ignoring `clickaway`.
|
||||
*
|
||||
* @param {React.SyntheticEvent<any> | Event} event The event source of the callback.
|
||||
* @param {string} reason Can be: `"timeout"` (`autoHideDuration` expired), `"clickaway"`, or `"escapeKeyDown"`.
|
||||
*/
|
||||
onClose?: (event: React.SyntheticEvent<any> | Event | null, reason: SnackbarCloseReason) => void;
|
||||
/**
|
||||
* If `true`, the component is shown.
|
||||
*/
|
||||
open?: boolean;
|
||||
/**
|
||||
* The number of milliseconds to wait before dismissing after user interaction.
|
||||
* If `autoHideDuration` prop isn't specified, it does nothing.
|
||||
* If `autoHideDuration` prop is specified but `resumeHideDuration` isn't,
|
||||
* we default to `autoHideDuration / 2` ms.
|
||||
*/
|
||||
resumeHideDuration?: number;
|
||||
}
|
||||
export type UseSnackbarRootSlotProps<ExternalProps = {}> = ExternalProps & UseSnackbarRootSlotOwnProps;
|
||||
export interface UseSnackbarRootSlotOwnProps {
|
||||
onBlur: React.FocusEventHandler;
|
||||
onFocus: React.FocusEventHandler;
|
||||
onMouseEnter: React.MouseEventHandler;
|
||||
onMouseLeave: React.MouseEventHandler;
|
||||
ref?: React.RefCallback<Element>;
|
||||
role: React.AriaRole;
|
||||
}
|
||||
export interface UseSnackbarReturnValue {
|
||||
/**
|
||||
* Resolver for the root slot's props.
|
||||
* @param externalProps props for the root slot
|
||||
* @returns props that should be spread on the root slot
|
||||
*/
|
||||
getRootProps: <ExternalProps extends Record<string, unknown> = {}>(externalProps?: ExternalProps) => UseSnackbarRootSlotProps<ExternalProps>;
|
||||
/**
|
||||
* Callback fired when a "click away" event is detected.
|
||||
*/
|
||||
onClickAway: (event: React.SyntheticEvent<any> | Event) => void;
|
||||
}
|
||||
1
node_modules/@mui/material/Snackbar/useSnackbar.types.js
generated
vendored
Normal file
1
node_modules/@mui/material/Snackbar/useSnackbar.types.js
generated
vendored
Normal file
@@ -0,0 +1 @@
|
||||
export {};
|
||||
Reference in New Issue
Block a user