@elastic/eui 67.1.2 → 69.0.0

package/i18ntokens.json

@@ -229,11 +229,11 @@
     "highlighting": "string",
     "loc": {
       "start": {
-        "line": 180,
+        "line": 182,
         "column": 20
       },
       "end": {
-        "line": 183,
+        "line": 185,
         "column": 3
       }
     },
@@ -485,11 +485,11 @@
     "highlighting": "string",
     "loc": {
       "start": {
-        "line": 266,
+        "line": 272,
         "column": 8
       },
       "end": {
-        "line": 275,
+        "line": 281,
         "column": 9
       }
     },
@@ -501,11 +501,11 @@
     "highlighting": "string",
     "loc": {
       "start": {
-        "line": 266,
+        "line": 272,
         "column": 8
       },
       "end": {
-        "line": 275,
+        "line": 281,
         "column": 9
       }
     },
@@ -517,11 +517,11 @@
     "highlighting": "string",
     "loc": {
       "start": {
-        "line": 312,
+        "line": 318,
         "column": 12
       },
       "end": {
-        "line": 317,
+        "line": 323,
         "column": 14
       }
     },
@@ -533,11 +533,11 @@
     "highlighting": "string",
     "loc": {
       "start": {
-        "line": 322,
+        "line": 328,
         "column": 12
       },
       "end": {
-        "line": 328,
+        "line": 334,
         "column": 13
       }
     },
@@ -549,11 +549,11 @@
     "highlighting": "string",
     "loc": {
       "start": {
-        "line": 322,
+        "line": 328,
         "column": 12
       },
       "end": {
-        "line": 328,
+        "line": 334,
         "column": 13
       }
     },
@@ -565,11 +565,11 @@
     "highlighting": "string",
     "loc": {
       "start": {
-        "line": 354,
+        "line": 360,
         "column": 16
       },
       "end": {
-        "line": 357,
+        "line": 363,
         "column": 17
       }
     },
@@ -581,11 +581,11 @@
     "highlighting": "string",
     "loc": {
       "start": {
-        "line": 511,
+        "line": 513,
         "column": 10
       },
       "end": {
-        "line": 519,
+        "line": 521,
         "column": 12
       }
     },
@@ -661,11 +661,11 @@
     "highlighting": "string",
     "loc": {
       "start": {
-        "line": 325,
+        "line": 330,
         "column": 12
       },
       "end": {
-        "line": 328,
+        "line": 333,
         "column": 14
       }
     },
@@ -677,11 +677,11 @@
     "highlighting": "string",
     "loc": {
       "start": {
-        "line": 338,
+        "line": 343,
         "column": 16
       },
       "end": {
-        "line": 342,
+        "line": 347,
         "column": 18
       }
     },
@@ -693,11 +693,11 @@
     "highlighting": "string",
     "loc": {
       "start": {
-        "line": 356,
+        "line": 362,
         "column": 16
       },
       "end": {
-        "line": 362,
+        "line": 368,
         "column": 18
       }
     },
@@ -709,11 +709,11 @@
     "highlighting": "string",
     "loc": {
       "start": {
-        "line": 391,
+        "line": 397,
         "column": 20
       },
       "end": {
-        "line": 397,
+        "line": 403,
         "column": 22
       }
     },
@@ -725,11 +725,11 @@
     "highlighting": "string",
     "loc": {
       "start": {
-        "line": 408,
+        "line": 414,
         "column": 12
       },
       "end": {
-        "line": 412,
+        "line": 418,
         "column": 14
       }
     },
@@ -741,11 +741,11 @@
     "highlighting": "string",
     "loc": {
       "start": {
-        "line": 419,
+        "line": 425,
         "column": 10
       },
       "end": {
-        "line": 422,
+        "line": 428,
         "column": 12
       }
     },
@@ -757,11 +757,11 @@
     "highlighting": "string",
     "loc": {
       "start": {
-        "line": 428,
+        "line": 434,
         "column": 10
       },
       "end": {
-        "line": 431,
+        "line": 437,
         "column": 12
       }
     },
@@ -773,11 +773,11 @@
     "highlighting": "string",
     "loc": {
       "start": {
-        "line": 968,
+        "line": 1001,
         "column": 10
       },
       "end": {
-        "line": 971,
+        "line": 1004,
         "column": 11
       }
     },
@@ -3637,11 +3637,11 @@
     "highlighting": "string",
     "loc": {
       "start": {
-        "line": 89,
+        "line": 101,
         "column": 49
       },
       "end": {
-        "line": 95,
+        "line": 107,
         "column": 3
       }
     },
@@ -3653,11 +3653,11 @@
     "highlighting": "string",
     "loc": {
       "start": {
-        "line": 89,
+        "line": 101,
         "column": 49
       },
       "end": {
-        "line": 95,
+        "line": 107,
         "column": 3
       }
     },
@@ -3669,11 +3669,11 @@
     "highlighting": "string",
     "loc": {
       "start": {
-        "line": 64,
+        "line": 72,
         "column": 6
       },
       "end": {
-        "line": 67,
+        "line": 75,
         "column": 8
       }
     },
@@ -3685,11 +3685,11 @@
     "highlighting": "string",
     "loc": {
       "start": {
-        "line": 88,
+        "line": 96,
         "column": 10
       },
       "end": {
-        "line": 92,
+        "line": 100,
         "column": 12
       }
     },
@@ -3701,11 +3701,11 @@
     "highlighting": "string",
     "loc": {
       "start": {
-        "line": 132,
+        "line": 142,
         "column": 6
       },
       "end": {
-        "line": 135,
+        "line": 145,
         "column": 7
       }
     },
@@ -3717,11 +3717,11 @@
     "highlighting": "string",
     "loc": {
       "start": {
-        "line": 198,
+        "line": 208,
         "column": 18
       },
       "end": {
-        "line": 201,
+        "line": 211,
         "column": 20
       }
     },
@@ -3749,11 +3749,11 @@
     "highlighting": "string",
     "loc": {
       "start": {
-        "line": 76,
+        "line": 94,
         "column": 8
       },
       "end": {
-        "line": 79,
+        "line": 97,
         "column": 9
       }
     },
@@ -3765,11 +3765,11 @@
     "highlighting": "string",
     "loc": {
       "start": {
-        "line": 149,
+        "line": 166,
         "column": 12
       },
       "end": {
-        "line": 153,
+        "line": 170,
         "column": 14
       }
     },
@@ -3893,11 +3893,11 @@
     "highlighting": "string",
     "loc": {
       "start": {
-        "line": 121,
+        "line": 128,
         "column": 4
       },
       "end": {
-        "line": 127,
+        "line": 134,
         "column": 5
       }
     },
@@ -3909,11 +3909,11 @@
     "highlighting": "string",
     "loc": {
       "start": {
-        "line": 121,
+        "line": 128,
         "column": 4
       },
       "end": {
-        "line": 127,
+        "line": 134,
         "column": 5
       }
     },
@@ -4693,11 +4693,11 @@
     "highlighting": "string",
     "loc": {
       "start": {
-        "line": 111,
+        "line": 112,
         "column": 4
       },
       "end": {
-        "line": 120,
+        "line": 121,
         "column": 5
       }
     },
@@ -4709,11 +4709,11 @@
     "highlighting": "string",
     "loc": {
       "start": {
-        "line": 111,
+        "line": 112,
         "column": 4
       },
       "end": {
-        "line": 120,
+        "line": 121,
         "column": 5
       }
     },
@@ -4725,11 +4725,11 @@
     "highlighting": "string",
     "loc": {
       "start": {
-        "line": 337,
+        "line": 336,
         "column": 32
       },
       "end": {
-        "line": 340,
+        "line": 339,
         "column": 3
       }
     },

package/lib/components/accessibility/skip_link/skip_link.js

@@ -1,11 +1,13 @@
 "use strict";
 
+function _typeof(obj) { "@babel/helpers - typeof"; if (typeof Symbol === "function" && typeof Symbol.iterator === "symbol") { _typeof = function _typeof(obj) { return typeof obj; }; } else { _typeof = function _typeof(obj) { return obj && typeof Symbol === "function" && obj.constructor === Symbol && obj !== Symbol.prototype ? "symbol" : typeof obj; }; } return _typeof(obj); }
+
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.POSITIONS = exports.EuiSkipLink = void 0;
 
-var _react = _interopRequireDefault(require("react"));
+var _react = _interopRequireWildcard(require("react"));
 
 var _propTypes = _interopRequireDefault(require("prop-types"));
 
@@ -23,17 +25,27 @@ var _skip_link = require("./skip_link.styles");
 
 var _react2 = require("@emotion/react");
 
-var _excluded = ["destinationId", "overrideLinkBehavior", "tabIndex", "position", "children", "className"];
+var _excluded = ["destinationId", "fallbackDestination", "overrideLinkBehavior", "tabIndex", "position", "children", "className", "onClick"];
 
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
 
+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 _extends() { _extends = Object.assign || 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); if (enumerableOnly) { symbols = symbols.filter(function (sym) { return Object.getOwnPropertyDescriptor(object, sym).enumerable; }); } keys.push.apply(keys, symbols); } return keys; }
+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 _objectSpread(target) { for (var i = 1; i < arguments.length; i++) { var source = arguments[i] != null ? arguments[i] : {}; if (i % 2) { ownKeys(Object(source), true).forEach(function (key) { _defineProperty(target, key, source[key]); }); } else if (Object.getOwnPropertyDescriptors) { Object.defineProperties(target, Object.getOwnPropertyDescriptors(source)); } else { ownKeys(Object(source)).forEach(function (key) { Object.defineProperty(target, key, Object.getOwnPropertyDescriptor(source, key)); }); } } return target; }
+function _iterableToArrayLimit(arr, i) { var _i = arr == null ? null : typeof Symbol !== "undefined" && arr[Symbol.iterator] || arr["@@iterator"]; if (_i == null) return; var _arr = []; var _n = true; var _d = false; var _s, _e; try { for (_i = _i.call(arr); !(_n = (_s = _i.next()).done); _n = true) { _arr.push(_s.value); if (i && _arr.length === i) break; } } catch (err) { _d = true; _e = err; } finally { try { if (!_n && _i["return"] != null) _i["return"](); } finally { if (_d) throw _e; } } return _arr; }
 
-function _defineProperty(obj, key, value) { if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
+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; }
 
@@ -44,58 +56,78 @@ exports.POSITIONS = POSITIONS;
 
 var EuiSkipLink = function EuiSkipLink(_ref) {
   var destinationId = _ref.destinationId,
+      _ref$fallbackDestinat = _ref.fallbackDestination,
+      fallbackDestination = _ref$fallbackDestinat === void 0 ? 'main' : _ref$fallbackDestinat,
       overrideLinkBehavior = _ref.overrideLinkBehavior,
       tabIndex = _ref.tabIndex,
       _ref$position = _ref.position,
       position = _ref$position === void 0 ? 'static' : _ref$position,
       children = _ref.children,
       className = _ref.className,
+      _onClick = _ref.onClick,
       rest = _objectWithoutProperties(_ref, _excluded);
 
   var euiTheme = (0, _services.useEuiTheme)();
   var styles = (0, _skip_link.euiSkipLinkStyles)(euiTheme);
   var classes = (0, _classnames.default)('euiSkipLink', className);
-  var cssStyles = [styles.euiSkipLink, position !== 'static' ? styles[position] : undefined]; // Create the `href` from `destinationId`
-
-  var optionalProps = {};
-
-  if (destinationId) {
-    optionalProps = {
-      href: "#".concat(destinationId)
-    };
-  }
-
-  if (overrideLinkBehavior) {
-    optionalProps = _objectSpread(_objectSpread({}, optionalProps), {}, {
-      onClick: function onClick(e) {
-        e.preventDefault();
-        var destinationEl = document.getElementById(destinationId);
-        if (!destinationEl) return; // Scroll to the top of the destination content only if it's ~mostly out of view
-
-        var destinationY = destinationEl.getBoundingClientRect().top;
-        var halfOfViewportHeight = window.innerHeight / 2;
-
-        if (destinationY >= halfOfViewportHeight || window.scrollY >= destinationY + halfOfViewportHeight) {
-          destinationEl.scrollIntoView();
-        } // Ensure the destination content is focusable
-
-
-        if (!(0, _tabbable.isTabbable)(destinationEl)) {
-          destinationEl.tabIndex = -1;
-          destinationEl.addEventListener('blur', function () {
-            return destinationEl.removeAttribute('tabindex');
-          }, {
-            once: true
-          });
-        }
-
-        destinationEl.focus({
-          preventScroll: true
-        }); // Scrolling is already handled above, and focus autoscroll behaves oddly on Chrome around fixed headers
+  var cssStyles = [styles.euiSkipLink, position !== 'static' ? styles[position] : undefined];
+
+  var _useState = (0, _react.useState)(null),
+      _useState2 = _slicedToArray(_useState, 2),
+      destinationEl = _useState2[0],
+      setDestinationEl = _useState2[1];
+
+  var _useState3 = (0, _react.useState)(true),
+      _useState4 = _slicedToArray(_useState3, 2),
+      hasValidId = _useState4[0],
+      setHasValidId = _useState4[1];
+
+  (0, _react.useEffect)(function () {
+    var idEl = document.getElementById(destinationId);
+
+    if (idEl) {
+      setHasValidId(true);
+      setDestinationEl(idEl);
+      return;
+    }
+
+    setHasValidId(false); // If no valid element via ID is available, use the fallback query selectors
+
+    var fallbackEl = document.querySelector(fallbackDestination);
+
+    if (fallbackEl) {
+      setDestinationEl(fallbackEl);
+    }
+  }, [destinationId, fallbackDestination]);
+  var onClick = (0, _react.useCallback)(function (e) {
+    if (overrideLinkBehavior || !hasValidId) {
+      if (!destinationEl) return;
+      e.preventDefault(); // Scroll to the top of the destination content only if it's ~mostly out of view
+
+      var destinationY = destinationEl.getBoundingClientRect().top;
+      var halfOfViewportHeight = window.innerHeight / 2;
+
+      if (destinationY >= halfOfViewportHeight || window.scrollY >= destinationY + halfOfViewportHeight) {
+        destinationEl.scrollIntoView();
+      } // Ensure the destination content is focusable
+
+
+      if (!(0, _tabbable.isTabbable)(destinationEl)) {
+        destinationEl.tabIndex = -1;
+        destinationEl.addEventListener('blur', function () {
+          return destinationEl.removeAttribute('tabindex');
+        }, {
+          once: true
+        });
       }
-    });
-  }
 
+      destinationEl.focus({
+        preventScroll: true
+      }); // Scrolling is already handled above, and focus autoscroll behaves oddly on Chrome around fixed headers
+    }
+
+    _onClick === null || _onClick === void 0 ? void 0 : _onClick(e);
+  }, [overrideLinkBehavior, hasValidId, destinationEl, _onClick]);
   return (0, _react2.jsx)(_screen_reader_only.EuiScreenReaderOnly, {
     showOnFocus: true
   }, (0, _react2.jsx)(_button.EuiButton, _extends({
@@ -103,8 +135,10 @@ var EuiSkipLink = function EuiSkipLink(_ref) {
     className: classes,
     tabIndex: position === 'fixed' ? 0 : tabIndex,
     size: "s",
-    fill: true
-  }, optionalProps, rest), children));
+    fill: true,
+    href: "#".concat(destinationId),
+    onClick: onClick
+  }, rest), children));
 };
 
 exports.EuiSkipLink = EuiSkipLink;
@@ -112,22 +146,12 @@ EuiSkipLink.propTypes = {
   href: _propTypes.default.string,
   onClick: _propTypes.default.func,
 
-  /**
-     * Change the display position of the element when focused.
-     * If 'fixed', the link will be fixed to the top left of the viewport
-     */
-
   /**
      * Change the display position of the element when focused.
      * If 'fixed', the link will be fixed to the top left of the viewport
      */
   position: _propTypes.default.any,
 
-  /**
-     * Typically an anchor id (e.g. `a11yMainContent`), the value provided
-     * will be prepended with a hash `#` and used as the link `href`
-     */
-
   /**
      * Typically an anchor id (e.g. `a11yMainContent`), the value provided
      * will be prepended with a hash `#` and used as the link `href`
@@ -135,10 +159,11 @@ EuiSkipLink.propTypes = {
   destinationId: _propTypes.default.string.isRequired,
 
   /**
-     * If default HTML anchor link behavior is not desired (e.g. for SPAs with hash routing),
-     * setting this flag to true will manually scroll to and focus the destination element
-     * without changing the browser URL's hash
+     * If no destination ID element exists or can be found, you may provide a string of
+     * query selectors to fall back to (e.g. a `main` or `role="main"` element)
+     * @default main
      */
+  fallbackDestination: _propTypes.default.string,
 
   /**
      * If default HTML anchor link behavior is not desired (e.g. for SPAs with hash routing),
@@ -147,10 +172,6 @@ EuiSkipLink.propTypes = {
      */
   overrideLinkBehavior: _propTypes.default.bool,
 
-  /**
-     * When position is fixed, this is forced to `0`
-     */
-
   /**
      * When position is fixed, this is forced to `0`
      */