@carbon/ibm-products 1.7.0 → 1.8.0

package/es/components/DataSpreadsheet/DataSpreadsheet.js

@@ -1,6 +1,12 @@
 import _extends from "@babel/runtime/helpers/extends";
+import _defineProperty from "@babel/runtime/helpers/defineProperty";
+import _slicedToArray from "@babel/runtime/helpers/slicedToArray";
 import _objectWithoutProperties from "@babel/runtime/helpers/objectWithoutProperties";
-var _excluded = ["className", "columns", "data"];
+var _excluded = ["cellSize", "className", "columns", "data", "id", "onActiveCellChange"];
+
+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; }
 
 /**
  * Copyright IBM Corp. 2022, 2022
@@ -9,36 +15,65 @@ var _excluded = ["className", "columns", "data"];
  * LICENSE file in the root directory of this source tree.
  */
 // Import portions of React that are needed.
-import React, { useMemo } from 'react';
-import { useBlockLayout, useTable } from 'react-table';
-import { FixedSizeList } from 'react-window'; // Other standard imports.
+import React, { useMemo, useRef, useEffect, useState, useCallback } from 'react';
+import { useBlockLayout, useTable } from 'react-table'; // Other standard imports.
 
 import PropTypes from 'prop-types';
 import cx from 'classnames';
 import { getDevtoolsProps } from '../../global/js/utils/devtools';
-import { pkg
-/*, carbon */
-} from '../../settings';
-import { getScrollbarWidth } from '../../global/js/utils/getScrollbarWidth'; // The block part of our conventional BEM class names (blockClass__E--M).
+import { pkg } from '../../settings';
+import { getScrollbarWidth } from '../../global/js/utils/getScrollbarWidth';
+import { DataSpreadsheetBody } from './DataSpreadsheetBody';
+import { getCellSize } from './getCellSize';
+import { DataSpreadsheetHeader } from './DataSpreadsheetHeader';
+import { useActiveElement } from '../../global/js/hooks';
+import { createActiveCellFn } from './createActiveCellFn'; // cspell:words rowcount colcount
+// The block part of our conventional BEM class names (blockClass__E--M).
 
 var blockClass = "".concat(pkg.prefix, "--data-spreadsheet");
-var componentName = 'DataSpreadsheet';
+var componentName = 'DataSpreadsheet'; // Default values for props
+
+var defaults = {
+  cellSize: 'standard',
+  columns: Object.freeze([]),
+  data: Object.freeze([])
+};
 /**
  * DataSpreadsheet: used to organize and display large amounts of structured data, separated by columns and rows in a grid-like format.
  */
 
 export var DataSpreadsheet = /*#__PURE__*/React.forwardRef(function (_ref, ref) {
-  var className = _ref.className,
-      columns = _ref.columns,
-      data = _ref.data,
+  var _ref$cellSize = _ref.cellSize,
+      cellSize = _ref$cellSize === void 0 ? defaults.cellSize : _ref$cellSize,
+      className = _ref.className,
+      _ref$columns = _ref.columns,
+      columns = _ref$columns === void 0 ? defaults.columns : _ref$columns,
+      _ref$data = _ref.data,
+      data = _ref$data === void 0 ? defaults.data : _ref$data,
+      id = _ref.id,
+      onActiveCellChange = _ref.onActiveCellChange,
       rest = _objectWithoutProperties(_ref, _excluded);
 
+  var focusedElement = useActiveElement();
+
+  var _useState = useState(false),
+      _useState2 = _slicedToArray(_useState, 2),
+      containerHasFocus = _useState2[0],
+      setContainerHasFocus = _useState2[1];
+
+  var _useState3 = useState(null),
+      _useState4 = _slicedToArray(_useState3, 2),
+      activeCellCoordinates = _useState4[0],
+      setActiveCellCoordinates = _useState4[1];
+
+  var cellSizeValue = getCellSize(cellSize);
   var defaultColumn = useMemo(function () {
     return {
       width: 150,
-      rowHeaderWidth: 64
+      rowHeaderWidth: 64,
+      rowHeight: cellSizeValue
     };
-  }, []);
+  }, [cellSizeValue]);
   var scrollBarSize = useMemo(function () {
     return getScrollbarWidth();
   }, []);
@@ -53,65 +88,283 @@ export var DataSpreadsheet = /*#__PURE__*/React.forwardRef(function (_ref, ref)
       headerGroups = _useTable.headerGroups,
       rows = _useTable.rows,
       totalColumnsWidth = _useTable.totalColumnsWidth,
-      prepareRow = _useTable.prepareRow;
-
-  var RenderRow = React.useCallback(function (_ref2) {
-    var index = _ref2.index,
-        style = _ref2.style;
-    var row = rows[index];
-    prepareRow(row);
-    return /*#__PURE__*/React.createElement("div", _extends({}, row.getRowProps({
-      style: style
-    }), {
-      className: "tr",
-      "data-row-index": index
-    }), /*#__PURE__*/React.createElement("button", {
-      type: "button",
-      className: cx("".concat(blockClass, "__td"), "".concat(blockClass, "__td-th")),
-      style: {
-        width: defaultColumn === null || defaultColumn === void 0 ? void 0 : defaultColumn.rowHeaderWidth,
-        display: 'flex',
-        justifyContent: 'flex-end',
-        alignItems: 'center'
+      prepareRow = _useTable.prepareRow; // Reset everything when spreadsheet loses focus
+
+
+  useEffect(function () {
+    if (!focusedElement.classList.contains("".concat(blockClass, "--interactive-cell-element"))) {
+      setContainerHasFocus(false);
+      removeActiveCell();
+    }
+
+    if (focusedElement.classList.contains(blockClass) || focusedElement.classList.contains("".concat(blockClass, "--interactive-cell-element"))) {
+      setContainerHasFocus(true);
+    }
+  }, [focusedElement, removeActiveCell]); // Removes the active cell element
+
+  var removeActiveCell = useCallback(function () {
+    var activeCellHighlight = spreadsheetRef.current.querySelector(".".concat(blockClass, "__active-cell--highlight"));
+
+    if (activeCellHighlight) {
+      activeCellHighlight.remove();
+    }
+  }, [spreadsheetRef]); // Click outside useEffect
+
+  useEffect(function () {
+    var handleOutsideClick = function handleOutsideClick(event) {
+      if (!spreadsheetRef.current || spreadsheetRef.current.contains(event.target) || event.target.classList.contains("".concat(blockClass, "__active-cell--highlight"))) {
+        return;
       }
-    }, index + 1), row.cells.map(function (cell, index) {
-      return /*#__PURE__*/React.createElement("button", _extends({
-        key: "cell_".concat(index)
-      }, cell.getCellProps(), {
-        type: "button",
-        className: "".concat(blockClass, "__td")
-      }), cell.render('Cell'));
-    }));
-  }, [prepareRow, rows, defaultColumn.rowHeaderWidth]);
+
+      removeActiveCell();
+      setContainerHasFocus(false);
+      setActiveCellCoordinates(null);
+    };
+
+    document.addEventListener('click', handleOutsideClick);
+    return function () {
+      document.removeEventListener('click', handleOutsideClick);
+    };
+  }, [spreadsheetRef, removeActiveCell]);
+  var createActiveCell = useCallback(function (_ref2) {
+    var placementElement = _ref2.placementElement,
+        coords = _ref2.coords,
+        _ref2$addToHeader = _ref2.addToHeader,
+        addToHeader = _ref2$addToHeader === void 0 ? false : _ref2$addToHeader;
+    var activeCellFullData = typeof (coords === null || coords === void 0 ? void 0 : coords.column) === 'number' && typeof (coords === null || coords === void 0 ? void 0 : coords.row) === 'number' ? rows[coords === null || coords === void 0 ? void 0 : coords.row].cells[coords === null || coords === void 0 ? void 0 : coords.column] : null;
+    var activeCellValue = activeCellFullData ? Object.values(activeCellFullData.row.values)[coords === null || coords === void 0 ? void 0 : coords.column] : null;
+    createActiveCellFn({
+      placementElement: placementElement,
+      coords: coords,
+      addToHeader: addToHeader,
+      contextRef: spreadsheetRef,
+      blockClass: blockClass,
+      onActiveCellChange: onActiveCellChange,
+      activeCellValue: activeCellValue
+    });
+  }, [spreadsheetRef, rows, onActiveCellChange]);
+  var handleInitialArrowPress = useCallback(function () {
+    // If activeCellCoordinates is null then we need to set an initial value
+    // which will place the activeCell on the select all cell/button
+    if (!activeCellCoordinates) {
+      setActiveCellCoordinates({
+        column: 'header',
+        row: 'header'
+      });
+    }
+
+    return;
+  }, [activeCellCoordinates]);
+
+  var updateActiveCellCoordinates = function updateActiveCellCoordinates(_ref3) {
+    var coords = _ref3.coords,
+        updatedValue = _ref3.updatedValue;
+    setActiveCellCoordinates(_objectSpread(_objectSpread({}, coords), updatedValue));
+  };
+
+  var handleKeyPress = useCallback(function (event) {
+    var keyCode = event.keyCode; // Command keys need to be returned as there is default browser behavior with these keys
+
+    if (keyCode === 91 || keyCode === 93) {
+      return;
+    } // Prevent arrow keys, home key, and end key from scrolling the page when the data spreadsheet container has focus
+
+
+    if ([35, 36, 37, 38, 39, 40].indexOf(keyCode) > -1) {
+      event.preventDefault();
+    }
+
+    switch (keyCode) {
+      // Tab
+      case 9:
+        {
+          removeActiveCell();
+          setContainerHasFocus(false);
+          setActiveCellCoordinates(null);
+          break;
+        }
+      // Left
+
+      case 37:
+        {
+          handleInitialArrowPress();
+
+          var coordinatesClone = _objectSpread({}, activeCellCoordinates);
+
+          if (coordinatesClone.column === 'header') {
+            return;
+          }
+
+          if (typeof coordinatesClone.column === 'number') {
+            if (coordinatesClone.column === 0) {
+              updateActiveCellCoordinates({
+                coords: coordinatesClone,
+                updatedValue: {
+                  column: 'header'
+                }
+              });
+              return;
+            }
+
+            updateActiveCellCoordinates({
+              coords: coordinatesClone,
+              updatedValue: {
+                column: coordinatesClone.column - 1
+              }
+            });
+          }
+
+          break;
+        }
+      // Up
+
+      case 38:
+        {
+          handleInitialArrowPress();
+
+          var _coordinatesClone = _objectSpread({}, activeCellCoordinates);
+
+          if (_coordinatesClone.row === 'header') {
+            return;
+          }
+
+          if (typeof _coordinatesClone.row === 'number') {
+            // set row back to header if we are at index 0
+            if (_coordinatesClone.row === 0) {
+              updateActiveCellCoordinates({
+                coords: _coordinatesClone,
+                updatedValue: {
+                  row: 'header'
+                }
+              });
+              return;
+            } // if we are at any other index than 0, subtract 1 from current row index
+
+
+            updateActiveCellCoordinates({
+              coords: _coordinatesClone,
+              updatedValue: {
+                row: _coordinatesClone.row - 1
+              }
+            });
+          }
+
+          break;
+        }
+      // Right
+
+      case 39:
+        {
+          handleInitialArrowPress();
+
+          var _coordinatesClone2 = _objectSpread({}, activeCellCoordinates);
+
+          if (_coordinatesClone2.column === 'header') {
+            updateActiveCellCoordinates({
+              coords: _coordinatesClone2,
+              updatedValue: {
+                column: 0
+              }
+            });
+          }
+
+          if (typeof _coordinatesClone2.column === 'number') {
+            // Prevent active cell coordinates from updating if the active
+            // cell is in the last column, ie we can't go any further to the right
+            if (columns.length - 1 === _coordinatesClone2.column) {
+              return;
+            }
+
+            updateActiveCellCoordinates({
+              coords: _coordinatesClone2,
+              updatedValue: {
+                column: _coordinatesClone2.column + 1
+              }
+            });
+          }
+
+          break;
+        }
+      // Down
+
+      case 40:
+        {
+          handleInitialArrowPress();
+
+          var _coordinatesClone3 = _objectSpread({}, activeCellCoordinates);
+
+          if (_coordinatesClone3.row === 'header') {
+            updateActiveCellCoordinates({
+              coords: _coordinatesClone3,
+              updatedValue: {
+                row: 0
+              }
+            });
+          }
+
+          if (typeof _coordinatesClone3.row === 'number') {
+            // Prevent active cell coordinates from updating if the active
+            // cell is in the last row, ie we can't go any further down since
+            // we are in the last row
+            if (rows.length - 1 === _coordinatesClone3.row) {
+              return;
+            }
+
+            updateActiveCellCoordinates({
+              coords: _coordinatesClone3,
+              updatedValue: {
+                row: _coordinatesClone3.row + 1
+              }
+            });
+          }
+
+          break;
+        }
+    }
+  }, [handleInitialArrowPress, activeCellCoordinates, removeActiveCell, columns.length, rows.length]); // Adds active cell highlight to correct cell onKeyDown
+
+  useEffect(function () {
+    var activeCellPlacementElement = spreadsheetRef === null || spreadsheetRef === void 0 ? void 0 : spreadsheetRef.current.querySelector("[data-row-index=\"".concat(activeCellCoordinates === null || activeCellCoordinates === void 0 ? void 0 : activeCellCoordinates.row, "\"][data-column-index=\"").concat(activeCellCoordinates === null || activeCellCoordinates === void 0 ? void 0 : activeCellCoordinates.column, "\"]"));
+    var shouldPlaceActiveCellInHeader = (activeCellCoordinates === null || activeCellCoordinates === void 0 ? void 0 : activeCellCoordinates.row) === 'header' && true;
+    var selectAllElement = spreadsheetRef === null || spreadsheetRef === void 0 ? void 0 : spreadsheetRef.current.querySelector("[data-row-index=\"header\"][data-column-index=\"header\"]");
+
+    if (containerHasFocus) {
+      createActiveCell({
+        placementElement: activeCellCoordinates ? activeCellPlacementElement : selectAllElement,
+        coords: activeCellCoordinates,
+        addToHeader: shouldPlaceActiveCellInHeader
+      });
+    }
+  }, [activeCellCoordinates, spreadsheetRef, createActiveCell, containerHasFocus]);
+  var localRef = useRef();
+  var spreadsheetRef = ref || localRef;
   return /*#__PURE__*/React.createElement("div", _extends({}, rest, getTableProps(), getDevtoolsProps(componentName), {
-    className: cx(blockClass, className),
-    ref: ref,
-    role: "grid"
-  }), /*#__PURE__*/React.createElement("div", null, headerGroups.map(function (headerGroup, index) {
-    return /*#__PURE__*/React.createElement("div", _extends({
-      key: "header_".concat(index)
-    }, headerGroup.getHeaderGroupProps(), {
-      className: "".concat(blockClass, "__tr")
-    }), /*#__PURE__*/React.createElement("button", {
-      type: "button",
-      className: "".concat(blockClass, "__th"),
-      style: {
-        width: defaultColumn === null || defaultColumn === void 0 ? void 0 : defaultColumn.rowHeaderWidth
-      }
-    }, "\xA0"), headerGroup.headers.map(function (column, index) {
-      return /*#__PURE__*/React.createElement("button", _extends({
-        key: "column_".concat(index)
-      }, column.getHeaderProps(), {
-        type: "button",
-        className: "".concat(blockClass, "__th")
-      }), column.render('Header'));
-    }));
-  })), /*#__PURE__*/React.createElement("div", getTableBodyProps(), /*#__PURE__*/React.createElement(FixedSizeList, {
-    height: 400,
-    itemCount: rows.length,
-    itemSize: 36,
-    width: totalColumnsWidth + scrollBarSize
-  }, RenderRow)));
+    className: cx(blockClass, className, _defineProperty({}, "".concat(blockClass, "__container-has-focus"), containerHasFocus)),
+    ref: spreadsheetRef,
+    role: "grid",
+    tabIndex: 0,
+    "aria-rowcount": (rows === null || rows === void 0 ? void 0 : rows.length) || 0,
+    "aria-colcount": (columns === null || columns === void 0 ? void 0 : columns.length) || 0,
+    onKeyDown: handleKeyPress,
+    onFocus: function onFocus() {
+      return setContainerHasFocus(true);
+    }
+  }), /*#__PURE__*/React.createElement(DataSpreadsheetHeader, {
+    cellSizeValue: cellSizeValue,
+    defaultColumn: defaultColumn,
+    headerGroups: headerGroups
+  }), /*#__PURE__*/React.createElement(DataSpreadsheetBody, {
+    cellSize: cellSize,
+    defaultColumn: defaultColumn,
+    getTableBodyProps: getTableBodyProps,
+    onActiveCellChange: onActiveCellChange,
+    prepareRow: prepareRow,
+    rows: rows,
+    setActiveCellCoordinates: setActiveCellCoordinates,
+    scrollBarSize: scrollBarSize,
+    totalColumnsWidth: totalColumnsWidth,
+    id: id
+  }));
 }); // Return a placeholder if not released and not enabled by feature flag
 
 DataSpreadsheet = pkg.checkComponentEnabled(DataSpreadsheet, componentName); // The display name of the component, used by React. Note that displayName
@@ -122,6 +375,11 @@ DataSpreadsheet.displayName = componentName; // The types and DocGen commentary
 // See https://www.npmjs.com/package/prop-types#usage.
 
 DataSpreadsheet.propTypes = {
+  /**
+   * Specifies the cell height
+   */
+  cellSize: PropTypes.oneOf(['compact', 'standard', 'medium', 'large']),
+
   /**
    * Provide an optional class to be applied to the containing node.
    */
@@ -140,15 +398,17 @@ DataSpreadsheet.propTypes = {
   /**
    * The spreadsheet data that will be rendered in the body of the spreadsheet component
    */
-  data: PropTypes.arrayOf(PropTypes.shape)
-  /* TODO: add types and DocGen for all props. */
+  data: PropTypes.arrayOf(PropTypes.shape),
+
+  /**
+   * The spreadsheet id
+   */
+  id: PropTypes.oneOfType([PropTypes.number, PropTypes.string]),
 
-}; // Default values for component props. Default values are not required for
-// props that are required, nor for props where the component can apply
-// 'undefined' values reasonably. Default values should be provided when the
-// component needs to make a choice or assumption when a prop is not supplied.
+  /**
+   * The event handler that is called when the active cell changes
+   */
+  onActiveCellChange: PropTypes.func
+  /* TODO: add types and DocGen for all props. */
 
-DataSpreadsheet.defaultProps = {
-  data: [],
-  columns: []
 };

package/es/components/DataSpreadsheet/DataSpreadsheetBody.js

@@ -0,0 +1,138 @@
+import _extends from "@babel/runtime/helpers/extends";
+
+/**
+ * Copyright IBM Corp. 2022, 2022
+ *
+ * This source code is licensed under the Apache-2.0 license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+import React, { useRef, useCallback, useEffect } from 'react';
+import PropTypes from 'prop-types';
+import { FixedSizeList } from 'react-window';
+import cx from 'classnames';
+import { pkg } from '../../settings';
+var blockClass = "".concat(pkg.prefix, "--data-spreadsheet");
+export var DataSpreadsheetBody = function DataSpreadsheetBody(_ref) {
+  var defaultColumn = _ref.defaultColumn,
+      getTableBodyProps = _ref.getTableBodyProps,
+      id = _ref.id,
+      prepareRow = _ref.prepareRow,
+      rows = _ref.rows,
+      setActiveCellCoordinates = _ref.setActiveCellCoordinates,
+      scrollBarSize = _ref.scrollBarSize,
+      totalColumnsWidth = _ref.totalColumnsWidth;
+  // Make sure that if the cellSize prop changes, the active
+  // cell also gets updated with the new size
+  useEffect(function () {
+    var listContainer = spreadsheetBodyRef === null || spreadsheetBodyRef === void 0 ? void 0 : spreadsheetBodyRef.current;
+    var activeCellButton = listContainer.querySelector(".".concat(blockClass, "__active-cell--highlight"));
+
+    if (activeCellButton) {
+      activeCellButton.style.height = "".concat(defaultColumn === null || defaultColumn === void 0 ? void 0 : defaultColumn.rowHeight, "px");
+    }
+  }, [defaultColumn === null || defaultColumn === void 0 ? void 0 : defaultColumn.rowHeight]); // onClick fn for each cell in the data spreadsheet body,
+  // adds the active cell highlight
+
+  var handleBodyCellClick = useCallback(function (cell, columnIndex) {
+    setActiveCellCoordinates({
+      row: cell.row.index,
+      column: columnIndex
+    });
+  }, [setActiveCellCoordinates]); // Renders each cell in the spreadsheet body
+
+  var RenderRow = useCallback(function (_ref2) {
+    var index = _ref2.index,
+        style = _ref2.style;
+    var row = rows[index];
+    prepareRow(row);
+    return /*#__PURE__*/React.createElement("div", _extends({}, row.getRowProps({
+      style: style
+    }), {
+      className: cx("".concat(blockClass, "__tr")),
+      "data-row-index": index
+    }), /*#__PURE__*/React.createElement("button", {
+      tabIndex: -1,
+      "data-row-index": index,
+      "data-column-index": "header",
+      type: "button",
+      className: cx("".concat(blockClass, "__td"), "".concat(blockClass, "__td-th"), "".concat(blockClass, "--interactive-cell-element")),
+      style: {
+        width: defaultColumn === null || defaultColumn === void 0 ? void 0 : defaultColumn.rowHeaderWidth
+      }
+    }, index + 1), row.cells.map(function (cell, index) {
+      return /*#__PURE__*/React.createElement("button", _extends({
+        tabIndex: -1,
+        "data-row-index": cell.row.index,
+        "data-column-index": index
+      }, cell.getCellProps(), {
+        className: cx("".concat(blockClass, "__td"), "".concat(blockClass, "--interactive-cell-element")),
+        key: "cell_".concat(index),
+        onClick: function onClick() {
+          return handleBodyCellClick(cell, index);
+        },
+        type: "button"
+      }), cell.render('Cell'));
+    }));
+  }, [prepareRow, rows, defaultColumn.rowHeaderWidth, handleBodyCellClick]);
+  var spreadsheetBodyRef = useRef();
+  return /*#__PURE__*/React.createElement("div", _extends({
+    ref: spreadsheetBodyRef,
+    className: cx("".concat(blockClass, "__body--container"))
+  }, getTableBodyProps()), /*#__PURE__*/React.createElement(FixedSizeList, {
+    className: cx("".concat(blockClass, "__list--container"), "".concat(blockClass, "__list--container--").concat(id)),
+    height: 400,
+    itemCount: rows.length,
+    itemSize: defaultColumn === null || defaultColumn === void 0 ? void 0 : defaultColumn.rowHeight,
+    width: totalColumnsWidth + scrollBarSize
+  }, RenderRow));
+};
+DataSpreadsheetBody.propTypes = {
+  /**
+   * Default spreadsheet sizing values
+   */
+  defaultColumn: PropTypes.shape({
+    rowHeight: PropTypes.number,
+    rowHeaderWidth: PropTypes.number,
+    width: PropTypes.number
+  }),
+
+  /**
+   * Function to set table body prop values
+   */
+  getTableBodyProps: PropTypes.func,
+
+  /**
+   * The spreadsheet id
+   */
+  id: PropTypes.oneOfType([PropTypes.number, PropTypes.string]),
+
+  /**
+   * The event handler that is called when the active cell changes
+   */
+  onActiveCellChange: PropTypes.func,
+
+  /**
+   * Prepare row function from react-table
+   */
+  prepareRow: PropTypes.func,
+
+  /**
+   * All of the spreadsheet row data
+   */
+  rows: PropTypes.arrayOf(PropTypes.object),
+
+  /**
+   * The scrollbar width
+   */
+  scrollBarSize: PropTypes.number,
+
+  /**
+   * Setter fn for activeCellCoordinates state value
+   */
+  setActiveCellCoordinates: PropTypes.func,
+
+  /**
+   * The total columns width
+   */
+  totalColumnsWidth: PropTypes.number
+};

package/es/components/DataSpreadsheet/DataSpreadsheetHeader.js

@@ -0,0 +1,64 @@
+import _extends from "@babel/runtime/helpers/extends";
+
+/**
+ * Copyright IBM Corp. 2022, 2022
+ *
+ * This source code is licensed under the Apache-2.0 license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+import React from 'react';
+import PropTypes from 'prop-types';
+import cx from 'classnames';
+import { pkg } from '../../settings';
+var blockClass = "".concat(pkg.prefix, "--data-spreadsheet");
+export var DataSpreadsheetHeader = function DataSpreadsheetHeader(_ref) {
+  var defaultColumn = _ref.defaultColumn,
+      headerGroups = _ref.headerGroups;
+  return /*#__PURE__*/React.createElement("div", {
+    className: cx("".concat(blockClass, "__header--container"))
+  }, headerGroups.map(function (headerGroup, index) {
+    return /*#__PURE__*/React.createElement("div", _extends({
+      key: "header_".concat(index)
+    }, headerGroup.getHeaderGroupProps(), {
+      className: "".concat(blockClass, "__tr")
+    }), /*#__PURE__*/React.createElement("button", {
+      "data-row-index": "header",
+      "data-column-index": "header",
+      type: "button",
+      tabIndex: -1,
+      className: cx("".concat(blockClass, "__th"), "".concat(blockClass, "--interactive-cell-element")),
+      style: {
+        width: defaultColumn === null || defaultColumn === void 0 ? void 0 : defaultColumn.rowHeaderWidth,
+        height: defaultColumn === null || defaultColumn === void 0 ? void 0 : defaultColumn.rowHeight
+      }
+    }, "\xA0"), headerGroup.headers.map(function (column, index) {
+      return /*#__PURE__*/React.createElement("button", _extends({
+        key: "column_".concat(index),
+        "data-row-index": "header",
+        "data-column-index": index,
+        tabIndex: -1,
+        style: {
+          height: defaultColumn === null || defaultColumn === void 0 ? void 0 : defaultColumn.rowHeight
+        }
+      }, column.getHeaderProps(), {
+        className: cx("".concat(blockClass, "__th"), "".concat(blockClass, "--interactive-cell-element")),
+        type: "button"
+      }), column.render('Header'));
+    }));
+  }));
+};
+DataSpreadsheetHeader.propTypes = {
+  /**
+   * Default spreadsheet sizing values
+   */
+  defaultColumn: PropTypes.shape({
+    rowHeight: PropTypes.number,
+    rowHeaderWidth: PropTypes.number,
+    width: PropTypes.number
+  }),
+
+  /**
+   * Headers provided from useTable hook
+   */
+  headerGroups: PropTypes.arrayOf(PropTypes.object)
+};