/* @flow */ import InlineDialog from '@atlaskit/inline-dialog'; import React, { Component } from 'react'; import { Drawer, DrawerPortal } from '../../../toolbox/components/web'; /** * A map of dialog positions, relative to trigger, to css classes used to * manipulate elements for handling mouse events. * * @private * @type {object} */ const DIALOG_TO_PADDING_POSITION = { 'left': 'popover-mousemove-padding-right', 'right': 'popover-mousemove-padding-left', 'top': 'popover-mousemove-padding-bottom' }; /** * Takes the position expected by {@code InlineDialog} and maps it to a CSS * class that can be used styling the elements used for preventing mouseleave * events when moving from the trigger to the dialog. * * @param {string} position - From which position the dialog will display. * @private * @returns {string} */ function _mapPositionToPaddingClass(position = 'left') { return DIALOG_TO_PADDING_POSITION[position.split('-')[0]]; } /** * The type of the React {@code Component} props of {@link Popover}. */ type Props = { /** * A child React Element to use as the trigger for showing the dialog. */ children: React$Node, /** * Additional CSS classnames to apply to the root of the {@code Popover} * component. */ className: string, /** * The ReactElement to display within the dialog. */ content: Object, /** * Whether displaying of the popover should be prevented. */ disablePopover: boolean, /** * An id attribute to apply to the root of the {@code Popover} * component. */ id: string, /** * Callback to invoke when the popover has opened. */ onPopoverOpen: Function, /** * Whether to display the Popover as a drawer. */ overflowDrawer: boolean, /** * From which side of the dialog trigger the dialog should display. The * value will be passed to {@code InlineDialog}. */ position: string }; /** * The type of the React {@code Component} state of {@link Popover}. */ type State = { /** * Whether or not the {@code InlineDialog} should be displayed. */ showDialog: boolean }; /** * Implements a React {@code Component} for showing an {@code InlineDialog} on * mouseenter of the trigger and contents, and hiding the dialog on mouseleave. * * @extends Component */ class Popover extends Component { /** * Default values for {@code Popover} component's properties. * * @static */ static defaultProps = { className: '', id: '' }; /** * Reference to the Popover that is meant to open as a drawer. */ _drawerContainerRef: Object; /** * Initializes a new {@code Popover} instance. * * @param {Object} props - The read-only properties with which the new * instance is to be initialized. */ constructor(props: Props) { super(props); this.state = { showDialog: false }; // Bind event handlers so they are only bound once for every instance. this._onHideDialog = this._onHideDialog.bind(this); this._onShowDialog = this._onShowDialog.bind(this); this._drawerContainerRef = React.createRef(); } /** * Sets up an event listener to open a drawer when clicking, rather than entering the * overflow area. * * TODO: This should be done by setting an {@code onClick} handler on the div, but for some * reason that doesn't seem to work whatsoever. * * @inheritdoc * @returns {void} */ componentDidMount() { if (this._drawerContainerRef && this._drawerContainerRef.current) { this._drawerContainerRef.current.addEventListener('click', this._onShowDialog); } } /** * Removes the listener set up in the {@code componentDidMount} method. * * @inheritdoc * @returns {void} */ componentWillUnmount() { if (this._drawerContainerRef && this._drawerContainerRef.current) { this._drawerContainerRef.current.removeEventListener('click', this._onShowDialog); } } /** * Implements React Component's componentDidUpdate. * * @inheritdoc */ componentDidUpdate(prevProps: Props) { if (prevProps.overflowDrawer !== this.props.overflowDrawer) { // Make sure the listeners are set up when resizing the screen past the drawer threshold. if (this.props.overflowDrawer) { this.componentDidMount(); } else { this.componentWillUnmount(); } } } /** * Implements React's {@link Component#render()}. * * @inheritdoc * @returns {ReactElement} */ render() { const { children, className, content, id, overflowDrawer, position } = this.props; if (overflowDrawer) { return (
{ children } { content }
); } return (
{ children }
); } _onHideDialog: () => void; /** * Stops displaying the {@code InlineDialog}. * * @private * @returns {void} */ _onHideDialog() { this.setState({ showDialog: false }); } _onShowDialog: () => void; /** * Displays the {@code InlineDialog} and calls any registered onPopoverOpen * callbacks. * * @param {MouseEvent} event - The mouse event to intercept. * @private * @returns {void} */ _onShowDialog(event) { event.stopPropagation(); if (!this.props.disablePopover) { this.setState({ showDialog: true }); if (this.props.onPopoverOpen) { this.props.onPopoverOpen(); } } } /** * Renders the React Element to be displayed in the {@code InlineDialog}. * Also adds padding to support moving the mouse from the trigger to the * dialog to prevent mouseleave events. * * @private * @returns {ReactElement} */ _renderContent() { const { content, position } = this.props; return (
{ content }
); } } export default Popover;