@elastic/eui
Version:
Elastic UI Component Library
272 lines (269 loc) • 14.9 kB
JavaScript
function _typeof(obj) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (obj) { return typeof obj; } : function (obj) { return obj && "function" == typeof Symbol && obj.constructor === Symbol && obj !== Symbol.prototype ? "symbol" : typeof obj; }, _typeof(obj); }
var _excluded = ["position", "paddingSize", "affordForDisplacement", "children", "className", "bodyClassName", "landmarkHeading", "usePortal", "left", "right", "bottom", "top", "style"];
function _extends() { _extends = Object.assign ? Object.assign.bind() : function (target) { for (var i = 1; i < arguments.length; i++) { var source = arguments[i]; for (var key in source) { if (Object.prototype.hasOwnProperty.call(source, key)) { target[key] = source[key]; } } } return target; }; return _extends.apply(this, arguments); }
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) { _defineProperty(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 _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
function _toPropertyKey(arg) { var key = _toPrimitive(arg, "string"); return _typeof(key) === "symbol" ? key : String(key); }
function _toPrimitive(input, hint) { if (_typeof(input) !== "object" || input === null) return input; var prim = input[Symbol.toPrimitive]; if (prim !== undefined) { var res = prim.call(input, hint || "default"); if (_typeof(res) !== "object") return res; throw new TypeError("@@toPrimitive must return a primitive value."); } return (hint === "string" ? String : Number)(input); }
function _slicedToArray(arr, i) { return _arrayWithHoles(arr) || _iterableToArrayLimit(arr, i) || _unsupportedIterableToArray(arr, i) || _nonIterableRest(); }
function _nonIterableRest() { throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) arr2[i] = arr[i]; return arr2; }
function _iterableToArrayLimit(arr, i) { var _i = null == arr ? null : "undefined" != typeof Symbol && arr[Symbol.iterator] || arr["@@iterator"]; if (null != _i) { var _s, _e, _x, _r, _arr = [], _n = !0, _d = !1; try { if (_x = (_i = _i.call(arr)).next, 0 === i) { if (Object(_i) !== _i) return; _n = !1; } else for (; !(_n = (_s = _x.call(_i)).done) && (_arr.push(_s.value), _arr.length !== i); _n = !0); } catch (err) { _d = !0, _e = err; } finally { try { if (!_n && null != _i.return && (_r = _i.return(), Object(_r) !== _r)) return; } finally { if (_d) throw _e; } } return _arr; } }
function _arrayWithHoles(arr) { if (Array.isArray(arr)) return arr; }
function _objectWithoutProperties(source, excluded) { if (source == null) return {}; var target = _objectWithoutPropertiesLoose(source, excluded); var key, i; if (Object.getOwnPropertySymbols) { var sourceSymbolKeys = Object.getOwnPropertySymbols(source); for (i = 0; i < sourceSymbolKeys.length; i++) { key = sourceSymbolKeys[i]; if (excluded.indexOf(key) >= 0) continue; if (!Object.prototype.propertyIsEnumerable.call(source, key)) continue; target[key] = source[key]; } } return target; }
function _objectWithoutPropertiesLoose(source, excluded) { if (source == null) return {}; var target = {}; var sourceKeys = Object.keys(source); var key, i; for (i = 0; i < sourceKeys.length; i++) { key = sourceKeys[i]; if (excluded.indexOf(key) >= 0) continue; target[key] = source[key]; } return target; }
/*
* 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.
*/
import classNames from 'classnames';
import PropTypes from "prop-types";
import React, { forwardRef, useEffect, useState } from 'react';
import { useCombinedRefs, useEuiTheme } from '../../services';
import { EuiScreenReaderOnly } from '../accessibility';
import { EuiI18n } from '../i18n';
import { useResizeObserver } from '../observer/resize_observer';
import { EuiPortal } from '../portal';
import { euiBottomBarStyles } from './bottom_bar.styles';
import { EuiThemeProvider } from '../../services/theme/provider';
import { jsx as ___EmotionJSX } from "@emotion/react";
// Exported for testing
export var paddingSizeToClassNameMap = {
none: null,
s: 'euiBottomBar--paddingSmall',
m: 'euiBottomBar--paddingMedium',
l: 'euiBottomBar--paddingLarge'
};
export var POSITIONS = ['static', 'fixed', 'sticky'];
var _EuiBottomBar = /*#__PURE__*/forwardRef(function (_ref, ref) {
var _ref$position = _ref.position,
position = _ref$position === void 0 ? 'fixed' : _ref$position,
_ref$paddingSize = _ref.paddingSize,
paddingSize = _ref$paddingSize === void 0 ? 'm' : _ref$paddingSize,
_ref$affordForDisplac = _ref.affordForDisplacement,
affordForDisplacement = _ref$affordForDisplac === void 0 ? true : _ref$affordForDisplac,
children = _ref.children,
className = _ref.className,
bodyClassName = _ref.bodyClassName,
landmarkHeading = _ref.landmarkHeading,
_ref$usePortal = _ref.usePortal,
usePortal = _ref$usePortal === void 0 ? true : _ref$usePortal,
_ref$left = _ref.left,
left = _ref$left === void 0 ? 0 : _ref$left,
_ref$right = _ref.right,
right = _ref$right === void 0 ? 0 : _ref$right,
_ref$bottom = _ref.bottom,
bottom = _ref$bottom === void 0 ? 0 : _ref$bottom,
top = _ref.top,
style = _ref.style,
rest = _objectWithoutProperties(_ref, _excluded);
var euiTheme = useEuiTheme();
var styles = euiBottomBarStyles(euiTheme);
// Force some props if `fixed` position, but not if the user has supplied these
affordForDisplacement = position !== 'fixed' ? false : affordForDisplacement;
usePortal = position !== 'fixed' ? false : usePortal;
var _useState = useState(null),
_useState2 = _slicedToArray(_useState, 2),
resizeRef = _useState2[0],
setResizeRef = _useState2[1];
var setRef = useCombinedRefs([setResizeRef, ref]);
// TODO: Allow this hooke to be conditional
var dimensions = useResizeObserver(resizeRef);
useEffect(function () {
if (affordForDisplacement && usePortal) {
document.body.style.paddingBottom = "".concat(dimensions.height, "px");
}
if (bodyClassName) {
document.body.classList.add(bodyClassName);
}
return function () {
if (affordForDisplacement && usePortal) {
document.body.style.paddingBottom = '';
}
if (bodyClassName) {
document.body.classList.remove(bodyClassName);
}
};
}, [affordForDisplacement, usePortal, dimensions, bodyClassName]);
var classes = classNames('euiBottomBar', "euiBottomBar--".concat(position), paddingSizeToClassNameMap[paddingSize], className);
var cssStyles = [styles.euiBottomBar, styles[position], styles[paddingSize], {
position: position
}];
var newStyle = _objectSpread({
left: left,
right: right,
bottom: bottom,
top: top
}, style);
var bar = ___EmotionJSX(React.Fragment, null, ___EmotionJSX(EuiI18n, {
token: "euiBottomBar.screenReaderHeading",
default: "Page level controls"
}, function (screenReaderHeading) {
return (
// Though it would be better to use aria-labelledby than aria-label and not repeat the same string twice
// A bug in voiceover won't list some landmarks in the rotor without an aria-label
___EmotionJSX("section", _extends({
"aria-label": landmarkHeading ? landmarkHeading : screenReaderHeading,
className: classes,
css: cssStyles,
ref: setRef,
style: newStyle
}, rest), ___EmotionJSX(EuiScreenReaderOnly, null, ___EmotionJSX("h2", null, landmarkHeading ? landmarkHeading : screenReaderHeading)), children)
);
}), ___EmotionJSX(EuiScreenReaderOnly, null, ___EmotionJSX("p", {
"aria-live": "assertive"
}, landmarkHeading ? ___EmotionJSX(EuiI18n, {
token: "euiBottomBar.customScreenReaderAnnouncement",
default: "There is a new region landmark called {landmarkHeading} with page level controls at the end of the document.",
values: {
landmarkHeading: landmarkHeading
}
}) : ___EmotionJSX(EuiI18n, {
token: "euiBottomBar.screenReaderAnnouncement",
default: "There is a new region landmark with page level controls at the end of the document."
}))));
return usePortal ? ___EmotionJSX(EuiPortal, typeof usePortal !== 'boolean' ? usePortal : undefined, bar) : bar;
});
_EuiBottomBar.propTypes = {
className: PropTypes.string,
"aria-label": PropTypes.string,
"data-test-subj": PropTypes.string,
css: PropTypes.any,
/**
* How to position the bottom bar against its parent.
*/
position: PropTypes.oneOfType([PropTypes.oneOf(["fixed"]), PropTypes.oneOf(["static", "sticky"]).isRequired]),
/**
* Whether to wrap in an EuiPortal which appends the component to the body element.
* Only works if `position` is `fixed`.
*/
usePortal: PropTypes.oneOfType([PropTypes.bool.isRequired, PropTypes.shape({
/**
* ReactNode to render as this component's content
*/
children: PropTypes.node.isRequired,
insert: PropTypes.shape({
sibling: PropTypes.any.isRequired,
position: PropTypes.oneOf(["before", "after"]).isRequired
}),
portalRef: PropTypes.func
}).isRequired]),
/**
* Whether the component should apply padding on the document body element to afford for its own displacement height.
* Only works if `usePortal` is true and `position` is `fixed`.
*/
affordForDisplacement: PropTypes.bool,
/**
* Padding applied to the bar. Default is 'm'.
*/
paddingSize: PropTypes.oneOf(["none", "s", "m", "l"]),
/**
* Optional class applied to the body element on mount.
*/
bodyClassName: PropTypes.string,
/**
* Customize the screen reader heading that helps users find this control. Default is 'Page level controls'.
*/
landmarkHeading: PropTypes.string,
/**
* Starting vertical position when `fixed` position.
* Offset from the top of the window when `sticky` position.
* Has no affect on `static` positions.
*/
top: PropTypes.any,
/**
* Ending horizontal position when `fixed` position.
* Has no affect on `static` or `sticky` positions.
*/
right: PropTypes.any,
/**
* Starting vertical position when `fixed` position.
* Offset from the bottom of the window when `sticky` position.
* Has no affect on `static` positions.
*/
bottom: PropTypes.any,
/**
* Starting horizontal position when `fixed` position.
* Has no affect on `static` or `sticky` positions.
*/
left: PropTypes.any
};
export var EuiBottomBar = /*#__PURE__*/forwardRef(function (props, ref) {
var BottomBar = _EuiBottomBar;
return ___EmotionJSX(EuiThemeProvider, {
colorMode: 'dark',
wrapperProps: {
cloneElement: true
}
}, ___EmotionJSX(BottomBar, _extends({
ref: ref
}, props)));
});
EuiBottomBar.propTypes = {
className: PropTypes.string,
"aria-label": PropTypes.string,
"data-test-subj": PropTypes.string,
css: PropTypes.any,
/**
* How to position the bottom bar against its parent.
*/
position: PropTypes.oneOfType([PropTypes.oneOf(["fixed"]), PropTypes.oneOf(["static", "sticky"]).isRequired]),
/**
* Whether to wrap in an EuiPortal which appends the component to the body element.
* Only works if `position` is `fixed`.
*/
usePortal: PropTypes.oneOfType([PropTypes.bool.isRequired, PropTypes.shape({
children: PropTypes.node.isRequired,
insert: PropTypes.shape({
sibling: PropTypes.any.isRequired,
position: PropTypes.oneOf(["before", "after"]).isRequired
}),
portalRef: PropTypes.func
}).isRequired]),
/**
* Whether the component should apply padding on the document body element to afford for its own displacement height.
* Only works if `usePortal` is true and `position` is `fixed`.
*/
affordForDisplacement: PropTypes.bool,
/**
* Padding applied to the bar. Default is 'm'.
*/
paddingSize: PropTypes.oneOf(["none", "s", "m", "l"]),
/**
* Optional class applied to the body element on mount.
*/
bodyClassName: PropTypes.string,
/**
* Customize the screen reader heading that helps users find this control. Default is 'Page level controls'.
*/
landmarkHeading: PropTypes.string,
/**
* Starting vertical position when `fixed` position.
* Offset from the top of the window when `sticky` position.
* Has no affect on `static` positions.
*/
top: PropTypes.any,
/**
* Ending horizontal position when `fixed` position.
* Has no affect on `static` or `sticky` positions.
*/
right: PropTypes.any,
/**
* Starting vertical position when `fixed` position.
* Offset from the bottom of the window when `sticky` position.
* Has no affect on `static` positions.
*/
bottom: PropTypes.any,
/**
* Starting horizontal position when `fixed` position.
* Has no affect on `static` or `sticky` positions.
*/
left: PropTypes.any
};
EuiBottomBar.displayName = 'EuiBottomBar';
_EuiBottomBar.displayName = 'EuiBottomBar';