UNPKG

@elastic/eui

Version:

Elastic UI Component Library

679 lines (669 loc) 34.2 kB
"use strict"; var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault"); var _typeof = require("@babel/runtime/helpers/typeof"); Object.defineProperty(exports, "__esModule", { value: true }); exports.EuiPopover = void 0; exports.getPopoverAlignFromAnchorPosition = getPopoverAlignFromAnchorPosition; exports.getPopoverPositionFromAnchorPosition = getPopoverPositionFromAnchorPosition; exports.popoverAnchorPosition = void 0; var _react = require("@emotion/react"); var _extends2 = _interopRequireDefault(require("@babel/runtime/helpers/extends")); var _objectWithoutProperties2 = _interopRequireDefault(require("@babel/runtime/helpers/objectWithoutProperties")); var _toConsumableArray2 = _interopRequireDefault(require("@babel/runtime/helpers/toConsumableArray")); var _classCallCheck2 = _interopRequireDefault(require("@babel/runtime/helpers/classCallCheck")); var _createClass2 = _interopRequireDefault(require("@babel/runtime/helpers/createClass")); var _assertThisInitialized2 = _interopRequireDefault(require("@babel/runtime/helpers/assertThisInitialized")); var _inherits2 = _interopRequireDefault(require("@babel/runtime/helpers/inherits")); var _possibleConstructorReturn2 = _interopRequireDefault(require("@babel/runtime/helpers/possibleConstructorReturn")); var _getPrototypeOf2 = _interopRequireDefault(require("@babel/runtime/helpers/getPrototypeOf")); var _defineProperty2 = _interopRequireDefault(require("@babel/runtime/helpers/defineProperty")); var _slicedToArray2 = _interopRequireDefault(require("@babel/runtime/helpers/slicedToArray")); var _propTypes = _interopRequireDefault(require("prop-types")); var _react2 = _interopRequireWildcard(require("react")); var _classnames = _interopRequireDefault(require("classnames")); var _tabbable = require("tabbable"); var _focus_trap = require("../focus_trap"); var _services = require("../../services"); var _accessibility = require("../accessibility"); var _portal = require("../portal"); var _mutation_observer = require("../observer/mutation_observer"); var _popover = require("../../services/popover"); var _i18n = require("../i18n"); var _outside_click_detector = require("../outside_click_detector"); var _popover_arrow = require("./popover_arrow"); var _popover2 = require("./popover.styles"); var _popover_panel = require("./popover_panel"); var _excluded = ["anchorClassName", "anchorPosition", "button", "buttonRef", "insert", "isOpen", "ownFocus", "children", "className", "closePopover", "panelClassName", "panelPaddingSize", "panelProps", "panelRef", "panelStyle", "popoverScreenReaderText", "popoverRef", "hasArrow", "arrowChildren", "repositionOnScroll", "hasDragDrop", "zIndex", "attachToAnchor", "display", "offset", "onPositionChange", "buffer", "aria-label", "aria-labelledby", "container", "focusTrapProps", "initialFocus", "tabIndex"]; function _getRequireWildcardCache(nodeInterop) { if (typeof WeakMap !== "function") return null; var cacheBabelInterop = new WeakMap(); var cacheNodeInterop = new WeakMap(); return (_getRequireWildcardCache = function _getRequireWildcardCache(nodeInterop) { return nodeInterop ? cacheNodeInterop : cacheBabelInterop; })(nodeInterop); } function _interopRequireWildcard(obj, nodeInterop) { if (!nodeInterop && obj && obj.__esModule) { return obj; } if (obj === null || _typeof(obj) !== "object" && typeof obj !== "function") { return { default: obj }; } var cache = _getRequireWildcardCache(nodeInterop); if (cache && cache.has(obj)) { return cache.get(obj); } var newObj = {}; var hasPropertyDescriptor = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var key in obj) { if (key !== "default" && Object.prototype.hasOwnProperty.call(obj, key)) { var desc = hasPropertyDescriptor ? Object.getOwnPropertyDescriptor(obj, key) : null; if (desc && (desc.get || desc.set)) { Object.defineProperty(newObj, key, desc); } else { newObj[key] = obj[key]; } } } newObj.default = obj; if (cache) { cache.set(obj, newObj); } return newObj; } function ownKeys(object, enumerableOnly) { var keys = Object.keys(object); if (Object.getOwnPropertySymbols) { var symbols = Object.getOwnPropertySymbols(object); enumerableOnly && (symbols = symbols.filter(function (sym) { return Object.getOwnPropertyDescriptor(object, sym).enumerable; })), keys.push.apply(keys, symbols); } return keys; } function _objectSpread(target) { for (var i = 1; i < arguments.length; i++) { var source = null != arguments[i] ? arguments[i] : {}; i % 2 ? ownKeys(Object(source), !0).forEach(function (key) { (0, _defineProperty2.default)(target, key, source[key]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(target, Object.getOwnPropertyDescriptors(source)) : ownKeys(Object(source)).forEach(function (key) { Object.defineProperty(target, key, Object.getOwnPropertyDescriptor(source, key)); }); } return target; } function _createSuper(Derived) { var hasNativeReflectConstruct = _isNativeReflectConstruct(); return function _createSuperInternal() { var Super = (0, _getPrototypeOf2.default)(Derived), result; if (hasNativeReflectConstruct) { var NewTarget = (0, _getPrototypeOf2.default)(this).constructor; result = Reflect.construct(Super, arguments, NewTarget); } else { result = Super.apply(this, arguments); } return (0, _possibleConstructorReturn2.default)(this, result); }; } function _isNativeReflectConstruct() { if (typeof Reflect === "undefined" || !Reflect.construct) return false; if (Reflect.construct.sham) return false; if (typeof Proxy === "function") return true; try { Boolean.prototype.valueOf.call(Reflect.construct(Boolean, [], function () {})); return true; } catch (e) { return false; } } /* * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one * or more contributor license agreements. Licensed under the Elastic License * 2.0 and the Server Side Public License, v 1; you may not use this file except * in compliance with, at your election, the Elastic License 2.0 or the Server * Side Public License, v 1. */ var popoverAnchorPosition = ['upCenter', 'upLeft', 'upRight', 'downCenter', 'downLeft', 'downRight', 'leftCenter', 'leftUp', 'leftDown', 'rightCenter', 'rightUp', 'rightDown']; exports.popoverAnchorPosition = popoverAnchorPosition; var anchorPositionToPopoverPositionMap = { up: 'top', right: 'right', down: 'bottom', left: 'left' }; function getPopoverPositionFromAnchorPosition(anchorPosition) { // maps the anchor position to the matching popover position // e.g. "upLeft" -> "top", "downRight" -> "bottom" // extract the first positional word from anchorPosition: // starts at the beginning (" ^ ") of anchorPosition and // captures all of the characters (" (.*?) ") until the // first capital letter (" [A-Z] ") is encountered var _ref = anchorPosition.match(/^(.*?)[A-Z]/), _ref2 = (0, _slicedToArray2.default)(_ref, 2), primaryPosition = _ref2[1]; return anchorPositionToPopoverPositionMap[primaryPosition]; } function getPopoverAlignFromAnchorPosition(anchorPosition) { // maps the gravity to the matching popover position // e.g. "upLeft" -> "left", "rightDown" -> "bottom" // extract the second positional word from anchorPosition: // starts a capture group at the first capital letter // and includes everything after it var _ref3 = anchorPosition.match(/([A-Z].*)/), _ref4 = (0, _slicedToArray2.default)(_ref3, 2), align = _ref4[1]; // this performs two tasks: // 1. normalizes the align position by lowercasing it // 2. `center` doesn't exist in the lookup map which converts it to `undefined` meaning no align return anchorPositionToPopoverPositionMap[align.toLowerCase()]; } var DEFAULT_POPOVER_STYLES = { top: 50, left: 50 }; var returnFocusConfig = { preventScroll: true }; var closingTransitionTime = 250; // TODO: DRY out var when converting to CSS-in-JS var EuiPopover = /*#__PURE__*/function (_Component) { (0, _inherits2.default)(EuiPopover, _Component); var _super = _createSuper(EuiPopover); function EuiPopover(props) { var _this; (0, _classCallCheck2.default)(this, EuiPopover); _this = _super.call(this, props); (0, _defineProperty2.default)((0, _assertThisInitialized2.default)(_this), "respositionTimeout", void 0); (0, _defineProperty2.default)((0, _assertThisInitialized2.default)(_this), "strandedFocusTimeout", void 0); (0, _defineProperty2.default)((0, _assertThisInitialized2.default)(_this), "closingTransitionTimeout", void 0); (0, _defineProperty2.default)((0, _assertThisInitialized2.default)(_this), "closingTransitionAnimationFrame", void 0); (0, _defineProperty2.default)((0, _assertThisInitialized2.default)(_this), "button", null); (0, _defineProperty2.default)((0, _assertThisInitialized2.default)(_this), "panel", null); (0, _defineProperty2.default)((0, _assertThisInitialized2.default)(_this), "descriptionId", (0, _services.htmlIdGenerator)()()); (0, _defineProperty2.default)((0, _assertThisInitialized2.default)(_this), "closePopover", function () { if (_this.props.isOpen) { _this.props.closePopover(); } }); (0, _defineProperty2.default)((0, _assertThisInitialized2.default)(_this), "onEscapeKey", function (event) { if (_this.props.isOpen) { event.preventDefault(); event.stopPropagation(); _this.closePopover(); _this.handleStrandedFocus(); } }); (0, _defineProperty2.default)((0, _assertThisInitialized2.default)(_this), "handleStrandedFocus", function () { _this.strandedFocusTimeout = window.setTimeout(function () { // If `returnFocus` failed and focus was stranded on the body, // attempt to manually restore focus to the toggle button if (document.activeElement === document.body) { if (!_this.button) return; var focusableItems = (0, _tabbable.focusable)(_this.button); if (!focusableItems.length) return; var toggleButton = focusableItems[0]; toggleButton.focus(returnFocusConfig); } }, closingTransitionTime); }); (0, _defineProperty2.default)((0, _assertThisInitialized2.default)(_this), "onKeyDown", function (event) { if (event.key === _services.cascadingMenuKeys.ESCAPE) { _this.onEscapeKey(event); } }); (0, _defineProperty2.default)((0, _assertThisInitialized2.default)(_this), "onClickOutside", function (event) { // only close the popover if the event source isn't the anchor button // otherwise, it is up to the anchor to toggle the popover's open status if (_this.button && _this.button.contains(event.target) === false) { _this.closePopover(); } }); (0, _defineProperty2.default)((0, _assertThisInitialized2.default)(_this), "onOpenPopover", function () { clearTimeout(_this.strandedFocusTimeout); clearTimeout(_this.closingTransitionTimeout); if (_this.closingTransitionAnimationFrame) { cancelAnimationFrame(_this.closingTransitionAnimationFrame); } // We need to set this state a beat after the render takes place, so that the CSS // transition can take effect. _this.closingTransitionAnimationFrame = window.requestAnimationFrame(function () { _this.setState({ isOpening: true }); }); // for each child element of `this.panel`, find any transition duration we should wait for before stabilizing var _Array$prototype$slic = Array.prototype.slice.call(_this.panel ? [_this.panel].concat((0, _toConsumableArray2.default)(Array.from(_this.panel.children))) : []).reduce(function (_ref5, element) { var durationMatch = _ref5.durationMatch, delayMatch = _ref5.delayMatch; var transitionTimings = (0, _services.getTransitionTimings)(element); return { durationMatch: Math.max(durationMatch, transitionTimings.durationMatch), delayMatch: Math.max(delayMatch, transitionTimings.delayMatch) }; }, { durationMatch: 0, delayMatch: 0 }), durationMatch = _Array$prototype$slic.durationMatch, delayMatch = _Array$prototype$slic.delayMatch; clearTimeout(_this.respositionTimeout); _this.respositionTimeout = window.setTimeout(function () { _this.setState({ isOpenStable: true }, function () { _this.positionPopoverFixed(); }); }, durationMatch + delayMatch); }); (0, _defineProperty2.default)((0, _assertThisInitialized2.default)(_this), "onMutation", function (records) { var waitDuration = (0, _services.getWaitDuration)(records); _this.positionPopoverFixed(); (0, _services.performOnFrame)(waitDuration, _this.positionPopoverFixed); }); (0, _defineProperty2.default)((0, _assertThisInitialized2.default)(_this), "positionPopover", function (allowEnforcePosition) { if (_this.button == null || _this.panel == null) return; var _ref6 = _this.props, anchorPosition = _ref6.anchorPosition; var position = getPopoverPositionFromAnchorPosition(anchorPosition); var forcePosition = undefined; if (allowEnforcePosition && _this.state.isOpenStable && _this.state.openPosition != null) { position = _this.state.openPosition; forcePosition = true; } var _findPopoverPosition = (0, _popover.findPopoverPosition)({ container: _this.props.container, position: position, forcePosition: forcePosition, align: getPopoverAlignFromAnchorPosition(anchorPosition), anchor: _this.button, popover: _this.panel, offset: !_this.props.attachToAnchor && _this.props.hasArrow ? 16 + (_this.props.offset || 0) : 8 + (_this.props.offset || 0), arrowConfig: { arrowWidth: 24, arrowBuffer: 10 }, returnBoundingBox: _this.props.attachToAnchor, buffer: _this.props.buffer }), top = _findPopoverPosition.top, left = _findPopoverPosition.left, foundPosition = _findPopoverPosition.position, arrow = _findPopoverPosition.arrow, anchorBoundingBox = _findPopoverPosition.anchorBoundingBox; // the popover's z-index must inherit from the button // this keeps a button's popover under a flyout that would cover the button // but a popover triggered inside a flyout will appear over that flyout var zIndexProp = _this.props.zIndex; var zIndex = zIndexProp == null ? (0, _popover.getElementZIndex)(_this.button, _this.panel) + 2000 : zIndexProp; var popoverStyles = _objectSpread(_objectSpread({}, _this.props.panelStyle), {}, { top: top, left: _this.props.attachToAnchor && anchorBoundingBox ? anchorBoundingBox.left : left, zIndex: zIndex }); var willRenderArrow = !_this.props.attachToAnchor && _this.props.hasArrow; var arrowStyles = willRenderArrow ? arrow : undefined; var arrowPosition = foundPosition; _this.props.onPositionChange && _this.props.onPositionChange(arrowPosition); _this.setState({ popoverStyles: popoverStyles, arrowStyles: arrowStyles, arrowPosition: arrowPosition, openPosition: foundPosition }); }); (0, _defineProperty2.default)((0, _assertThisInitialized2.default)(_this), "positionPopoverFixed", function () { _this.positionPopover(true); }); (0, _defineProperty2.default)((0, _assertThisInitialized2.default)(_this), "positionPopoverFluid", function () { _this.positionPopover(false); }); (0, _defineProperty2.default)((0, _assertThisInitialized2.default)(_this), "panelRef", function (node) { _this.panel = node; _this.props.panelRef && _this.props.panelRef(node); if (node == null) { // panel has unmounted, restore the state defaults _this.setState({ popoverStyles: DEFAULT_POPOVER_STYLES, arrowStyles: {}, arrowPosition: null, openPosition: null, isOpenStable: false }); window.removeEventListener('resize', _this.positionPopoverFluid); } else { // panel is coming into existence _this.positionPopoverFluid(); window.addEventListener('resize', _this.positionPopoverFluid); } }); (0, _defineProperty2.default)((0, _assertThisInitialized2.default)(_this), "buttonRef", function (node) { _this.button = node; _this.props.buttonRef && _this.props.buttonRef(node); }); _this.state = { prevProps: { isOpen: props.isOpen }, suppressingPopover: props.isOpen, // only suppress if created with isOpen=true isClosing: false, isOpening: false, popoverStyles: DEFAULT_POPOVER_STYLES, arrowStyles: {}, arrowPosition: null, openPosition: null, // once a stable position has been found, keep the contents on that side isOpenStable: false // wait for any initial opening transitions to finish before marking as stable }; return _this; } (0, _createClass2.default)(EuiPopover, [{ key: "componentDidMount", value: function componentDidMount() { var _this2 = this; if (this.state.suppressingPopover) { // component was created with isOpen=true; now that it's mounted // stop suppressing and start opening this.setState({ suppressingPopover: false, isOpening: true }, function () { _this2.onOpenPopover(); }); } if (this.props.repositionOnScroll) { window.addEventListener('scroll', this.positionPopoverFixed, true); } } }, { key: "componentDidUpdate", value: function componentDidUpdate(prevProps) { var _this3 = this; // The popover is being opened. if (!prevProps.isOpen && this.props.isOpen) { this.onOpenPopover(); } // update scroll listener if (prevProps.repositionOnScroll !== this.props.repositionOnScroll) { if (this.props.repositionOnScroll) { window.addEventListener('scroll', this.positionPopoverFixed, true); } else { window.removeEventListener('scroll', this.positionPopoverFixed, true); } } // The popover is being closed. if (prevProps.isOpen && !this.props.isOpen) { // If the user has just closed the popover, queue up the removal of the content after the // transition is complete. this.closingTransitionTimeout = window.setTimeout(function () { _this3.setState({ isClosing: false }); }, closingTransitionTime); } } }, { key: "componentWillUnmount", value: function componentWillUnmount() { window.removeEventListener('scroll', this.positionPopoverFixed, true); clearTimeout(this.respositionTimeout); clearTimeout(this.strandedFocusTimeout); clearTimeout(this.closingTransitionTimeout); cancelAnimationFrame(this.closingTransitionAnimationFrame); } }, { key: "render", value: function render() { var _panelProps$tabIndex, _this4 = this; var _this$props = this.props, anchorClassName = _this$props.anchorClassName, anchorPosition = _this$props.anchorPosition, button = _this$props.button, buttonRef = _this$props.buttonRef, insert = _this$props.insert, isOpen = _this$props.isOpen, ownFocus = _this$props.ownFocus, children = _this$props.children, className = _this$props.className, closePopover = _this$props.closePopover, panelClassName = _this$props.panelClassName, panelPaddingSize = _this$props.panelPaddingSize, panelProps = _this$props.panelProps, panelRef = _this$props.panelRef, panelStyle = _this$props.panelStyle, popoverScreenReaderText = _this$props.popoverScreenReaderText, popoverRef = _this$props.popoverRef, hasArrow = _this$props.hasArrow, arrowChildren = _this$props.arrowChildren, repositionOnScroll = _this$props.repositionOnScroll, hasDragDrop = _this$props.hasDragDrop, zIndex = _this$props.zIndex, attachToAnchor = _this$props.attachToAnchor, display = _this$props.display, offset = _this$props.offset, onPositionChange = _this$props.onPositionChange, buffer = _this$props.buffer, ariaLabel = _this$props['aria-label'], ariaLabelledBy = _this$props['aria-labelledby'], container = _this$props.container, focusTrapProps = _this$props.focusTrapProps, initialFocusProp = _this$props.initialFocus, _tabIndexProp = _this$props.tabIndex, rest = (0, _objectWithoutProperties2.default)(_this$props, _excluded); var tabIndexProp = (_panelProps$tabIndex = panelProps === null || panelProps === void 0 ? void 0 : panelProps.tabIndex) !== null && _panelProps$tabIndex !== void 0 ? _panelProps$tabIndex : _tabIndexProp; var styles = (0, _popover2.euiPopoverStyles)(); var popoverStyles = [styles.euiPopover, { display: display }]; var classes = (0, _classnames.default)('euiPopover', { 'euiPopover-isOpen': this.state.isOpening }, className); var anchorClasses = (0, _classnames.default)('euiPopover__anchor', anchorClassName); var showArrow = hasArrow && !attachToAnchor; var panel; if (!this.state.suppressingPopover && (isOpen || this.state.isClosing)) { var tabIndex = tabIndexProp; var initialFocus = initialFocusProp; var ariaDescribedby; var ariaLive; var panelAriaModal = panelProps !== null && panelProps !== void 0 && panelProps.hasOwnProperty('aria-modal') ? panelProps['aria-modal'] : 'true'; var panelRole = panelProps !== null && panelProps !== void 0 && panelProps.hasOwnProperty('role') ? panelProps.role : 'dialog'; if (ownFocus || panelAriaModal !== 'true') { tabIndex = tabIndexProp !== null && tabIndexProp !== void 0 ? tabIndexProp : 0; ariaLive = 'off'; if (!initialFocus) { initialFocus = function initialFocus() { return _this4.panel; }; } } else { ariaLive = 'assertive'; } var focusTrapScreenReaderText; if (ownFocus || popoverScreenReaderText) { ariaDescribedby = this.descriptionId; focusTrapScreenReaderText = (0, _react.jsx)(_accessibility.EuiScreenReaderOnly, null, (0, _react.jsx)("p", { id: this.descriptionId }, ownFocus && (0, _react.jsx)(_i18n.EuiI18n, { token: "euiPopover.screenReaderAnnouncement", default: "You are in a dialog. Press Escape, or tap/click outside the dialog to close." }), popoverScreenReaderText)); } var returnFocus = this.state.isOpenStable ? returnFocusConfig : false; panel = (0, _react.jsx)(_portal.EuiPortal, { insert: insert }, (0, _react.jsx)(_focus_trap.EuiFocusTrap, (0, _extends2.default)({ clickOutsideDisables: true, onClickOutside: this.onClickOutside, returnFocus: returnFocus // Ignore temporary state of indecisive focus , initialFocus: initialFocus, onEscapeKey: this.onEscapeKey, disabled: !ownFocus || !this.state.isOpenStable || this.state.isClosing }, focusTrapProps), (0, _react.jsx)(_popover_panel.EuiPopoverPanel, (0, _extends2.default)({}, panelProps, { panelRef: this.panelRef, isOpen: this.state.isOpening, position: this.state.arrowPosition, isAttached: attachToAnchor, className: (0, _classnames.default)(panelClassName, panelProps === null || panelProps === void 0 ? void 0 : panelProps.className), hasDragDrop: hasDragDrop, hasShadow: false, paddingSize: panelPaddingSize, tabIndex: tabIndex, "aria-live": ariaLive, role: panelRole, "aria-label": ariaLabel, "aria-labelledby": ariaLabelledBy, "aria-modal": panelAriaModal, "aria-describedby": ariaDescribedby, style: _objectSpread(_objectSpread({}, this.state.popoverStyles), {}, { // Adding `will-change` to reduce risk of a blurry animation in Chrome 86+ willChange: !this.state.isOpenStable ? 'transform, opacity' : undefined }) }), showArrow && this.state.arrowPosition && (0, _react.jsx)(_popover_arrow.EuiPopoverArrow, { position: this.state.arrowPosition, style: this.state.arrowStyles }, arrowChildren), focusTrapScreenReaderText, (0, _react.jsx)(_mutation_observer.EuiMutationObserver, { observerOptions: { attributes: true, // element attribute changes childList: true, // added/removed elements characterData: true, // text changes subtree: true // watch all child elements }, onMutation: this.onMutation }, function (mutationRef) { return (0, _react.jsx)("div", { ref: mutationRef }, children); })))); } // react-focus-on and related do not register outside click detection // when disabled, so we still need to conditionally check for that ourselves if (ownFocus) { return (0, _react.jsx)("div", (0, _extends2.default)({ css: popoverStyles, className: classes, ref: popoverRef }, rest), (0, _react.jsx)("div", { css: /*#__PURE__*/(0, _react.css)({ display: display }, ";label:render;"), className: anchorClasses, ref: this.buttonRef }, button instanceof HTMLElement ? null : button), panel); } else { return (0, _react.jsx)(_outside_click_detector.EuiOutsideClickDetector, { onOutsideClick: this.closePopover }, (0, _react.jsx)("div", (0, _extends2.default)({ css: popoverStyles, className: classes, ref: popoverRef, onKeyDown: this.onKeyDown }, rest), (0, _react.jsx)("div", { css: /*#__PURE__*/(0, _react.css)({ display: display }, ";label:render;"), className: anchorClasses, ref: this.buttonRef }, button instanceof HTMLElement ? null : button), panel)); } } }], [{ key: "getDerivedStateFromProps", value: function getDerivedStateFromProps(nextProps, prevState) { if (prevState.prevProps.isOpen && !nextProps.isOpen) { return { prevProps: { isOpen: nextProps.isOpen }, isClosing: true, isOpening: false }; } if (prevState.prevProps.isOpen !== nextProps.isOpen) { return { prevProps: { isOpen: nextProps.isOpen } }; } return null; } }]); return EuiPopover; }(_react2.Component); exports.EuiPopover = EuiPopover; (0, _defineProperty2.default)(EuiPopover, "defaultProps", { isOpen: false, ownFocus: true, anchorPosition: 'downCenter', panelPaddingSize: 'm', hasArrow: true, display: 'inline-block' }); EuiPopover.propTypes = { /** * Class name passed to the direct parent of the button */ anchorClassName: _propTypes.default.string, /** * Alignment of the popover and arrow relative to the button */ anchorPosition: _propTypes.default.any, /** * Style and position alteration for arrow-less, left-aligned * attachment. Intended for use with inputs as anchors, e.g. * EuiInputPopover */ attachToAnchor: _propTypes.default.bool, /** * Triggering element for which to align the popover to */ button: _propTypes.default.any.isRequired, buttonRef: _propTypes.default.any, /** * Callback to handle hiding of the popover */ closePopover: _propTypes.default.func.isRequired, /** * Restrict the popover's position within this element */ container: _propTypes.default.any, /** * CSS display type for both the popover and anchor */ display: _propTypes.default.any, /** * Object of props passed to EuiFocusTrap */ focusTrapProps: _propTypes.default.any, /** * Show arrow indicating to originating button */ hasArrow: _propTypes.default.bool, /** * Specifies what element should initially have focus; Can be a DOM * node, or a selector string (which will be passed to * document.querySelector() to find the DOM node), or a function that * returns a DOM node. * * If not passed, initial focus defaults to the popover panel. */ initialFocus: _propTypes.default.any, /** * Passed directly to EuiPortal for DOM positioning. Both properties are * required if prop is specified */ insert: _propTypes.default.shape({ sibling: _propTypes.default.any.isRequired, position: _propTypes.default.oneOf(["before", "after"]).isRequired }), /** * Visibility state of the popover */ isOpen: _propTypes.default.bool, /** * Traps tab focus within the popover contents */ ownFocus: _propTypes.default.bool, /** * Custom class added to the EuiPanel containing the popover contents */ panelClassName: _propTypes.default.string, /** * EuiPanel padding on all sides */ panelPaddingSize: _propTypes.default.any, /** * Standard DOM `style` attribute. Passed to the EuiPanel */ panelStyle: _propTypes.default.any, /** * Object of props passed to EuiPanel. See #EuiPopoverPanelProps */ panelProps: _propTypes.default.any, panelRef: _propTypes.default.any, /** * Optional screen reader instructions to announce upon popover open, * in addition to EUI's default popover instructions for Escape on close. * Useful for popovers that may have additional keyboard capabilities such as * arrow navigation. */ popoverScreenReaderText: _propTypes.default.oneOfType([_propTypes.default.string.isRequired, _propTypes.default.node.isRequired]), popoverRef: _propTypes.default.any, /** * When `true`, the popover's position is re-calculated when the user * scrolls, this supports having fixed-position popover anchors. When nesting * an `EuiPopover` in a scrollable container, `repositionOnScroll` should be `true` */ repositionOnScroll: _propTypes.default.bool, /** * Must be set to true if using `EuiDragDropContext` within a popover, * otherwise your nested drag & drop will have incorrect positioning */ hasDragDrop: _propTypes.default.bool, /** * By default, popover content inherits the z-index of the anchor * component; pass `zIndex` to override */ zIndex: _propTypes.default.number, /** * Distance away from the anchor that the popover will render */ offset: _propTypes.default.number, /** * Minimum distance between the popover and the bounding container; * Pass an array of 4 values to adjust each side differently: `[top, right, bottom, left]` * Default is 16 */ buffer: _propTypes.default.oneOfType([_propTypes.default.number.isRequired, _propTypes.default.any.isRequired]), /** * Element to pass as the child element of the arrow; * Use case is typically limited to an accompanying `EuiBeacon` */ arrowChildren: _propTypes.default.node, /** * Provide a name to the popover panel */ "aria-label": _propTypes.default.string, /** * Alternative option to `aria-label` that takes an `id`. * Usually takes the `id` of the popover title */ "aria-labelledby": _propTypes.default.string, /** * Function callback for when the popover positon changes */ onPositionChange: _propTypes.default.func, className: _propTypes.default.string, "data-test-subj": _propTypes.default.string, css: _propTypes.default.any };