92 lines
3.5 KiB
JavaScript
92 lines
3.5 KiB
JavaScript
|
'use client';
|
||
|
|
|
||
|
|
import * as React from 'react';
|
||
|
|
import * as ReactDOM from 'react-dom';
|
||
|
|
import PropTypes from 'prop-types';
|
||
|
|
import { exactProp, HTMLElementType, unstable_useEnhancedEffect as useEnhancedEffect, unstable_useForkRef as useForkRef, unstable_setRef as setRef } from '@mui/utils';
|
||
|
|
import { jsx as _jsx } from "react/jsx-runtime";
|
||
|
|
function getContainer(container) {
|
||
|
|
return typeof container === 'function' ? container() : container;
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Portals provide a first-class way to render children into a DOM node
|
||
|
|
* that exists outside the DOM hierarchy of the parent component.
|
||
|
|
*
|
||
|
|
* Demos:
|
||
|
|
*
|
||
|
|
* - [Portal](https://mui.com/base-ui/react-portal/)
|
||
|
|
*
|
||
|
|
* API:
|
||
|
|
*
|
||
|
|
* - [Portal API](https://mui.com/base-ui/react-portal/components-api/#portal)
|
||
|
|
*/
|
||
|
|
const Portal = /*#__PURE__*/React.forwardRef(function Portal(props, forwardedRef) {
|
||
|
|
const {
|
||
|
|
children,
|
||
|
|
container,
|
||
|
|
disablePortal = false
|
||
|
|
} = props;
|
||
|
|
const [mountNode, setMountNode] = React.useState(null);
|
||
|
|
// @ts-expect-error TODO upstream fix
|
||
|
|
const handleRef = useForkRef( /*#__PURE__*/React.isValidElement(children) ? children.ref : null, forwardedRef);
|
||
|
|
useEnhancedEffect(() => {
|
||
|
|
if (!disablePortal) {
|
||
|
|
setMountNode(getContainer(container) || document.body);
|
||
|
|
}
|
||
|
|
}, [container, disablePortal]);
|
||
|
|
useEnhancedEffect(() => {
|
||
|
|
if (mountNode && !disablePortal) {
|
||
|
|
setRef(forwardedRef, mountNode);
|
||
|
|
return () => {
|
||
|
|
setRef(forwardedRef, null);
|
||
|
|
};
|
||
|
|
}
|
||
|
|
return undefined;
|
||
|
|
}, [forwardedRef, mountNode, disablePortal]);
|
||
|
|
if (disablePortal) {
|
||
|
|
if ( /*#__PURE__*/React.isValidElement(children)) {
|
||
|
|
const newProps = {
|
||
|
|
ref: handleRef
|
||
|
|
};
|
||
|
|
return /*#__PURE__*/React.cloneElement(children, newProps);
|
||
|
|
}
|
||
|
|
return /*#__PURE__*/_jsx(React.Fragment, {
|
||
|
|
children: children
|
||
|
|
});
|
||
|
|
}
|
||
|
|
return /*#__PURE__*/_jsx(React.Fragment, {
|
||
|
|
children: mountNode ? /*#__PURE__*/ReactDOM.createPortal(children, mountNode) : mountNode
|
||
|
|
});
|
||
|
|
});
|
||
|
|
process.env.NODE_ENV !== "production" ? Portal.propTypes /* remove-proptypes */ = {
|
||
|
|
// ┌────────────────────────────── Warning ──────────────────────────────┐
|
||
|
|
// │ These PropTypes are generated from the TypeScript type definitions. │
|
||
|
|
// │ To update them, edit the TypeScript types and run `pnpm proptypes`. │
|
||
|
|
// └─────────────────────────────────────────────────────────────────────┘
|
||
|
|
/**
|
||
|
|
* The children to render into the `container`.
|
||
|
|
*/
|
||
|
|
children: PropTypes.node,
|
||
|
|
/**
|
||
|
|
* An HTML element or function that returns one.
|
||
|
|
* The `container` will have the portal children appended to it.
|
||
|
|
*
|
||
|
|
* You can also provide a callback, which is called in a React layout effect.
|
||
|
|
* This lets you set the container from a ref, and also makes server-side rendering possible.
|
||
|
|
*
|
||
|
|
* By default, it uses the body of the top-level document object,
|
||
|
|
* so it's simply `document.body` most of the time.
|
||
|
|
*/
|
||
|
|
container: PropTypes /* @typescript-to-proptypes-ignore */.oneOfType([HTMLElementType, PropTypes.func]),
|
||
|
|
/**
|
||
|
|
* The `children` will be under the DOM hierarchy of the parent component.
|
||
|
|
* @default false
|
||
|
|
*/
|
||
|
|
disablePortal: PropTypes.bool
|
||
|
|
} : void 0;
|
||
|
|
if (process.env.NODE_ENV !== 'production') {
|
||
|
|
// eslint-disable-next-line
|
||
|
|
Portal['propTypes' + ''] = exactProp(Portal.propTypes);
|
||
|
|
}
|
||
|
|
export { Portal };
|