@blueprintjs/core
Version:
Core styles & components
234 lines • 10.8 kB
JavaScript
/*
* Copyright 2015 Palantir Technologies, Inc. All rights reserved.
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
var Overlay_1;
import * as tslib_1 from "tslib";
import classNames from "classnames";
import * as React from "react";
import { polyfill } from "react-lifecycles-compat";
import { CSSTransition, TransitionGroup } from "react-transition-group";
import { findDOMNode } from "react-dom";
import { AbstractPureComponent2, Classes, Keys } from "../../common";
import { DISPLAYNAME_PREFIX } from "../../common/props";
import { safeInvoke } from "../../common/utils";
import { Portal } from "../portal/portal";
let Overlay = Overlay_1 = class Overlay extends AbstractPureComponent2 {
constructor(props, context) {
super(props, context);
this.refHandlers = {
container: (ref) => (this.containerElement = findDOMNode(ref)),
};
this.maybeRenderChild = (child) => {
if (child == null) {
return null;
}
// add a special class to each child element that will automatically set the appropriate
// CSS position mode under the hood. also, make the container focusable so we can
// trap focus inside it (via `enforceFocus`).
const decoratedChild = typeof child === "object" ? (React.cloneElement(child, {
className: classNames(child.props.className, Classes.OVERLAY_CONTENT),
tabIndex: 0,
})) : (React.createElement("span", { className: Classes.OVERLAY_CONTENT }, child));
const { onOpening, onOpened, onClosing, onClosed, transitionDuration, transitionName } = this.props;
return (React.createElement(CSSTransition, { classNames: transitionName, onEntering: onOpening, onEntered: onOpened, onExiting: onClosing, onExited: onClosed, timeout: transitionDuration }, decoratedChild));
};
this.handleBackdropMouseDown = (e) => {
const { backdropProps, canOutsideClickClose, enforceFocus, onClose } = this.props;
if (canOutsideClickClose) {
safeInvoke(onClose, e);
}
if (enforceFocus) {
// make sure document.activeElement is updated before bringing the focus back
this.bringFocusInsideOverlay();
}
safeInvoke(backdropProps.onMouseDown, e);
};
this.handleDocumentClick = (e) => {
const { canOutsideClickClose, isOpen, onClose } = this.props;
const eventTarget = e.target;
const stackIndex = Overlay_1.openStack.indexOf(this);
const isClickInThisOverlayOrDescendant = Overlay_1.openStack
.slice(stackIndex)
.some(({ containerElement: elem }) => {
// `elem` is the container of backdrop & content, so clicking on that container
// should not count as being "inside" the overlay.
return elem && elem.contains(eventTarget) && !elem.isSameNode(eventTarget);
});
if (isOpen && canOutsideClickClose && !isClickInThisOverlayOrDescendant) {
// casting to any because this is a native event
safeInvoke(onClose, e);
}
};
this.handleDocumentFocus = (e) => {
if (this.props.enforceFocus &&
this.containerElement != null &&
!this.containerElement.contains(e.target)) {
// prevent default focus behavior (sometimes auto-scrolls the page)
e.preventDefault();
e.stopImmediatePropagation();
this.bringFocusInsideOverlay();
}
};
this.handleKeyDown = (e) => {
const { canEscapeKeyClose, onClose } = this.props;
if (e.which === Keys.ESCAPE && canEscapeKeyClose) {
safeInvoke(onClose, e);
// prevent browser-specific escape key behavior (Safari exits fullscreen)
e.preventDefault();
}
};
this.state = { hasEverOpened: props.isOpen };
}
static getDerivedStateFromProps({ isOpen: hasEverOpened }) {
if (hasEverOpened) {
return { hasEverOpened };
}
return null;
}
render() {
// oh snap! no reason to render anything at all if we're being truly lazy
if (this.props.lazy && !this.state.hasEverOpened) {
return null;
}
const { children, className, usePortal, isOpen } = this.props;
// TransitionGroup types require single array of children; does not support nested arrays.
// So we must collapse backdrop and children into one array, and every item must be wrapped in a
// Transition element (no ReactText allowed).
const childrenWithTransitions = isOpen ? React.Children.map(children, this.maybeRenderChild) : [];
childrenWithTransitions.unshift(this.maybeRenderBackdrop());
const containerClasses = classNames(Classes.OVERLAY, {
[Classes.OVERLAY_OPEN]: isOpen,
[Classes.OVERLAY_INLINE]: !usePortal,
}, className);
const transitionGroup = (React.createElement(TransitionGroup, { appear: true, className: containerClasses, component: "div", onKeyDown: this.handleKeyDown, ref: this.refHandlers.container }, childrenWithTransitions));
if (usePortal) {
return (React.createElement(Portal, { className: this.props.portalClassName, container: this.props.portalContainer }, transitionGroup));
}
else {
return transitionGroup;
}
}
componentDidMount() {
if (this.props.isOpen) {
this.overlayWillOpen();
}
}
componentDidUpdate(prevProps) {
if (prevProps.isOpen && !this.props.isOpen) {
this.overlayWillClose();
}
else if (!prevProps.isOpen && this.props.isOpen) {
this.overlayWillOpen();
}
}
componentWillUnmount() {
this.overlayWillClose();
}
/**
* @public for testing
* @internal
*/
bringFocusInsideOverlay() {
// always delay focus manipulation to just before repaint to prevent scroll jumping
return requestAnimationFrame(() => {
// container ref may be undefined between component mounting and Portal rendering
// activeElement may be undefined in some rare cases in IE
if (this.containerElement == null || document.activeElement == null || !this.props.isOpen) {
return;
}
const isFocusOutsideModal = !this.containerElement.contains(document.activeElement);
if (isFocusOutsideModal) {
// element marked autofocus has higher priority than the other clowns
const autofocusElement = this.containerElement.querySelector("[autofocus]");
const wrapperElement = this.containerElement.querySelector("[tabindex]");
if (autofocusElement != null) {
autofocusElement.focus();
}
else if (wrapperElement != null) {
wrapperElement.focus();
}
}
});
}
maybeRenderBackdrop() {
const { backdropClassName, backdropProps, hasBackdrop, isOpen, transitionDuration, transitionName, } = this.props;
if (hasBackdrop && isOpen) {
return (React.createElement(CSSTransition, { classNames: transitionName, key: "__backdrop", timeout: transitionDuration },
React.createElement("div", Object.assign({}, backdropProps, { className: classNames(Classes.OVERLAY_BACKDROP, backdropClassName, backdropProps.className), onMouseDown: this.handleBackdropMouseDown, tabIndex: this.props.canOutsideClickClose ? 0 : null }))));
}
else {
return null;
}
}
overlayWillClose() {
document.removeEventListener("focus", this.handleDocumentFocus, /* useCapture */ true);
document.removeEventListener("mousedown", this.handleDocumentClick);
const { openStack } = Overlay_1;
const stackIndex = openStack.indexOf(this);
if (stackIndex !== -1) {
openStack.splice(stackIndex, 1);
if (openStack.length > 0) {
const lastOpenedOverlay = Overlay_1.getLastOpened();
if (lastOpenedOverlay.props.enforceFocus) {
document.addEventListener("focus", lastOpenedOverlay.handleDocumentFocus, /* useCapture */ true);
}
}
if (openStack.filter(o => o.props.usePortal && o.props.hasBackdrop).length === 0) {
document.body.classList.remove(Classes.OVERLAY_OPEN);
}
}
}
overlayWillOpen() {
const { openStack } = Overlay_1;
if (openStack.length > 0) {
document.removeEventListener("focus", Overlay_1.getLastOpened().handleDocumentFocus, /* useCapture */ true);
}
openStack.push(this);
if (this.props.autoFocus) {
this.bringFocusInsideOverlay();
}
if (this.props.enforceFocus) {
document.addEventListener("focus", this.handleDocumentFocus, /* useCapture */ true);
}
if (this.props.canOutsideClickClose && !this.props.hasBackdrop) {
document.addEventListener("mousedown", this.handleDocumentClick);
}
if (this.props.hasBackdrop && this.props.usePortal) {
// add a class to the body to prevent scrolling of content below the overlay
document.body.classList.add(Classes.OVERLAY_OPEN);
}
}
};
Overlay.displayName = `${DISPLAYNAME_PREFIX}.Overlay`;
Overlay.defaultProps = {
autoFocus: true,
backdropProps: {},
canEscapeKeyClose: true,
canOutsideClickClose: true,
enforceFocus: true,
hasBackdrop: true,
isOpen: false,
lazy: true,
transitionDuration: 300,
transitionName: Classes.OVERLAY,
usePortal: true,
};
Overlay.openStack = [];
Overlay.getLastOpened = () => Overlay_1.openStack[Overlay_1.openStack.length - 1];
Overlay = Overlay_1 = tslib_1.__decorate([
polyfill
], Overlay);
export { Overlay };
//# sourceMappingURL=overlay.js.map