@elastic/eui
Version:
Elastic UI Component Library
305 lines (292 loc) • 16.6 kB
JavaScript
;
var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
var _typeof = require("@babel/runtime/helpers/typeof");
Object.defineProperty(exports, "__esModule", {
value: true
});
exports.useScrollCellIntoView = exports.useScrollBars = exports.useScroll = void 0;
var _regenerator = _interopRequireDefault(require("@babel/runtime/regenerator"));
var _asyncToGenerator2 = _interopRequireDefault(require("@babel/runtime/helpers/asyncToGenerator"));
var _react = _interopRequireWildcard(require("react"));
var _services = require("../../../services");
var _hooks = require("../../../services/hooks");
var _global_styling = require("../../../global_styling");
var _cell = require("../body/cell");
var _focus = require("./focus");
var _scrolling = require("./scrolling.styles");
var _react2 = require("@emotion/react");
function _getRequireWildcardCache(e) { if ("function" != typeof WeakMap) return null; var r = new WeakMap(), t = new WeakMap(); return (_getRequireWildcardCache = function _getRequireWildcardCache(e) { return e ? t : r; })(e); }
function _interopRequireWildcard(e, r) { if (!r && e && e.__esModule) return e; if (null === e || "object" != _typeof(e) && "function" != typeof e) return { default: e }; var t = _getRequireWildcardCache(r); if (t && t.has(e)) return t.get(e); var n = { __proto__: null }, a = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var u in e) if ("default" !== u && {}.hasOwnProperty.call(e, u)) { var i = a ? Object.getOwnPropertyDescriptor(e, u) : null; i && (i.get || i.set) ? Object.defineProperty(n, u, i) : n[u] = e[u]; } return n.default = e, t && t.set(e, n), n; }
/*
* 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 ACTIONS_MENU_HEIGHT = 21;
/**
* The primary goal of this scroll logic is to ensure keyboard navigation works accessibly,
* but there are other scenarios where it applies (e.g. clicking partially-visible cells)
* or is useful for (e.g. manually scrolling to cell that is currently out of viewport
* while accounting for headers/footers/scrollbars)
*/
var useScroll = exports.useScroll = function useScroll(args) {
var _useScrollCellIntoVie = useScrollCellIntoView(args),
scrollCellIntoView = _useScrollCellIntoVie.scrollCellIntoView;
var _useContext = (0, _react.useContext)(_focus.DataGridFocusContext),
focusedCell = _useContext.focusedCell;
var isPointerDownRef = (0, _hooks.useIsPointerDown)(args.outerGridRef);
/**
* Set when `focusedCell` changes while the pointer is held down (e.g. clicking a cell).
* Allows the `pointerup` listener below to scroll on release without
* causing snap-back when the user scrolls the grid without changing focus.
*/
var pendingScrollRef = (0, _react.useRef)(false);
(0, _react.useEffect)(function () {
if (!focusedCell) return;
if (isPointerDownRef.current) {
// Pointer is down - defer scroll decision to the pointerup listener
pendingScrollRef.current = true;
return;
}
scrollCellIntoView({
rowIndex: focusedCell[1],
colIndex: focusedCell[0]
});
}, [focusedCell, scrollCellIntoView, isPointerDownRef]);
(0, _react.useEffect)(function () {
var handlePointerUp = function handlePointerUp(event) {
var _window;
if (!pendingScrollRef.current || !focusedCell) return;
pendingScrollRef.current = false;
// The pointerup event can come from any mouse button, not only the left
// click. We only care about the primary (usually left) mouse button
// clicks, and specifically have to ignore middle mouse button clicks,
// which indicate scrolling on Windows.
if (event.pointerType === 'mouse' && event.button !== 0) return;
// Skip if the interaction resulted in text being selected
if (((_window = window) === null || _window === void 0 || (_window = _window.getSelection()) === null || _window === void 0 ? void 0 : _window.type) === 'Range') return;
scrollCellIntoView({
rowIndex: focusedCell[1],
colIndex: focusedCell[0]
});
};
document.addEventListener('pointerup', handlePointerUp, {
capture: true
});
return function () {
return document.removeEventListener('pointerup', handlePointerUp, {
capture: true
});
};
}, [focusedCell, scrollCellIntoView]);
var _useContext2 = (0, _react.useContext)(_cell.DataGridCellPopoverContext),
popoverIsOpen = _useContext2.popoverIsOpen,
cellLocation = _useContext2.cellLocation;
(0, _react.useEffect)(function () {
if (popoverIsOpen) {
scrollCellIntoView({
rowIndex: cellLocation.rowIndex,
colIndex: cellLocation.colIndex
});
}
}, [popoverIsOpen, cellLocation, scrollCellIntoView]);
return {
scrollCellIntoView: scrollCellIntoView
};
};
/**
* Ensures that the passed cell is always fully in view by using cell position
* checks and scroll adjustments/workarounds.
*/
var useScrollCellIntoView = exports.useScrollCellIntoView = function useScrollCellIntoView(_ref) {
var gridRef = _ref.gridRef,
outerGridRef = _ref.outerGridRef,
hasGridScrolling = _ref.hasGridScrolling,
headerRowHeight = _ref.headerRowHeight,
footerRowHeight = _ref.footerRowHeight,
visibleRowCount = _ref.visibleRowCount,
hasStickyFooter = _ref.hasStickyFooter,
canDragAndDropColumns = _ref.canDragAndDropColumns;
var scrollCellIntoView = (0, _react.useCallback)(
/*#__PURE__*/
// Note: in order for this UX to work correctly with react-window's APIs,
// the `rowIndex` arg expected is actually our internal `visibleRowIndex`,
// not the `rowIndex` from the raw unsorted/unpaginated user data
function () {
var _ref2 = (0, _asyncToGenerator2.default)(function (_ref3) {
var rowIndex = _ref3.rowIndex,
colIndex = _ref3.colIndex;
return /*#__PURE__*/_regenerator.default.mark(function _callee(_adjustedScrollLeft) {
var getCell, cell, cellIsInView, isStickyHeader, isStickyFooter, isDraggableHeader, isDraggableHeaderCell, _outerGridRef$current, scrollTop, scrollLeft, adjustedScrollTop, adjustedScrollLeft, cellLeftPos, cellRightPos, rightScrollBound, rightWidthOutOfView, leftScrollBound, leftWidthOutOfView, _adjustedScrollTop, parentRow, cellBottomPos, bottomScrollBound, bottomHeightOutOfView, cellTopPos, topScrollBound, topHeightOutOfView, _adjustedScrollLeft2, _adjustedScrollTop2;
return _regenerator.default.wrap(function _callee$(_context) {
while (1) switch (_context.prev = _context.next) {
case 0:
if (!(!gridRef.current || !outerGridRef.current)) {
_context.next = 2;
break;
}
return _context.abrupt("return");
case 2:
if (hasGridScrolling) {
_context.next = 4;
break;
}
return _context.abrupt("return");
case 4:
// Obtain the outermost wrapper of the current cell in view in order to
// get scroll position/height/width calculations and determine what level
// of scroll adjustment the cell needs
getCell = function getCell() {
return outerGridRef.current.querySelector("[data-gridcell-column-index=\"".concat(colIndex, "\"][data-gridcell-visible-row-index=\"").concat(rowIndex, "\"]"));
};
cell = getCell(); // If the cell is completely out of view, we need to use react-window's
// scrollToItem API to get it virtualized and rendered.
cellIsInView = !!getCell();
if (cellIsInView) {
_context.next = 12;
break;
}
gridRef.current.scrollToItem({
rowIndex: rowIndex,
columnIndex: colIndex
});
_context.next = 11;
return new Promise(requestAnimationFrame);
case 11:
// The cell does not immediately render - we need to wait an async tick
cell = getCell();
case 12:
if (cell) {
_context.next = 14;
break;
}
return _context.abrupt("return");
case 14:
// If for some reason we can't find a valid cell, short-circuit
isStickyHeader = rowIndex === -1;
isStickyFooter = hasStickyFooter && rowIndex === visibleRowCount;
isDraggableHeader = canDragAndDropColumns && isStickyHeader;
isDraggableHeaderCell = isDraggableHeader && cell.offsetLeft === 0 && colIndex !== 0; // We now manually adjust scroll positioning around the cell to ensure it's
// fully in view on all sides. A couple of notes on this:
// 1. We're avoiding relying on react-window's scrollToItem for this because it also
// does not account for sticky items (see https://github.com/bvaughn/react-window/issues/586)
// 2. The current scroll position we're using as a base comes from either by
// `scrollToItem` or native .focus()'s automatic scroll behavior. This gets us
// halfway there, but doesn't guarantee the *full* cell in view, or account for
// sticky positioned rows or OS scrollbars, hence these workarounds
_outerGridRef$current = outerGridRef.current, scrollTop = _outerGridRef$current.scrollTop, scrollLeft = _outerGridRef$current.scrollLeft;
// Draggable header columns are nested within EuiDraggables,
// and their offsetLeft needs to go up a wrapper as a result
cellLeftPos = isDraggableHeaderCell ? cell.offsetParent.offsetLeft : cell.offsetLeft; // Check if the cell's right side is outside the current scrolling bounds
cellRightPos = cellLeftPos + cell.offsetWidth;
rightScrollBound = scrollLeft + outerGridRef.current.clientWidth; // Note: We specifically want clientWidth and not offsetWidth here to account for scrollbars
rightWidthOutOfView = cellRightPos - rightScrollBound;
if (rightWidthOutOfView > 0) {
adjustedScrollLeft = scrollLeft + rightWidthOutOfView;
}
// Check if the cell's left side is outside the current scrolling bounds
leftScrollBound = (_adjustedScrollLeft = adjustedScrollLeft) !== null && _adjustedScrollLeft !== void 0 ? _adjustedScrollLeft : scrollLeft;
leftWidthOutOfView = leftScrollBound - cellLeftPos;
if (leftWidthOutOfView > 0) {
// Note: This overrides the right side being out of bounds, as we want to prefer
// showing the top-left corner of items if a cell is larger than the grid container
adjustedScrollLeft = cellLeftPos;
}
// Skip top/bottom scroll adjustments for sticky headers & footers
// since they should always be in view vertically
if (!isStickyHeader && !isStickyFooter) {
parentRow = cell.parentNode; // Check if the cell's bottom side is outside the current scrolling bounds
cellBottomPos = parentRow.offsetTop + cell.offsetHeight;
bottomScrollBound = scrollTop + outerGridRef.current.clientHeight; // Note: We specifically want clientHeight and not offsetHeight here to account for scrollbars
if (hasStickyFooter) bottomScrollBound -= footerRowHeight; // Sticky footer is not always present
bottomHeightOutOfView = cellBottomPos - bottomScrollBound;
if (bottomHeightOutOfView > 0) {
adjustedScrollTop = scrollTop + bottomHeightOutOfView;
}
// Check if the cell's top side is outside the current scrolling bounds
cellTopPos = parentRow.offsetTop;
topScrollBound = (_adjustedScrollTop = adjustedScrollTop) !== null && _adjustedScrollTop !== void 0 ? _adjustedScrollTop : scrollTop + headerRowHeight; // Sticky header is always present
topHeightOutOfView = topScrollBound - cellTopPos;
if (topHeightOutOfView > 0) {
// Note: This overrides the bottom side being out of bounds, as we want to prefer
// showing the top-left corner of items if a cell is larger than the grid container
// Additionally, add an offset for the actions menu
adjustedScrollTop = cellTopPos - headerRowHeight - ACTIONS_MENU_HEIGHT;
}
}
// Check for undefined specifically (because 0 is a valid scroll position)
// to avoid unnecessarily calling scrollTo or hijacking scroll
if (adjustedScrollTop !== undefined || adjustedScrollLeft !== undefined) {
gridRef.current.scrollTo({
scrollLeft: (_adjustedScrollLeft2 = adjustedScrollLeft) !== null && _adjustedScrollLeft2 !== void 0 ? _adjustedScrollLeft2 : scrollLeft,
scrollTop: (_adjustedScrollTop2 = adjustedScrollTop) !== null && _adjustedScrollTop2 !== void 0 ? _adjustedScrollTop2 : scrollTop
});
}
case 29:
case "end":
return _context.stop();
}
}, _callee);
})();
});
return function (_x) {
return _ref2.apply(this, arguments);
};
}(), [gridRef, outerGridRef, hasGridScrolling, headerRowHeight, footerRowHeight, visibleRowCount, hasStickyFooter, canDragAndDropColumns]);
return {
scrollCellIntoView: scrollCellIntoView
};
};
/**
* Checks whether the current grid scrolls and/or has scrollbars
*/
var useScrollBars = exports.useScrollBars = function useScrollBars(outerGridRef) {
var borderStyle = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : 'all';
// https://stackoverflow.com/a/40568748/4294462
var scrollBarHeight = outerGridRef.current ? outerGridRef.current.offsetHeight - outerGridRef.current.clientHeight : 0;
var scrollBarWidth = outerGridRef.current ? outerGridRef.current.offsetWidth - outerGridRef.current.clientWidth : 0;
// https://stackoverflow.com/a/5038256
// Note that it is possible (MacOS) for a grid to scroll but not have scrollbar widths/heights
var hasHorizontalScroll = outerGridRef.current ? outerGridRef.current.scrollWidth > outerGridRef.current.clientWidth : false;
var hasVerticalScroll = outerGridRef.current ? outerGridRef.current.scrollHeight > outerGridRef.current.clientHeight : false;
// If the grid scrolls or has scrollbars, we add custom border overlays
// (since borders are normally set by cells) to ensure our grid body has
// ending borders regardless of scroll position
var styles = (0, _services.useEuiMemoizedStyles)(_scrolling.euiDataGridScrollBarStyles);
var scrollBorderOverlay = (0, _react.useMemo)(function () {
if (!hasHorizontalScroll && !hasVerticalScroll) {
return null; // Nothing to render if the grid doesn't scroll
}
if (borderStyle === 'none') {
return null; // Nothing to render if the grid doesn't use borders
}
return (0, _react2.jsx)("div", {
css: styles.euiDataGrid__scrollOverlay,
className: "euiDataGrid__scrollOverlay",
role: "presentation"
}, scrollBarHeight > 0 && (0, _react2.jsx)("div", {
css: styles.euiDataGrid__scrollBarOverlayBottom,
className: "euiDataGrid__scrollBarOverlayBottom",
style: (0, _global_styling.logicalStyles)({
bottom: scrollBarHeight
})
}), scrollBarWidth > 0 && (0, _react2.jsx)("div", {
css: styles.euiDataGrid__scrollBarOverlayRight,
className: "euiDataGrid__scrollBarOverlayRight",
style: (0, _global_styling.logicalStyles)({
top: 0,
bottom: scrollBarHeight,
right: scrollBarWidth
})
}));
}, [hasHorizontalScroll, hasVerticalScroll, scrollBarHeight, scrollBarWidth, borderStyle, styles]);
return {
scrollBarHeight: scrollBarHeight,
scrollBarWidth: scrollBarWidth,
hasVerticalScroll: hasVerticalScroll,
hasHorizontalScroll: hasHorizontalScroll,
scrollBorderOverlay: scrollBorderOverlay
};
};