@material-ui/core
Version:
React components that implement Google's Material Design.
420 lines (336 loc) • 13.7 kB
JavaScript
"use strict";
var _interopRequireWildcard = require("@babel/runtime/helpers/interopRequireWildcard");
var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
Object.defineProperty(exports, "__esModule", {
value: true
});
exports.default = exports.styles = void 0;
var _extends2 = _interopRequireDefault(require("@babel/runtime/helpers/extends"));
var _slicedToArray2 = _interopRequireDefault(require("@babel/runtime/helpers/slicedToArray"));
var _objectWithoutProperties2 = _interopRequireDefault(require("@babel/runtime/helpers/objectWithoutProperties"));
var _react = _interopRequireDefault(require("react"));
var _reactDom = _interopRequireDefault(require("react-dom"));
var _propTypes = _interopRequireDefault(require("prop-types"));
var _styles = require("@material-ui/styles");
var _utils = require("@material-ui/utils");
var _ownerDocument = _interopRequireDefault(require("../utils/ownerDocument"));
var _Portal = _interopRequireDefault(require("../Portal"));
var _helpers = require("../utils/helpers");
var _reactHelpers = require("../utils/reactHelpers");
var _useEventCallback = _interopRequireDefault(require("../utils/useEventCallback"));
var _zIndex = _interopRequireDefault(require("../styles/zIndex"));
var _ModalManager = _interopRequireWildcard(require("./ModalManager"));
var _TrapFocus = _interopRequireDefault(require("./TrapFocus"));
var _SimpleBackdrop = _interopRequireDefault(require("./SimpleBackdrop"));
function getContainer(container) {
container = typeof container === 'function' ? container() : container;
return _reactDom.default.findDOMNode(container);
}
function getHasTransition(props) {
return props.children ? props.children.props.hasOwnProperty('in') : false;
} // Modals don't open on the server so this won't conflict with concurrent requests.
var defaultManager = new _ModalManager.default();
function getModal(modal, mountNodeRef, modalRef) {
modal.current.modalRef = modalRef.current;
modal.current.mountNode = mountNodeRef.current;
return modal.current;
}
var styles = function styles(theme) {
return {
/* Styles applied to the root element. */
root: {
position: 'fixed',
zIndex: theme.zIndex.modal,
right: 0,
bottom: 0,
top: 0,
left: 0
},
/* Styles applied to the root element if the `Modal` has exited. */
hidden: {
visibility: 'hidden'
}
};
};
/**
* Modal is a lower-level construct that is leveraged by the following components:
*
* - [Dialog](/api/dialog/)
* - [Drawer](/api/drawer/)
* - [Menu](/api/menu/)
* - [Popover](/api/popover/)
*
* If you are creating a modal dialog, you probably want to use the [Dialog](/api/dialog/) component
* rather than directly using Modal.
*
* This component shares many concepts with [react-overlays](https://react-bootstrap.github.io/react-overlays/#modals).
*/
exports.styles = styles;
var Modal = _react.default.forwardRef(function Modal(props, ref) {
var _props$BackdropCompon = props.BackdropComponent,
BackdropComponent = _props$BackdropCompon === void 0 ? _SimpleBackdrop.default : _props$BackdropCompon,
BackdropProps = props.BackdropProps,
children = props.children,
_props$closeAfterTran = props.closeAfterTransition,
closeAfterTransition = _props$closeAfterTran === void 0 ? false : _props$closeAfterTran,
container = props.container,
_props$disableAutoFoc = props.disableAutoFocus,
disableAutoFocus = _props$disableAutoFoc === void 0 ? false : _props$disableAutoFoc,
_props$disableBackdro = props.disableBackdropClick,
disableBackdropClick = _props$disableBackdro === void 0 ? false : _props$disableBackdro,
_props$disableEnforce = props.disableEnforceFocus,
disableEnforceFocus = _props$disableEnforce === void 0 ? false : _props$disableEnforce,
_props$disableEscapeK = props.disableEscapeKeyDown,
disableEscapeKeyDown = _props$disableEscapeK === void 0 ? false : _props$disableEscapeK,
_props$disablePortal = props.disablePortal,
disablePortal = _props$disablePortal === void 0 ? false : _props$disablePortal,
_props$disableRestore = props.disableRestoreFocus,
disableRestoreFocus = _props$disableRestore === void 0 ? false : _props$disableRestore,
_props$hideBackdrop = props.hideBackdrop,
hideBackdrop = _props$hideBackdrop === void 0 ? false : _props$hideBackdrop,
_props$keepMounted = props.keepMounted,
keepMounted = _props$keepMounted === void 0 ? false : _props$keepMounted,
_props$manager = props.manager,
manager = _props$manager === void 0 ? defaultManager : _props$manager,
onBackdropClick = props.onBackdropClick,
onClose = props.onClose,
onEscapeKeyDown = props.onEscapeKeyDown,
onRendered = props.onRendered,
open = props.open,
other = (0, _objectWithoutProperties2.default)(props, ["BackdropComponent", "BackdropProps", "children", "closeAfterTransition", "container", "disableAutoFocus", "disableBackdropClick", "disableEnforceFocus", "disableEscapeKeyDown", "disablePortal", "disableRestoreFocus", "hideBackdrop", "keepMounted", "manager", "onBackdropClick", "onClose", "onEscapeKeyDown", "onRendered", "open"]);
var theme = (0, _styles.useTheme)();
var _React$useState = _react.default.useState(true),
_React$useState2 = (0, _slicedToArray2.default)(_React$useState, 2),
exited = _React$useState2[0],
setExited = _React$useState2[1];
var modal = _react.default.useRef({});
var mountNodeRef = _react.default.useRef(null);
var modalRef = _react.default.useRef(null);
var handleRef = (0, _reactHelpers.useForkRef)(modalRef, ref);
var hasTransition = getHasTransition(props);
var getDoc = function getDoc() {
return (0, _ownerDocument.default)(mountNodeRef.current);
};
var handleMounted = function handleMounted() {
manager.mount(getModal(modal, mountNodeRef, modalRef)); // Fix a bug on Chrome where the scroll isn't initially 0.
modalRef.current.scrollTop = 0;
};
var handleOpen = (0, _useEventCallback.default)(function () {
var resolvedContainer = getContainer(container) || getDoc().body;
manager.add(getModal(modal, mountNodeRef, modalRef), resolvedContainer); // The element was already mounted.
if (modalRef.current) {
handleMounted();
}
});
var handlePortalRef = (0, _useEventCallback.default)(function (node) {
mountNodeRef.current = node;
if (!node) {
return;
}
if (onRendered) {
onRendered();
}
if (open) {
handleMounted();
} else {
(0, _ModalManager.ariaHidden)(modalRef.current, true);
}
});
var handleClose = _react.default.useCallback(function () {
manager.remove(getModal(modal, mountNodeRef, modalRef));
}, [manager]);
_react.default.useEffect(function () {
return function () {
handleClose();
};
}, [handleClose]);
_react.default.useEffect(function () {
if (open) {
handleOpen();
} else if (!hasTransition || !closeAfterTransition) {
handleClose();
}
}, [open, handleClose, hasTransition, closeAfterTransition, handleOpen]);
var isTopModal = _react.default.useCallback(function () {
return manager.isTopModal(getModal(modal, mountNodeRef, modalRef));
}, [manager]);
if (!keepMounted && !open && (!hasTransition || exited)) {
return null;
}
var handleEnter = function handleEnter() {
setExited(false);
};
var handleExited = function handleExited() {
setExited(true);
if (closeAfterTransition) {
handleClose();
}
};
var handleBackdropClick = function handleBackdropClick(event) {
if (event.target !== event.currentTarget) {
return;
}
if (onBackdropClick) {
onBackdropClick(event);
}
if (!disableBackdropClick && onClose) {
onClose(event, 'backdropClick');
}
};
var handleKeyDown = function handleKeyDown(event) {
// We don't take event.defaultPrevented into account:
//
// event.preventDefault() is meant to stop default behaviours like
// clicking a checkbox to check it, hitting a button to submit a form,
// and hitting left arrow to move the cursor in a text input etc.
// Only special HTML elements have these default behaviors.
if (event.key !== 'Escape' || !isTopModal()) {
return;
} // Swallow the event, in case someone is listening for the escape key on the body.
event.stopPropagation();
if (onEscapeKeyDown) {
onEscapeKeyDown(event);
}
if (!disableEscapeKeyDown && onClose) {
onClose(event, 'escapeKeyDown');
}
};
var inlineStyle = styles(theme || {
zIndex: _zIndex.default
});
var childProps = {};
if (children.role === undefined) {
childProps.role = children.role || 'document';
}
if (children.tabIndex === undefined) {
childProps.tabIndex = children.tabIndex || '-1';
} // It's a Transition like component
if (hasTransition) {
childProps.onEnter = (0, _helpers.createChainedFunction)(handleEnter, children.props.onEnter);
childProps.onExited = (0, _helpers.createChainedFunction)(handleExited, children.props.onExited);
}
return _react.default.createElement(_Portal.default, {
ref: handlePortalRef,
container: container,
disablePortal: disablePortal
}, _react.default.createElement("div", (0, _extends2.default)({
ref: handleRef,
onKeyDown: handleKeyDown,
role: "presentation"
}, other, {
style: (0, _extends2.default)({}, inlineStyle.root, {}, !open && exited ? inlineStyle.hidden : {}, {}, other.style)
}), hideBackdrop ? null : _react.default.createElement(BackdropComponent, (0, _extends2.default)({
open: open,
onClick: handleBackdropClick
}, BackdropProps)), _react.default.createElement(_TrapFocus.default, {
disableEnforceFocus: disableEnforceFocus,
disableAutoFocus: disableAutoFocus,
disableRestoreFocus: disableRestoreFocus,
getDoc: getDoc,
isEnabled: isTopModal,
open: open
}, _react.default.cloneElement(children, childProps))));
});
process.env.NODE_ENV !== "production" ? Modal.propTypes = {
/**
* A backdrop component. This prop enables custom backdrop rendering.
*/
BackdropComponent: _propTypes.default.elementType,
/**
* Props applied to the [`Backdrop`](/api/backdrop/) element.
*/
BackdropProps: _propTypes.default.object,
/**
* A single child content element.
*/
children: _utils.elementAcceptingRef.isRequired,
/**
* When set to true the Modal waits until a nested Transition is completed before closing.
*/
closeAfterTransition: _propTypes.default.bool,
/**
* A node, component instance, or function that returns either.
* The `container` will have the portal children appended to it.
*/
container: _propTypes.default.oneOfType([_propTypes.default.object, _propTypes.default.func]),
/**
* If `true`, the modal will not automatically shift focus to itself when it opens, and
* replace it to the last focused element when it closes.
* This also works correctly with any modal children that have the `disableAutoFocus` prop.
*
* Generally this should never be set to `true` as it makes the modal less
* accessible to assistive technologies, like screen readers.
*/
disableAutoFocus: _propTypes.default.bool,
/**
* If `true`, clicking the backdrop will not fire any callback.
*/
disableBackdropClick: _propTypes.default.bool,
/**
* If `true`, the modal will not prevent focus from leaving the modal while open.
*
* Generally this should never be set to `true` as it makes the modal less
* accessible to assistive technologies, like screen readers.
*/
disableEnforceFocus: _propTypes.default.bool,
/**
* If `true`, hitting escape will not fire any callback.
*/
disableEscapeKeyDown: _propTypes.default.bool,
/**
* Disable the portal behavior.
* The children stay within it's parent DOM hierarchy.
*/
disablePortal: _propTypes.default.bool,
/**
* If `true`, the modal will not restore focus to previously focused element once
* modal is hidden.
*/
disableRestoreFocus: _propTypes.default.bool,
/**
* If `true`, the backdrop is not rendered.
*/
hideBackdrop: _propTypes.default.bool,
/**
* Always keep the children in the DOM.
* This prop can be useful in SEO situation or
* when you want to maximize the responsiveness of the Modal.
*/
keepMounted: _propTypes.default.bool,
/**
* @ignore
*
* A modal manager used to track and manage the state of open Modals.
*/
manager: _propTypes.default.object,
/**
* Callback fired when the backdrop is clicked.
*/
onBackdropClick: _propTypes.default.func,
/**
* Callback fired when the component requests to be closed.
* The `reason` parameter can optionally be used to control the response to `onClose`.
*
* @param {object} event The event source of the callback
* @param {string} reason Can be:`"escapeKeyDown"`, `"backdropClick"`
*/
onClose: _propTypes.default.func,
/**
* Callback fired when the escape key is pressed,
* `disableEscapeKeyDown` is false and the modal is in focus.
*/
onEscapeKeyDown: _propTypes.default.func,
/**
* Callback fired once the children has been mounted into the `container`.
* It signals that the `open={true}` prop took effect.
*
* This prop will be deprecated and removed in v5, the ref can be used instead.
*/
onRendered: _propTypes.default.func,
/**
* If `true`, the modal is open.
*/
open: _propTypes.default.bool.isRequired
} : void 0;
var _default = Modal;
exports.default = _default;