@elastic/eui 62.1.0 → 62.2.2

package/es/test/rtl/component_helpers.js

@@ -9,9 +9,10 @@ function _asyncToGenerator(fn) { return function () { var self = this, args = ar
  * in compliance with, at your election, the Elastic License 2.0 or the Server
  * Side Public License, v 1.
  */
+import '@testing-library/jest-dom';
 import { waitFor } from '@testing-library/react';
 /**
- * Ensure the EuiPopover being tested is open/closed before contiuning
+ * Ensure the EuiPopover being tested is open/closed before continuing
  * Note: Because EuiPopover is portalled, we want to query `document`
  * instead of the `container` returned by RTL's render()
  */
@@ -69,4 +70,62 @@ export var waitForEuiPopoverClose = /*#__PURE__*/function () {
   return function waitForEuiPopoverClose() {
     return _ref2.apply(this, arguments);
   };
+}();
+/**
+ * Ensure the EuiToolTip being tested is open and visible before continuing
+ */
+
+export var waitForEuiToolTipVisible = /*#__PURE__*/function () {
+  var _ref3 = _asyncToGenerator( /*#__PURE__*/regeneratorRuntime.mark(function _callee3() {
+    return regeneratorRuntime.wrap(function _callee3$(_context3) {
+      while (1) {
+        switch (_context3.prev = _context3.next) {
+          case 0:
+            _context3.next = 2;
+            return waitFor(function () {
+              var tooltip = document.querySelector('.euiToolTipPopover');
+              expect(tooltip).toBeVisible();
+            });
+
+          case 2:
+            return _context3.abrupt("return", _context3.sent);
+
+          case 3:
+          case "end":
+            return _context3.stop();
+        }
+      }
+    }, _callee3);
+  }));
+
+  return function waitForEuiToolTipVisible() {
+    return _ref3.apply(this, arguments);
+  };
+}();
+export var waitForEuiToolTipHidden = /*#__PURE__*/function () {
+  var _ref4 = _asyncToGenerator( /*#__PURE__*/regeneratorRuntime.mark(function _callee4() {
+    return regeneratorRuntime.wrap(function _callee4$(_context4) {
+      while (1) {
+        switch (_context4.prev = _context4.next) {
+          case 0:
+            _context4.next = 2;
+            return waitFor(function () {
+              var tooltip = document.querySelector('.euiToolTipPopover');
+              expect(tooltip).toBeNull();
+            });
+
+          case 2:
+            return _context4.abrupt("return", _context4.sent);
+
+          case 3:
+          case "end":
+            return _context4.stop();
+        }
+      }
+    }, _callee4);
+  }));
+
+  return function waitForEuiToolTipHidden() {
+    return _ref4.apply(this, arguments);
+  };
 }();

package/eui.d.ts

@@ -4368,7 +4368,7 @@ declare module '@elastic/eui/src/components/portal/portal' {
 	 * NOTE: We can't test this component because Enzyme doesn't support rendering
 	 * into portals.
 	 */
-	import { ReactNode } from 'react';
+	import { Component, ReactNode } from 'react';
 	interface InsertPositionsMap {
 	    after: InsertPosition;
 	    before: InsertPosition;
@@ -4386,7 +4386,14 @@ declare module '@elastic/eui/src/components/portal/portal' {
 	    };
 	    portalRef?: (ref: HTMLDivElement | null) => void;
 	}
-	export const EuiPortal: React.FC<EuiPortalProps>;
+	export class EuiPortal extends Component<EuiPortalProps> {
+	    portalNode: HTMLDivElement | null;
+	    constructor(props: EuiPortalProps);
+	    componentDidMount(): void;
+	    componentWillUnmount(): void;
+	    updatePortalRef(ref: HTMLDivElement | null): void;
+	    render(): import("react").ReactPortal | null;
+	}
 	export {};
 
 }
@@ -5058,7 +5065,7 @@ declare module '@elastic/eui/src/components/popover/popover_footer' {
 
 }
 declare module '@elastic/eui/src/components/popover/wrapping_popover' {
-	import { FunctionComponent } from 'react';
+	import { Component } from 'react';
 	import { Props as EuiPopoverProps } from '@elastic/eui/src/components/popover/popover';
 	export interface EuiWrappingPopoverProps extends EuiPopoverProps {
 	    button: HTMLElement;
@@ -5068,7 +5075,15 @@ declare module '@elastic/eui/src/components/popover/wrapping_popover' {
 	 * then the button element is moved into the popover dom.
 	 * On unmount, the button is moved back to its original location.
 	 */
-	export const EuiWrappingPopover: FunctionComponent<EuiWrappingPopoverProps>;
+	export class EuiWrappingPopover extends Component<EuiWrappingPopoverProps> {
+	    private portal;
+	    private anchor;
+	    componentDidMount(): void;
+	    componentWillUnmount(): void;
+	    setPortalRef: (node: HTMLElement | null) => void;
+	    setAnchorRef: (node: HTMLElement | null) => void;
+	    render(): JSX.Element;
+	}
 
 }
 declare module '@elastic/eui/src/components/popover' {
@@ -6637,7 +6652,7 @@ declare module '@elastic/eui/src/services/throttle' {
 	export const throttle: (fn: (...args: any[]) => void, wait?: number) => (...args: any[]) => void;
 
 }
-declare module '@elastic/eui/src/services/breakpoint/currentEuiBreakpoint' {
+declare module '@elastic/eui/src/services/breakpoint/current_breakpoint' {
 	import React, { FunctionComponent } from 'react';
 	import { _EuiThemeBreakpoint } from '@elastic/eui/src/global_styling/variables/breakpoint'; type CurrentEuiBreakpoint = _EuiThemeBreakpoint | undefined;
 	export const CurrentEuiBreakpointContext: React.Context<CurrentEuiBreakpoint>;
@@ -6646,11 +6661,17 @@ declare module '@elastic/eui/src/services/breakpoint/currentEuiBreakpoint' {
 	 * resize listener that returns the current breakpoint based on window width
 	 */
 	export const CurrentEuiBreakpointProvider: FunctionComponent;
+	export {};
+
+}
+declare module '@elastic/eui/src/services/breakpoint/current_breakpoint_hook' {
 	/**
-	 * Hook util / syntactical sugar
+	 * Hook util / syntactical sugar for useContext()
+	 *
+	 * This hook is in its own separate file to make mocking it
+	 * as a testenv easy for Jest unit tests
 	 */
-	export const useCurrentEuiBreakpoint: () => CurrentEuiBreakpoint;
-	export {};
+	export const useCurrentEuiBreakpoint: () => "s" | "xs" | "m" | "l" | "xl" | undefined;
 
 }
 declare module '@elastic/eui/src/services/breakpoint/useIsWithinBreakpoints' {
@@ -6670,7 +6691,8 @@ declare module '@elastic/eui/src/services/breakpoint/useIsWithinBreakpoints' {
 }
 declare module '@elastic/eui/src/services/breakpoint' {
 	export * from '@elastic/eui/src/services/breakpoint/breakpoint';
-	export * from '@elastic/eui/src/services/breakpoint/currentEuiBreakpoint';
+	export * from '@elastic/eui/src/services/breakpoint/current_breakpoint';
+	export * from '@elastic/eui/src/services/breakpoint/current_breakpoint_hook';
 	export * from '@elastic/eui/src/services/breakpoint/useIsWithinBreakpoints';
 
 }
@@ -9859,14 +9881,17 @@ declare module '@elastic/eui/src/components/datagrid/utils/sorting' {
 }
 declare module '@elastic/eui/src/components/datagrid/utils/row_heights' {
 	import { CSSProperties, MutableRefObject } from 'react';
-	import { EuiDataGridStyleCellPaddings, EuiDataGridStyle, EuiDataGridRowHeightOption, EuiDataGridRowHeightsOptions, EuiDataGridColumn, ImperativeGridApi } from '@elastic/eui/src/components/datagrid/data_grid_types';
+	import { GridOnItemsRenderedProps } from 'react-window';
+	import { EuiDataGridColumn, EuiDataGridRowHeightOption, EuiDataGridRowHeightsOptions, EuiDataGridScrollAnchorRow, EuiDataGridStyle, EuiDataGridStyleCellPaddings, ImperativeGridApi } from '@elastic/eui/src/components/datagrid/data_grid_types';
 	export const cellPaddingsMap: Record<EuiDataGridStyleCellPaddings, number>;
 	export const AUTO_HEIGHT = "auto";
 	export const DEFAULT_ROW_HEIGHT = 34;
 	export class RowHeightUtils {
 	    private gridRef;
+	    private outerGridElementRef;
+	    private gridItemsRenderedRef;
 	    private rerenderGridBodyRef;
-	    constructor(gridRef: MutableRefObject<ImperativeGridApi | null>, rerenderGridBodyRef: MutableRefObject<(() => void) | null>);
+	    constructor(gridRef: MutableRefObject<ImperativeGridApi | null>, outerGridElementRef: MutableRefObject<HTMLDivElement | null>, gridItemsRenderedRef: MutableRefObject<GridOnItemsRenderedProps | null>, rerenderGridBodyRef: MutableRefObject<(() => void) | null>);
 	    getRowHeightOption(rowIndex: number, rowHeightsOptions?: EuiDataGridRowHeightsOptions): EuiDataGridRowHeightOption | undefined;
 	    isRowHeightOverride(rowIndex: number, rowHeightsOptions?: EuiDataGridRowHeightsOptions): boolean;
 	    getCalculatedHeight(heightOption: EuiDataGridRowHeightOption, defaultHeight: number, rowIndex?: number, isRowHeightOverride?: boolean): number;
@@ -9893,13 +9918,16 @@ declare module '@elastic/eui/src/components/datagrid/utils/row_heights' {
 	    pruneHiddenColumnHeights(visibleColumns: EuiDataGridColumn[]): void;
 	    resetRow(visibleRowIndex: number): void;
 	    resetGrid(): void;
+	    compensateForLayoutShift(rowIndex: number, verticalLayoutShift: number, anchorRow: EuiDataGridScrollAnchorRow): void;
 	}
 	/**
 	 * Hook for instantiating RowHeightUtils, setting internal class vars,
 	 * and setting up various row-height-related side effects
 	 */
-	export const useRowHeightUtils: ({ gridRef, gridStyles, columns, rowHeightsOptions, }: {
+	export const useRowHeightUtils: ({ gridRef, outerGridElementRef, gridItemsRenderedRef, gridStyles, columns, rowHeightsOptions, }: {
 	    gridRef: MutableRefObject<ImperativeGridApi | null>;
+	    outerGridElementRef: MutableRefObject<HTMLDivElement | null>;
+	    gridItemsRenderedRef: MutableRefObject<GridOnItemsRenderedProps | null>;
 	    gridStyles: EuiDataGridStyle;
 	    columns: EuiDataGridColumn[];
 	    rowHeightsOptions?: EuiDataGridRowHeightsOptions | undefined;
@@ -10796,6 +10824,7 @@ declare module '@elastic/eui/src/components/datagrid/data_grid_types' {
 	    width: number;
 	}
 	export type EuiDataGridOnColumnResizeHandler = (data: EuiDataGridOnColumnResizeData) => void;
+	export type EuiDataGridScrollAnchorRow = 'start' | 'center' | undefined;
 	export type EuiDataGridRowHeightOption = number | 'auto' | ExclusiveUnion<{
 	    lineCount: number;
 	}, {
@@ -10822,6 +10851,13 @@ declare module '@elastic/eui/src/components/datagrid/data_grid_types' {
 	     * Can be used for, e.g. storing user `rowHeightsOptions` in a local storage object.
 	     */
 	    onChange?: (rowHeightsOptions: EuiDataGridRowHeightsOptions) => void;
+	    /**
+	     * Optional indicator of the row that should be used as an anchor for vertical layout shift compensation.
+	     * When set to 'start' or 'center', the topmost or middle visible row will try
+	     * to compensate for changes in their top offsets by adjusting the grid's scroll
+	     * position.
+	     */
+	    scrollAnchorRow?: EuiDataGridScrollAnchorRow;
 	}
 	export interface EuiDataGridRowManager {
 	    getRow(args: {
@@ -12969,10 +13005,9 @@ declare module '@elastic/eui/src/components/description_list/description_list_co
 declare module '@elastic/eui/src/components/description_list/description_list_title' {
 	import { HTMLAttributes, FunctionComponent } from 'react';
 	import { CommonProps } from '@elastic/eui/src/components/common';
-	interface EuiDescriptionListTitleProps extends CommonProps, HTMLAttributes<HTMLElement> {
+	export interface EuiDescriptionListTitleProps extends CommonProps, HTMLAttributes<HTMLElement> {
 	}
 	export const EuiDescriptionListTitle: FunctionComponent<EuiDescriptionListTitleProps>;
-	export {};
 
 }
 declare module '@elastic/eui/src/components/description_list/description_list_description.styles' {
@@ -12999,10 +13034,9 @@ declare module '@elastic/eui/src/components/description_list/description_list_de
 declare module '@elastic/eui/src/components/description_list/description_list_description' {
 	import { HTMLAttributes, FunctionComponent } from 'react';
 	import { CommonProps } from '@elastic/eui/src/components/common';
-	interface EuiDescriptionListDescriptionProps extends CommonProps, HTMLAttributes<HTMLElement> {
+	export interface EuiDescriptionListDescriptionProps extends CommonProps, HTMLAttributes<HTMLElement> {
 	}
 	export const EuiDescriptionListDescription: FunctionComponent<EuiDescriptionListDescriptionProps>;
-	export {};
 
 }
 declare module '@elastic/eui/src/components/description_list/description_list.styles' {
@@ -19032,56 +19066,6 @@ declare module '@elastic/eui' {
 	export * from '@elastic/eui/src/themes';
 	export * from '@elastic/eui/src/global_styling';
 
-}
-declare module '@elastic/eui/src/test/internal/render_with_styles' {
-	import { ReactElement } from 'react';
-	/**
-	 * Use this function to add the `@emotion` Jest serializer to a single test.
-	 * The resulting snapshot will include the styles of elements in the component that use `@emotion` for styling.
-	 *
-	 * This function must be run outside of a `test` block:
-	 
-	  ```
-	  describe('EuiMark', () => {
-	    renderWithStyles(<EuiMark>Marked</EuiMark>);
-
-	    test('is rendered', () => {});
-	  });
-	  ```
-	 */
-	export const renderWithStyles: (component: ReactElement) => never;
-
-}
-declare module '@elastic/eui/src/test/internal/render_custom_styles' {
-	import { ReactElement } from 'react';
-	/**
-	 * Use this test helper to quickly check that the component supports custom
-	 * `className`, `css`, and `style` properties.
-	 *
-	 * Example usage:
-	 *
-	 * shouldRenderCustomStyles(<EuiMark {...requiredProps} />Marked</EuiMark>);
-	 */
-	export const shouldRenderCustomStyles: (component: ReactElement) => void;
-
-}
-declare module '@elastic/eui/src/test/internal/test_custom_hook' {
-	
-	export const HookWrapper: (props: {
-	    hook?: Function;
-	}) => JSX.Element;
-	export const testCustomHook: <T>(hook?: Function | undefined, args?: unknown) => {
-	    return: T;
-	    getUpdatedState: () => T;
-	    updateHookArgs: (args: unknown) => void;
-	};
-
-}
-declare module '@elastic/eui/src/test/internal' {
-	export * from '@elastic/eui/src/test/internal/render_with_styles';
-	export * from '@elastic/eui/src/test/internal/render_custom_styles';
-	export * from '@elastic/eui/src/test/internal/test_custom_hook';
-
 }
 declare module '@elastic/eui/src/components/icon/assets/videoPlayer' {
 	import * as React from 'react';
@@ -23626,90 +23610,6 @@ declare module 'mdast-util-to-hast/lib/all' {
   const all: (h: H, node: Node) => Node[];
   export = all;
 }
-declare module '@elastic/eui/src/test/rtl/component_helpers' {
-	/**
-	 * Ensure the EuiPopover being tested is open/closed before contiuning
-	 * Note: Because EuiPopover is portalled, we want to query `document`
-	 * instead of the `container` returned by RTL's render()
-	 */
-	export const waitForEuiPopoverOpen: () => Promise<void>;
-	export const waitForEuiPopoverClose: () => Promise<void>;
-
-}
-declare module '@elastic/eui/src/test/rtl/data_test_subj_queries' {
-	import { queryHelpers, Matcher, MatcherOptions } from '@testing-library/react'; const queryAllByTestSubject: (container: HTMLElement, id: Matcher, options?: MatcherOptions | undefined) => HTMLElement[]; const queryByTestSubject: queryHelpers.QueryBy<[Matcher]>, getAllByTestSubject: queryHelpers.GetAllBy<[Matcher]>, getByTestSubject: queryHelpers.GetBy<[Matcher]>, findAllByTestSubject: queryHelpers.FindAllBy<[Matcher]>, findByTestSubject: queryHelpers.FindBy<[Matcher]>;
-	export { queryByTestSubject, queryAllByTestSubject, getByTestSubject, getAllByTestSubject, findAllByTestSubject, findByTestSubject, };
-
-}
-declare module '@elastic/eui/src/test/rtl/custom_render' {
-	import { ReactElement } from 'react';
-	import { queries, RenderOptions, Screen } from '@testing-library/react';
-	import * as dataTestSubjQueries from '@elastic/eui/src/test/rtl/data_test_subj_queries'; const customRender: (ui: ReactElement, { queries: renderQueries, ...options }?: RenderOptions) => import("@testing-library/react").RenderResult<{
-	    getByLabelText: typeof queries.getByLabelText;
-	    getAllByLabelText: typeof queries.getAllByLabelText;
-	    queryByLabelText: typeof queries.queryByLabelText;
-	    queryAllByLabelText: typeof queries.queryAllByLabelText;
-	    findByLabelText: typeof queries.findByLabelText;
-	    findAllByLabelText: typeof queries.findAllByLabelText;
-	    getByPlaceholderText: typeof queries.getByPlaceholderText;
-	    getAllByPlaceholderText: typeof queries.getAllByPlaceholderText;
-	    queryByPlaceholderText: typeof queries.queryByPlaceholderText;
-	    queryAllByPlaceholderText: typeof queries.queryAllByPlaceholderText;
-	    findByPlaceholderText: typeof queries.findByPlaceholderText;
-	    findAllByPlaceholderText: typeof queries.findAllByPlaceholderText;
-	    getByText: typeof queries.getByText;
-	    getAllByText: typeof queries.getAllByText;
-	    queryByText: typeof queries.queryByText;
-	    queryAllByText: typeof queries.queryAllByText;
-	    findByText: typeof queries.findByText;
-	    findAllByText: typeof queries.findAllByText;
-	    getByAltText: typeof queries.getByAltText;
-	    getAllByAltText: typeof queries.getAllByAltText;
-	    queryByAltText: typeof queries.queryByAltText;
-	    queryAllByAltText: typeof queries.queryAllByAltText;
-	    findByAltText: typeof queries.findByAltText;
-	    findAllByAltText: typeof queries.findAllByAltText;
-	    getByTitle: typeof queries.getByTitle;
-	    getAllByTitle: typeof queries.getAllByTitle;
-	    queryByTitle: typeof queries.queryByTitle;
-	    queryAllByTitle: typeof queries.queryAllByTitle;
-	    findByTitle: typeof queries.findByTitle;
-	    findAllByTitle: typeof queries.findAllByTitle;
-	    getByDisplayValue: typeof queries.getByDisplayValue;
-	    getAllByDisplayValue: typeof queries.getAllByDisplayValue;
-	    queryByDisplayValue: typeof queries.queryByDisplayValue;
-	    queryAllByDisplayValue: typeof queries.queryAllByDisplayValue;
-	    findByDisplayValue: typeof queries.findByDisplayValue;
-	    findAllByDisplayValue: typeof queries.findAllByDisplayValue;
-	    getByRole: typeof queries.getByRole;
-	    getAllByRole: typeof queries.getAllByRole;
-	    queryByRole: typeof queries.queryByRole;
-	    queryAllByRole: typeof queries.queryAllByRole;
-	    findByRole: typeof queries.findByRole;
-	    findAllByRole: typeof queries.findAllByRole;
-	    getByTestId: typeof queries.getByTestId;
-	    getAllByTestId: typeof queries.getAllByTestId;
-	    queryByTestId: typeof queries.queryByTestId;
-	    queryAllByTestId: typeof queries.queryAllByTestId;
-	    findByTestId: typeof queries.findByTestId;
-	    findAllByTestId: typeof queries.findAllByTestId;
-	    queryByTestSubject: import("@testing-library/react").QueryBy<[import("@testing-library/react").Matcher]>;
-	    queryAllByTestSubject: (container: HTMLElement, id: import("@testing-library/react").Matcher, options?: import("@testing-library/react").MatcherOptions | undefined) => HTMLElement[];
-	    getByTestSubject: import("@testing-library/react").GetBy<[import("@testing-library/react").Matcher]>;
-	    getAllByTestSubject: import("@testing-library/react").GetAllBy<[import("@testing-library/react").Matcher]>;
-	    findAllByTestSubject: import("@testing-library/react").FindAllBy<[import("@testing-library/react").Matcher]>;
-	    findByTestSubject: import("@testing-library/react").FindBy<[import("@testing-library/react").Matcher]>;
-	}, HTMLElement, HTMLElement>;
-	export { customRender as render }; const customScreen: Screen<typeof queries & typeof dataTestSubjQueries>;
-	export { customScreen as screen };
-
-}
-declare module '@elastic/eui/src/test/rtl' {
-	export * from '@elastic/eui/src/test/rtl/component_helpers';
-	export { queryByTestSubject, queryAllByTestSubject, getByTestSubject, getAllByTestSubject, findAllByTestSubject, findByTestSubject, } from '@elastic/eui/src/test/rtl/data_test_subj_queries';
-	export { render, screen } from '@elastic/eui/src/test/rtl/custom_render';
-
-}
 declare module '@elastic/eui/src/components/table/mobile' {
 	export { EuiTableHeaderMobile } from '@elastic/eui/src/components/table/mobile/table_header_mobile';
 	export type { EuiTableSortMobileProps } from '@elastic/eui/src/components/table/mobile/table_sort_mobile';

package/lib/components/datagrid/body/data_grid_body.js

@@ -373,6 +373,8 @@ var EuiDataGridBody = function EuiDataGridBody(props) {
 
   var rowHeightUtils = (0, _row_heights.useRowHeightUtils)({
     gridRef: gridRef,
+    outerGridElementRef: outerGridRef,
+    gridItemsRenderedRef: gridItemsRendered,
     gridStyles: gridStyles,
     columns: columns,
     rowHeightsOptions: rowHeightsOptions
@@ -1057,7 +1059,15 @@ EuiDataGridBody.propTypes = {
        * Optional callback returning the current `rowHeightsOptions` when changes occur from user input (e.g. toolbar display controls).
        * Can be used for, e.g. storing user `rowHeightsOptions` in a local storage object.
        */
-    onChange: _propTypes.default.func
+    onChange: _propTypes.default.func,
+
+    /**
+       * Optional indicator of the row that should be used as an anchor for vertical layout shift compensation.
+       * When set to 'start' or 'center', the topmost or middle visible row will try
+       * to compensate for changes in their top offsets by adjusting the grid's scroll
+       * position.
+       */
+    scrollAnchorRow: _propTypes.default.oneOf(["start", "center", undefined])
   }),
   isFullScreen: _propTypes.default.bool.isRequired,
   gridStyles: _propTypes.default.shape({

package/lib/components/datagrid/body/data_grid_cell.js

@@ -565,7 +565,15 @@ EuiDataGridCellContent.propTypes = {
        * Optional callback returning the current `rowHeightsOptions` when changes occur from user input (e.g. toolbar display controls).
        * Can be used for, e.g. storing user `rowHeightsOptions` in a local storage object.
        */
-    onChange: _propTypes.default.func
+    onChange: _propTypes.default.func,
+
+    /**
+       * Optional indicator of the row that should be used as an anchor for vertical layout shift compensation.
+       * When set to 'start' or 'center', the topmost or middle visible row will try
+       * to compensate for changes in their top offsets by adjusting the grid's scroll
+       * position.
+       */
+    scrollAnchorRow: _propTypes.default.oneOf(["start", "center", undefined])
   }),
   rowHeightUtils: _propTypes.default.any,
   pagination: _propTypes.default.shape({
@@ -935,7 +943,7 @@ var EuiDataGridCell = /*#__PURE__*/function (_Component) {
   }, {
     key: "componentDidUpdate",
     value: function componentDidUpdate(prevProps) {
-      var _this$props$rowHeight, _prevProps$rowHeights;
+      var _this$props$rowHeight, _prevProps$rowHeights, _this$props$rowHeight2, _this$props$style, _prevProps$style;
 
       this.recalculateAutoHeight();
 
@@ -943,6 +951,18 @@ var EuiDataGridCell = /*#__PURE__*/function (_Component) {
         this.recalculateLineHeight();
       }
 
+      if ((_this$props$rowHeight2 = this.props.rowHeightsOptions) !== null && _this$props$rowHeight2 !== void 0 && _this$props$rowHeight2.scrollAnchorRow && this.props.colIndex === 0 && // once per row
+      this.props.columnId === prevProps.columnId && // if this is still the same column
+      this.props.rowIndex === prevProps.rowIndex && // if this is still the same row
+      ((_this$props$style = this.props.style) === null || _this$props$style === void 0 ? void 0 : _this$props$style.top) !== ((_prevProps$style = prevProps.style) === null || _prevProps$style === void 0 ? void 0 : _prevProps$style.top) // if the top position has changed
+      ) {
+        var _prevProps$style2, _this$props$style2, _this$props$rowHeight3, _this$props$rowHeight4;
+
+        var previousTop = parseFloat((_prevProps$style2 = prevProps.style) === null || _prevProps$style2 === void 0 ? void 0 : _prevProps$style2.top);
+        var currentTop = parseFloat((_this$props$style2 = this.props.style) === null || _this$props$style2 === void 0 ? void 0 : _this$props$style2.top);
+        (_this$props$rowHeight3 = this.props.rowHeightUtils) === null || _this$props$rowHeight3 === void 0 ? void 0 : _this$props$rowHeight3.compensateForLayoutShift(this.props.rowIndex, currentTop - previousTop, (_this$props$rowHeight4 = this.props.rowHeightsOptions) === null || _this$props$rowHeight4 === void 0 ? void 0 : _this$props$rowHeight4.scrollAnchorRow);
+      }
+
       if (this.props.popoverContext.popoverIsOpen !== prevProps.popoverContext.popoverIsOpen || this.props.popoverContext.cellLocation !== prevProps.popoverContext.cellLocation || this.props.renderCellPopover !== prevProps.renderCellPopover) {
         this.handleCellPopover();
       }
@@ -1592,7 +1612,15 @@ EuiDataGridCell.propTypes = {
        * Optional callback returning the current `rowHeightsOptions` when changes occur from user input (e.g. toolbar display controls).
        * Can be used for, e.g. storing user `rowHeightsOptions` in a local storage object.
        */
-    onChange: _propTypes.default.func
+    onChange: _propTypes.default.func,
+
+    /**
+       * Optional indicator of the row that should be used as an anchor for vertical layout shift compensation.
+       * When set to 'start' or 'center', the topmost or middle visible row will try
+       * to compensate for changes in their top offsets by adjusting the grid's scroll
+       * position.
+       */
+    scrollAnchorRow: _propTypes.default.oneOf(["start", "center", undefined])
   }),
   rowHeightUtils: _propTypes.default.any,
   rowManager: _propTypes.default.shape({

package/lib/components/datagrid/data_grid.js

@@ -1282,7 +1282,15 @@ EuiDataGrid.propTypes = {
        * Optional callback returning the current `rowHeightsOptions` when changes occur from user input (e.g. toolbar display controls).
        * Can be used for, e.g. storing user `rowHeightsOptions` in a local storage object.
        */
-    onChange: _propTypes.default.func
+    onChange: _propTypes.default.func,
+
+    /**
+       * Optional indicator of the row that should be used as an anchor for vertical layout shift compensation.
+       * When set to 'start' or 'center', the topmost or middle visible row will try
+       * to compensate for changes in their top offsets by adjusting the grid's scroll
+       * position.
+       */
+    scrollAnchorRow: _propTypes.default.oneOf(["start", "center", undefined])
   })
 };
 EuiDataGrid.displayName = 'EuiDataGrid';

package/lib/components/datagrid/utils/row_heights.js

@@ -7,10 +7,10 @@ exports.useRowHeightUtils = exports.useDefaultRowHeight = exports.cellPaddingsMa
 
 var _react = require("react");
 
-var _predicate = require("../../../services/predicate");
-
 var _services = require("../../../services");
 
+var _predicate = require("../../../services/predicate");
+
 var _sorting = require("./sorting");
 
 function _slicedToArray(arr, i) { return _arrayWithHoles(arr) || _iterableToArrayLimit(arr, i) || _unsupportedIterableToArray(arr, i) || _nonIterableRest(); }
@@ -54,12 +54,14 @@ var DEFAULT_ROW_HEIGHT = 34;
 exports.DEFAULT_ROW_HEIGHT = DEFAULT_ROW_HEIGHT;
 
 var RowHeightUtils = /*#__PURE__*/function () {
-  function RowHeightUtils(gridRef, rerenderGridBodyRef) {
+  function RowHeightUtils(gridRef, outerGridElementRef, gridItemsRenderedRef, rerenderGridBodyRef) {
     var _this = this;
 
     _classCallCheck(this, RowHeightUtils);
 
     this.gridRef = gridRef;
+    this.outerGridElementRef = outerGridElementRef;
+    this.gridItemsRenderedRef = gridItemsRenderedRef;
     this.rerenderGridBodyRef = rerenderGridBodyRef;
 
     _defineProperty(this, "styles", {
@@ -255,6 +257,31 @@ var RowHeightUtils = /*#__PURE__*/function () {
       (_this$gridRef$current = this.gridRef.current) === null || _this$gridRef$current === void 0 ? void 0 : _this$gridRef$current.resetAfterRowIndex(this.lastUpdatedRow);
       this.lastUpdatedRow = Infinity;
     }
+  }, {
+    key: "compensateForLayoutShift",
+    value: function compensateForLayoutShift(rowIndex, verticalLayoutShift, anchorRow) {
+      var grid = this.gridRef.current;
+      var outerGridElement = this.outerGridElementRef.current;
+      var renderedItems = this.gridItemsRenderedRef.current;
+
+      if (grid == null || outerGridElement == null || renderedItems == null || anchorRow == null || !Number.isFinite(verticalLayoutShift)) {
+        return;
+      } // skip if the start row is the anchor row but it hasn't shifted
+
+
+      if (anchorRow === 'start' && renderedItems.visibleRowStartIndex !== rowIndex) {
+        return;
+      } // skip if the center row is the anchor row but it hasn't shifted
+
+
+      if (anchorRow === 'center' && Math.floor((renderedItems.visibleRowStopIndex - renderedItems.visibleRowStartIndex) / 2) !== rowIndex) {
+        return;
+      }
+
+      grid.scrollTo({
+        scrollTop: outerGridElement.scrollTop + verticalLayoutShift
+      });
+    }
   }]);
 
   return RowHeightUtils;
@@ -269,13 +296,15 @@ exports.RowHeightUtils = RowHeightUtils;
 
 var useRowHeightUtils = function useRowHeightUtils(_ref2) {
   var gridRef = _ref2.gridRef,
+      outerGridElementRef = _ref2.outerGridElementRef,
+      gridItemsRenderedRef = _ref2.gridItemsRenderedRef,
       gridStyles = _ref2.gridStyles,
       columns = _ref2.columns,
       rowHeightsOptions = _ref2.rowHeightsOptions;
   var forceRenderRef = (0, _services.useLatest)((0, _services.useForceRender)());
 
   var _useState = (0, _react.useState)(function () {
-    return new RowHeightUtils(gridRef, forceRenderRef);
+    return new RowHeightUtils(gridRef, outerGridElementRef, gridItemsRenderedRef, forceRenderRef);
   }),
       _useState2 = _slicedToArray(_useState, 1),
       rowHeightUtils = _useState2[0]; // Forces a rerender whenever the row heights change, as this can cause the