@carbon/ibm-products 1.56.0 → 1.58.0

package/lib/components/Checklist/Checklist.js

@@ -0,0 +1,267 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+var _typeof = require("@babel/runtime/helpers/typeof");
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.Checklist = void 0;
+var _extends2 = _interopRequireDefault(require("@babel/runtime/helpers/extends"));
+var _defineProperty2 = _interopRequireDefault(require("@babel/runtime/helpers/defineProperty"));
+var _slicedToArray2 = _interopRequireDefault(require("@babel/runtime/helpers/slicedToArray"));
+var _objectWithoutProperties2 = _interopRequireDefault(require("@babel/runtime/helpers/objectWithoutProperties"));
+var _react = _interopRequireWildcard(require("react"));
+var _propTypes = _interopRequireDefault(require("prop-types"));
+var _classnames = _interopRequireDefault(require("classnames"));
+var _devtools = require("../../global/js/utils/devtools");
+var _uuidv = _interopRequireDefault(require("../../global/js/utils/uuidv4"));
+var _settings = require("../../settings");
+var _carbonComponentsReact = require("carbon-components-react");
+var _iconsReact = require("@carbon/icons-react");
+var _ChecklistIcon = require("./ChecklistIcon");
+var _ChecklistChart = require("./ChecklistChart");
+var _excluded = ["chartValue", "chartLabel", "checklistAriaLabel", "checklistToggleAriaLabel", "className", "onClickViewAll", "onToggle", "open", "showToggle", "taskLists", "theme", "title", "viewAllLabel"];
+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; }
+// The block part of our conventional BEM class names (blockClass__E--M).
+var blockClass = "".concat(_settings.pkg.prefix, "--checklist");
+var componentName = 'Checklist';
+
+// NOTE: the component SCSS is not imported here: it is rolled up separately.
+
+// Default values can be included here and then assigned to the prop params,
+// e.g. prop = defaults.prop,
+// This gathers default values together neatly and ensures non-primitive
+// values are initialized early to avoid react making unnecessary re-renders.
+// Note that 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.
+
+// Default values for props
+var defaults = {
+  checklistAriaLabel: 'Checklist',
+  checklistToggleAriaLabel: 'Checklist toggle',
+  onClickViewAll: function onClickViewAll() {},
+  onToggle: function onToggle() {},
+  open: true,
+  showToggle: true,
+  taskLists: [],
+  theme: 'light'
+};
+
+/**
+ * TODO: A description of the component.
+ */
+var Checklist = /*#__PURE__*/_react.default.forwardRef(function (_ref, ref) {
+  var chartValue = _ref.chartValue,
+    chartLabel = _ref.chartLabel,
+    _ref$checklistAriaLab = _ref.checklistAriaLabel,
+    checklistAriaLabel = _ref$checklistAriaLab === void 0 ? defaults.checklistAriaLabel : _ref$checklistAriaLab,
+    _ref$checklistToggleA = _ref.checklistToggleAriaLabel,
+    checklistToggleAriaLabel = _ref$checklistToggleA === void 0 ? defaults.checklistToggleAriaLabel : _ref$checklistToggleA,
+    className = _ref.className,
+    _ref$onClickViewAll = _ref.onClickViewAll,
+    onClickViewAll = _ref$onClickViewAll === void 0 ? defaults.onClickViewAll : _ref$onClickViewAll,
+    _ref$onToggle = _ref.onToggle,
+    onToggle = _ref$onToggle === void 0 ? defaults.onToggle : _ref$onToggle,
+    _ref$open = _ref.open,
+    open = _ref$open === void 0 ? defaults.open : _ref$open,
+    _ref$showToggle = _ref.showToggle,
+    showToggle = _ref$showToggle === void 0 ? defaults.showToggle : _ref$showToggle,
+    _ref$taskLists = _ref.taskLists,
+    taskLists = _ref$taskLists === void 0 ? defaults.taskLists : _ref$taskLists,
+    _ref$theme = _ref.theme,
+    theme = _ref$theme === void 0 ? defaults.theme : _ref$theme,
+    title = _ref.title,
+    viewAllLabel = _ref.viewAllLabel,
+    rest = (0, _objectWithoutProperties2.default)(_ref, _excluded);
+  var _useState = (0, _react.useState)(open),
+    _useState2 = (0, _slicedToArray2.default)(_useState, 2),
+    isOpen = _useState2[0],
+    setIsOpen = _useState2[1];
+  var listContainerId = (0, _react.useRef)((0, _uuidv.default)()).current;
+  var chartLabelId = (0, _react.useRef)((0, _uuidv.default)()).current;
+
+  // Don't use this test: {chartValue && chartLabel && (render...)}.
+  // If `chartValue` is 0 (zero) - a valid value - then it will render 0 and skip the remaining statement.
+  // Use this test instead: {chartLabelAndValue && (render...)}.
+  // The ChecklistChart component will validate `chartValue`.
+  var chartLabelAndValue = typeof chartValue === 'number' && chartLabel;
+  var handleClickToggle = function handleClickToggle() {
+    setIsOpen(function (prevOpen) {
+      return !prevOpen;
+    });
+  };
+  var handleClickViewAll = function handleClickViewAll() {
+    onClickViewAll();
+  };
+
+  // If state changes, then trigger callback.
+  (0, _react.useEffect)(function () {
+    onToggle(isOpen);
+  }, [isOpen, onToggle]);
+
+  // If the "open" prop is changed after initialization,
+  // then update internal state.
+  (0, _react.useEffect)(function () {
+    setIsOpen(open);
+  }, [open]);
+  return /*#__PURE__*/_react.default.createElement("aside", (0, _extends2.default)({}, rest, {
+    "aria-label": checklistAriaLabel,
+    className: (0, _classnames.default)(blockClass,
+    // Apply the block class to the main HTML element
+    className, // Apply any supplied class names to the main HTML element.
+    // example: `${blockClass}__template-string-class-${kind}-n-${size}`,
+    (0, _defineProperty2.default)({}, "".concat(blockClass, "__closed"), !isOpen)),
+    ref: ref
+  }, (0, _devtools.getDevtoolsProps)(componentName)), (title || chartLabelAndValue) && /*#__PURE__*/_react.default.createElement("header", {
+    className: "".concat(blockClass, "__header")
+  }, chartLabelAndValue && /*#__PURE__*/_react.default.createElement(_ChecklistChart.ChecklistChart, {
+    ariaLabelledById: chartLabelId,
+    value: chartValue,
+    theme: theme
+  }), /*#__PURE__*/_react.default.createElement("div", {
+    className: "".concat(blockClass, "__titles")
+  }, title && /*#__PURE__*/_react.default.createElement("h2", {
+    className: "".concat(blockClass, "__title")
+  }, title), chartLabelAndValue && /*#__PURE__*/_react.default.createElement("h3", {
+    id: chartLabelId,
+    className: "".concat(blockClass, "__chart-label")
+  }, chartLabel)), showToggle && /*#__PURE__*/_react.default.createElement(_carbonComponentsReact.Button, {
+    "aria-controls": listContainerId,
+    "aria-expanded": isOpen,
+    "aria-label": checklistToggleAriaLabel,
+    className: "".concat(blockClass, "__toggle"),
+    kind: "ghost",
+    onClick: handleClickToggle,
+    size: "small"
+  }, /*#__PURE__*/_react.default.createElement(_iconsReact.ChevronUp16, {
+    className: (0, _classnames.default)("".concat(blockClass, "__chevron"))
+  }))), /*#__PURE__*/_react.default.createElement("div", {
+    id: listContainerId,
+    className: "".concat(blockClass, "__content-outer")
+  }, /*#__PURE__*/_react.default.createElement("div", {
+    className: "".concat(blockClass, "__content-inner")
+  }, /*#__PURE__*/_react.default.createElement("section", {
+    className: (0, _classnames.default)("".concat(blockClass, "__body"))
+  }, taskLists.map(function (list, index) {
+    return /*#__PURE__*/_react.default.createElement("div", {
+      className: "".concat(blockClass, "__list-group"),
+      key: "".concat(list.title, "-").concat(index)
+    }, list.title && /*#__PURE__*/_react.default.createElement("h3", {
+      title: list.title,
+      className: "".concat(blockClass, "__list-title")
+    }, list.title), /*#__PURE__*/_react.default.createElement("ol", {
+      className: "".concat(blockClass, "__list")
+    }, list.tasks.map(function (item, index) {
+      return /*#__PURE__*/_react.default.createElement("li", {
+        className: "".concat(blockClass, "__list-item"),
+        key: "".concat(item.label, "-").concat(index)
+      }, /*#__PURE__*/_react.default.createElement(_ChecklistIcon.ChecklistIcon, {
+        kind: item.kind
+      }), typeof item.onClick === 'function' ? /*#__PURE__*/_react.default.createElement(_carbonComponentsReact.Button, {
+        className: (0, _classnames.default)("".concat(blockClass, "__button"), (0, _defineProperty2.default)({}, "".concat(blockClass, "__button--error"), item.kind === 'error')),
+        onClick: function onClick() {
+          item.onClick(item);
+        },
+        size: "small"
+      }, /*#__PURE__*/_react.default.createElement("div", {
+        title: item.label
+      }, item.label)) : /*#__PURE__*/_react.default.createElement("span", {
+        className: (0, _classnames.default)("".concat(blockClass, "__label"), "".concat(blockClass, "__label--").concat(item.kind)),
+        title: item.label
+      }, item.label));
+    })));
+  })), viewAllLabel && /*#__PURE__*/_react.default.createElement("footer", {
+    className: "".concat(blockClass, "__footer")
+  }, /*#__PURE__*/_react.default.createElement(_carbonComponentsReact.Button, {
+    className: (0, _classnames.default)("".concat(blockClass, "__button"), "".concat(blockClass, "__view-all")),
+    onClick: handleClickViewAll,
+    size: "small"
+  }, /*#__PURE__*/_react.default.createElement("div", null, viewAllLabel))))));
+});
+
+// Return a placeholder if not released and not enabled by feature flag
+exports.Checklist = Checklist;
+exports.Checklist = Checklist = _settings.pkg.checkComponentEnabled(Checklist, componentName);
+
+// The display name of the component, used by React. Note that displayName
+// is used in preference to relying on function.name.
+Checklist.displayName = componentName;
+
+// The types and DocGen commentary for the component props,
+// in alphabetical order (for consistency).
+// See https://www.npmjs.com/package/prop-types#usage.
+Checklist.propTypes = {
+  /**
+   * Define both `chartLabel` and `chartValue` to show the chart and its label together.
+   */
+  chartLabel: _propTypes.default.string,
+  /**
+   * A number between 0 and 1.
+   *
+   * Define both `chartLabel` and `chartValue` to show the chart and its label together.
+   */
+  chartValue: _propTypes.default.number,
+  /**
+   * Aria-label for the Checklist component.
+   */
+  checklistAriaLabel: _propTypes.default.string,
+  /**
+   * Aria-label for the Checklist's toggle component.
+   */
+  checklistToggleAriaLabel: _propTypes.default.string,
+  /**
+   * Provide an optional class to be applied to the containing node.
+   */
+  className: _propTypes.default.string,
+  /**
+   * Callback for the "View all" button. See also `viewAllLabel`.
+   */
+  onClickViewAll: _propTypes.default.func,
+  /**
+   * Optional callback for when the list is opened/closed.
+   */
+  onToggle: _propTypes.default.func,
+  /**
+   * Specifies whether the component is opened or closed.
+   * This can be set during initialization, or changed after being rendered.
+   */
+  open: _propTypes.default.bool,
+  /**
+   * Whether or not to show the open/close toggle.
+   */
+  showToggle: _propTypes.default.bool,
+  /**
+   * The task list can be broken down into sub-lists.
+   *
+   * Each sub-list can include an optional `title`.
+   *
+   * Each task must specify the appropriate icon (`kind`) and `label`.
+   *
+   * If any task has an `onClick` callback function defined,
+   * then the `label` will be rendered as a button,
+   * else the `label` will be rendered as plain text.
+   */
+  taskLists: _propTypes.default.arrayOf(_propTypes.default.shape({
+    title: _propTypes.default.string,
+    tasks: _propTypes.default.arrayOf(_propTypes.default.shape({
+      kind: _propTypes.default.oneOf(['unchecked', 'indeterminate', 'checked', 'disabled', 'error']).isRequired,
+      label: _propTypes.default.string.isRequired,
+      onClick: _propTypes.default.func
+    })).isRequired
+  })).isRequired,
+  /**
+   * Determines the theme of the component.
+   */
+  theme: _propTypes.default.oneOf(['light', 'dark']),
+  /**
+   * The title of the component.
+   */
+  title: _propTypes.default.string,
+  /**
+   * If defined, will show and enable the "View all (#)" button at the bottom of the list.
+   */
+  viewAllLabel: _propTypes.default.string
+};

package/lib/components/Checklist/ChecklistChart.js

@@ -0,0 +1,94 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.ChecklistChart = void 0;
+var _extends2 = _interopRequireDefault(require("@babel/runtime/helpers/extends"));
+var _objectWithoutProperties2 = _interopRequireDefault(require("@babel/runtime/helpers/objectWithoutProperties"));
+var _react = _interopRequireDefault(require("react"));
+var _propTypes = _interopRequireDefault(require("prop-types"));
+var _classnames = _interopRequireDefault(require("classnames"));
+var _devtools = require("../../global/js/utils/devtools");
+var _settings = require("../../settings");
+var _clamp = _interopRequireDefault(require("lodash/clamp"));
+var _excluded = ["className", "ariaLabelledById", "value", "theme"];
+// Carbon and package components we use.
+/* TODO: @import(s) of carbon components and other package components. */
+
+// The block part of our conventional BEM class names (blockClass__E--M).
+var blockClass = "".concat(_settings.pkg.prefix, "--checklist__chart");
+var componentName = 'ChecklistChart';
+
+// NOTE: the component SCSS is not imported here: it is rolled up separately.
+
+// Default values can be included here and then assigned to the prop params,
+// e.g. prop = defaults.prop,
+// This gathers default values together neatly and ensures non-primitive
+// values are initialized early to avoid react making unnecessary re-renders.
+// Note that 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.
+
+// Default values for props
+var defaults = {
+  theme: 'light'
+};
+
+/**
+ * TODO: A description of the component.
+ */
+var ChecklistChart = /*#__PURE__*/_react.default.forwardRef(function (_ref, ref) {
+  var className = _ref.className,
+    ariaLabelledById = _ref.ariaLabelledById,
+    value = _ref.value,
+    _ref$theme = _ref.theme,
+    theme = _ref$theme === void 0 ? defaults.theme : _ref$theme,
+    rest = (0, _objectWithoutProperties2.default)(_ref, _excluded);
+  var numDegrees = (0, _clamp.default)(value * 360, 0, 360);
+  var circleColor = theme === 'light' ? '#c6c6c6' : '#525252'; // $gray-30, $gray-70
+  var progressColor = theme === 'light' ? '#6929c4' : '#A56EFF'; // $purple-70, $purple-50
+
+  return /*#__PURE__*/_react.default.createElement("div", (0, _extends2.default)({}, rest, {
+    "aria-labelledby": ariaLabelledById,
+    className: (0, _classnames.default)(blockClass, className),
+    style: {
+      backgroundImage: "conic-gradient(".concat(progressColor, " ").concat(numDegrees, "deg, ").concat(circleColor, " ").concat(numDegrees, "deg 360deg)"),
+      borderRadius: '50%'
+    },
+    ref: ref,
+    role: "img"
+  }, (0, _devtools.getDevtoolsProps)(componentName)));
+});
+
+// Return a placeholder if not released and not enabled by feature flag
+// ChecklistChart = pkg.checkComponentEnabled(ChecklistChart, componentName);
+
+// The display name of the component, used by React. Note that displayName
+// is used in preference to relying on function.name.
+// ChecklistChart.displayName = componentName;
+
+// The types and DocGen commentary for the component props,
+// in alphabetical order (for consistency).
+// See https://www.npmjs.com/package/prop-types#usage.
+exports.ChecklistChart = ChecklistChart;
+ChecklistChart.propTypes = {
+  /**
+   * Id of the parent's aria-label for accessibility.
+   */
+  ariaLabelledById: _propTypes.default.string.isRequired,
+  /**
+   * Optional class name for this component.
+   */
+  className: _propTypes.default.string,
+  /**
+   * Determines the theme of the component.
+   */
+  theme: _propTypes.default.oneOf(['light', 'dark']),
+  /**
+   * Number between 0 and 1.
+   */
+  value: _propTypes.default.number.isRequired
+};

package/lib/components/Checklist/ChecklistIcon.js

@@ -0,0 +1,92 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.ChecklistIcon = void 0;
+var _extends2 = _interopRequireDefault(require("@babel/runtime/helpers/extends"));
+var _objectWithoutProperties2 = _interopRequireDefault(require("@babel/runtime/helpers/objectWithoutProperties"));
+var _react = _interopRequireDefault(require("react"));
+var _propTypes = _interopRequireDefault(require("prop-types"));
+var _classnames = _interopRequireDefault(require("classnames"));
+var _devtools = require("../../global/js/utils/devtools");
+var _settings = require("../../settings");
+var _iconsReact = require("@carbon/icons-react");
+var _excluded = ["className", "kind", "theme"];
+// The block part of our conventional BEM class names (blockClass__E--M).
+var blockClass = "".concat(_settings.pkg.prefix, "--checklist__icon");
+var componentName = 'ChecklistIcon';
+
+// NOTE: the component SCSS is not imported here: it is rolled up separately.
+
+// Default values can be included here and then assigned to the prop params,
+// e.g. prop = defaults.prop,
+// This gathers default values together neatly and ensures non-primitive
+// values are initialized early to avoid react making unnecessary re-renders.
+// Note that 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.
+
+// Default values for props
+var defaults = {
+  theme: 'light'
+};
+
+/**
+ * TODO: A description of the component.
+ */
+var ChecklistIcon = /*#__PURE__*/_react.default.forwardRef(function (_ref, ref) {
+  var className = _ref.className,
+    kind = _ref.kind,
+    _ref$theme = _ref.theme,
+    theme = _ref$theme === void 0 ? defaults.theme : _ref$theme,
+    rest = (0, _objectWithoutProperties2.default)(_ref, _excluded);
+  var Icon;
+  switch (kind) {
+    case 'error':
+      Icon = _iconsReact.Warning16;
+      break;
+    case 'indeterminate':
+      Icon = _iconsReact.Incomplete16;
+      break;
+    case 'checked':
+      Icon = _iconsReact.CheckmarkOutline16;
+      break;
+    default:
+      // "unchecked" or "disabled"
+      Icon = _iconsReact.CircleDash16;
+      break;
+  }
+  return /*#__PURE__*/_react.default.createElement("span", (0, _extends2.default)({}, rest, {
+    className: (0, _classnames.default)(blockClass, className, "".concat(blockClass, "--").concat(kind), "".concat(blockClass, "__").concat(theme)),
+    ref: ref
+  }, (0, _devtools.getDevtoolsProps)(componentName)), /*#__PURE__*/_react.default.createElement(Icon, null));
+});
+
+// Return a placeholder if not released and not enabled by feature flag
+// ChecklistIcon = pkg.checkComponentEnabled(ChecklistIcon, componentName);
+
+// The display name of the component, used by React. Note that displayName
+// is used in preference to relying on function.name.
+// ChecklistIcon.displayName = componentName;
+
+// The types and DocGen commentary for the component props,
+// in alphabetical order (for consistency).
+// See https://www.npmjs.com/package/prop-types#usage.
+exports.ChecklistIcon = ChecklistIcon;
+ChecklistIcon.propTypes = {
+  /**
+   * Provide an optional class to be applied to the containing node.
+   */
+  className: _propTypes.default.string,
+  /**
+   * The icon to be displayed.
+   */
+  kind: _propTypes.default.oneOf(['unchecked', 'indeterminate', 'checked', 'disabled', 'error']),
+  /**
+   * Determines the theme of the component.
+   */
+  theme: _propTypes.default.oneOf(['light', 'dark'])
+};

package/lib/components/Checklist/index.js

@@ -0,0 +1,12 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+Object.defineProperty(exports, "Checklist", {
+  enumerable: true,
+  get: function get() {
+    return _Checklist.Checklist;
+  }
+});
+var _Checklist = require("./Checklist");

package/lib/components/Datagrid/Datagrid/Datagrid.js

@@ -16,11 +16,12 @@ var _pconsole = _interopRequireDefault(require("../../../global/js/utils/pconsol
 var _InlineEditContext = require("./addons/InlineEdit/InlineEditContext");
 var _DatagridContent = require("./DatagridContent");
 var _FilterProvider = require("./addons/Filtering/FilterProvider");
-var _excluded = ["datagridState"];
+var _excluded = ["datagridState", "title"];
 var blockClass = "".concat(_settings.pkg.prefix, "--datagrid");
 var componentName = 'Datagrid';
 var Datagrid = /*#__PURE__*/_react.default.forwardRef(function (_ref, ref) {
   var datagridState = _ref.datagridState,
+    title = _ref.title,
     rest = (0, _objectWithoutProperties2.default)(_ref, _excluded);
   if (!datagridState) {
     _pconsole.default.warn('Datagrid was not passed datagridState which is required to render this component.');
@@ -34,6 +35,10 @@ var Datagrid = /*#__PURE__*/_react.default.forwardRef(function (_ref, ref) {
     className = datagridState.className,
     filters = datagridState.state.filters;
   var rows = DatagridPagination && datagridState.page || datagridState.rows;
+  var props = {
+    title: title,
+    datagridState: datagridState
+  };
   return /*#__PURE__*/_react.default.createElement(_FilterProvider.FilterProvider, {
     filters: filters
   }, /*#__PURE__*/_react.default.createElement(_InlineEditContext.InlineEditProvider, null, /*#__PURE__*/_react.default.createElement("div", (0, _extends2.default)({}, rest, {
@@ -42,11 +47,7 @@ var Datagrid = /*#__PURE__*/_react.default.forwardRef(function (_ref, ref) {
     className: (0, _classnames.default)(className, blockClass, withVirtualScroll ? "".concat(blockClass, "__datagridWrap") : "".concat(blockClass, "__datagridWrap-simple"), !isFetching && rows.length === 0 ? "".concat(blockClass, "__empty-state") : '')
   }, (0, _devtools.getDevtoolsProps)(componentName)), (filterProps === null || filterProps === void 0 ? void 0 : filterProps.variation) === 'panel' ? /*#__PURE__*/_react.default.createElement("div", {
     className: "".concat(blockClass, "__datagridWithPanel ").concat(blockClass, "__displayFlex ").concat(blockClass, "__leftPanel-position")
-  }, /*#__PURE__*/_react.default.createElement(_DatagridContent.DatagridContent, {
-    datagridState: datagridState
-  })) : /*#__PURE__*/_react.default.createElement(_DatagridContent.DatagridContent, {
-    datagridState: datagridState
-  }))));
+  }, /*#__PURE__*/_react.default.createElement(_DatagridContent.DatagridContent, props)) : /*#__PURE__*/_react.default.createElement(_DatagridContent.DatagridContent, props))));
 });
 
 // Return a placeholder if not released and not enabled by feature flag
@@ -60,5 +61,9 @@ Datagrid.propTypes = {
   /**
    * The data grid state, much of it being supplied by the useDatagrid hook
    */
-  datagridState: _propTypes.default.object.isRequired
+  datagridState: _propTypes.default.object.isRequired,
+  /**
+   * Table title
+   */
+  title: _propTypes.default.string
 };

package/lib/components/Datagrid/Datagrid/DatagridContent.js

@@ -40,7 +40,8 @@ var TableContainer = _carbonComponentsReact.DataTable.TableContainer,
 var blockClass = "".concat(_settings.pkg.prefix, "--datagrid");
 var DatagridContent = function DatagridContent(_ref) {
   var _cx4;
-  var datagridState = _ref.datagridState;
+  var datagridState = _ref.datagridState,
+    title = _ref.title;
   var _useContext = (0, _react.useContext)(_InlineEditContext.InlineEditContext),
     inlineEditState = _useContext.state,
     dispatch = _useContext.dispatch;
@@ -108,7 +109,8 @@ var DatagridContent = function DatagridContent(_ref) {
       } : null,
       onFocus: withInlineEdit ? function () {
         return (0, _handleGridFocus.handleGridFocus)(inlineEditState, dispatch);
-      } : null
+      } : null,
+      title: title
     }), !withVirtualScroll ? /*#__PURE__*/_react.default.createElement(_DatagridHead.default, datagridState) : null, /*#__PURE__*/_react.default.createElement(_DatagridBody.default, (0, _extends2.default)({}, datagridState, {
       rows: rows
     })));
@@ -191,5 +193,6 @@ DatagridContent.propTypes = {
     setAllFilters: _propTypes.default.func,
     getFilterProps: _propTypes.default.func,
     state: _propTypes.default.object
-  })
+  }),
+  title: _propTypes.default.string
 };