@itwin/itwinui-react 3.17.4 → 3.18.1

package/DEV-cjs/core/Table/Table.js

@@ -37,6 +37,7 @@ const _index2 = require('./actionHandlers/index.js');
 const _index3 = require('./columns/index.js');
 const _ColumnHeader = require('./ColumnHeader.js');
 const _TableExpandableContentMemoized = require('./TableExpandableContentMemoized.js');
+const _VisuallyHidden = require('../VisuallyHidden/VisuallyHidden.js');
 const singleRowSelectedAction = 'singleRowSelected';
 const shiftRowSelectedAction = 'shiftRowSelected';
 const tableResizeStartAction = 'tableResizeStart';
@@ -93,10 +94,45 @@ const Table = (props) => {
     headerWrapperProps,
     headerProps,
     bodyProps,
+    tableProps,
     emptyTableContentProps,
     getRowId,
-    ...rest
+    caption = 'Table',
+    role,
+    scrollToRow,
+    ..._rest
   } = props;
+  let { ariaRestAttributes, nonAriaRestAttributes } = _react.useMemo(
+    () =>
+      Object.entries(_rest).reduce(
+        (result, [key, value]) => {
+          if (key.startsWith('aria-')) result.ariaRestAttributes[key] = value;
+          else result.nonAriaRestAttributes[key] = value;
+          return result;
+        },
+        {
+          ariaRestAttributes: {},
+          nonAriaRestAttributes: {},
+        },
+      ),
+    [_rest],
+  );
+  let { outerAriaRestAttributes, innerAriaRestAttributes } =
+    _react.useMemo(() => {
+      if (tableProps || role)
+        return {
+          outerAriaRestAttributes: {
+            ...ariaRestAttributes,
+          },
+          innerAriaRestAttributes: {},
+        };
+      return {
+        outerAriaRestAttributes: {},
+        innerAriaRestAttributes: {
+          ...ariaRestAttributes,
+        },
+      };
+    }, [ariaRestAttributes, role, tableProps]);
   (0, _index.useGlobals)();
   let ownerDocument = _react.useRef(void 0);
   let defaultColumn = _react.useMemo(
@@ -317,22 +353,19 @@ const Table = (props) => {
   let logWarning = (0, _index.useWarningLogger)();
   if (1 === columns.length && 'columns' in columns[0]) {
     headerGroups = _headerGroups.slice(1);
-    logWarning(
-      "Table's `columns` prop should not have a top-level `Header` or sub-columns. They are only allowed to be passed for backwards compatibility.\n See https://github.com/iTwin/iTwinUI/wiki/iTwinUI-react-v2-migration-guide#breaking-changes",
-    );
+    if ('development' === process.env.NODE_ENV)
+      logWarning(
+        "Table's `columns` prop should not have a top-level `Header` or sub-columns. They are only allowed to be passed for backwards compatibility.\n See https://github.com/iTwin/iTwinUI/wiki/iTwinUI-react-v2-migration-guide#breaking-changes",
+      );
   }
-  if (subComponent && data.some((item) => !!item.subRows?.length))
+  if (
+    'development' === process.env.NODE_ENV &&
+    subComponent &&
+    data.some((item) => !!item.subRows?.length)
+  )
     logWarning(
       'Passing both `subComponent` and `data` with `subRows` is not supported. There are features designed for `subRows` that are not compatible with `subComponent` and vice versa.',
     );
-  let ariaDataAttributes = Object.entries(rest).reduce(
-    (result, [key, value]) => {
-      if (key.startsWith('data-') || key.startsWith('aria-'))
-        result[key] = value;
-      return result;
-    },
-    {},
-  );
   let areFiltersSet =
     allColumns.some(
       (column) => null != column.filterValue && '' !== column.filterValue,
@@ -347,7 +380,7 @@ const Table = (props) => {
         !isDisabled &&
         selectRowOnClick &&
         !event.isDefaultPrevented()
-      ) {
+      )
         if ('multi' === selectionMode && event.shiftKey)
           dispatch({
             type: shiftRowSelectedAction,
@@ -361,7 +394,6 @@ const Table = (props) => {
             type: singleRowSelectedAction,
             id: row.id,
           });
-      }
     },
     [
       isRowDisabled,
@@ -420,6 +452,7 @@ const Table = (props) => {
   let tableRef = _react.useRef(null);
   let { scrollToIndex, tableRowRef } = (0, _index1.useScrollToRow)({
     ...props,
+    scrollToRow,
     page,
   });
   let columnRefs = _react.useRef({});
@@ -562,6 +595,7 @@ const Table = (props) => {
   _react.useEffect(() => {
     updateStickyState();
   }, []);
+  let captionId = (0, _index.useId)();
   return _react.createElement(
     _utils.TableInstanceContext.Provider,
     {
@@ -585,10 +619,46 @@ const Table = (props) => {
             ...style,
           },
         }),
+        role: role,
+        'aria-labelledby': captionId,
         onScroll: () => updateStickyState(),
         'data-iui-size': 'default' === density ? void 0 : density,
-        ...ariaDataAttributes,
+        ...outerAriaRestAttributes,
+        ...nonAriaRestAttributes,
       },
+      _react.createElement(
+        _index.ShadowRoot,
+        null,
+        _react.createElement(
+          'div',
+          {
+            role: 'table',
+            ...innerAriaRestAttributes,
+            ...tableProps,
+          },
+          _react.createElement('slot', {
+            name: 'caption',
+          }),
+          _react.createElement('slot', {
+            name: 'iui-table-header-wrapper',
+          }),
+          _react.createElement('slot', {
+            name: 'iui-table-body',
+          }),
+        ),
+        _react.createElement('slot', {
+          name: 'iui-table-body-extra',
+        }),
+        _react.createElement('slot', null),
+      ),
+      _react.createElement(
+        _VisuallyHidden.VisuallyHidden,
+        {
+          slot: 'caption',
+          id: captionId,
+        },
+        caption,
+      ),
       headerGroups.map((headerGroup) => {
         headerGroup.headers = headerGroup.headers.filter(
           (header) =>
@@ -601,6 +671,7 @@ const Table = (props) => {
         return _react.createElement(
           _index.Box,
           {
+            slot: 'iui-table-header-wrapper',
             as: 'div',
             key: headerGroupProps.key,
             ...headerWrapperProps,
@@ -656,6 +727,7 @@ const Table = (props) => {
       _react.createElement(
         _index.Box,
         {
+          slot: 'iui-table-body',
           as: 'div',
           ...bodyProps,
           ...getTableBodyProps({
@@ -667,13 +739,13 @@ const Table = (props) => {
               bodyProps?.className,
             ),
           }),
-          'aria-multiselectable':
-            (isSelectable && 'multi' === selectionMode) || void 0,
+          role: void 0,
         },
         _react.createElement(
           _index.ShadowRoot,
           {
             css: virtualizerCss,
+            flush: false,
           },
           enableVirtualization && 0 !== data.length
             ? _react.createElement(
@@ -700,59 +772,49 @@ const Table = (props) => {
                   )
               : page.map((_, index) => getPreparedRow(index)),
           ),
-        isLoading &&
-          0 === data.length &&
+      ),
+      isLoading &&
+        0 === data.length &&
+        _react.createElement(
+          TableBodyExtraWrapper,
+          null,
           _react.createElement(
-            _index.Box,
-            {
-              as: 'div',
-              ...emptyTableContentProps,
-              className: (0, _classnames.default)(
-                'iui-table-empty',
-                emptyTableContentProps?.className,
-              ),
-            },
+            TableEmptyWrapper,
+            emptyTableContentProps,
             _react.createElement(_ProgressRadial.ProgressRadial, {
               indeterminate: true,
             }),
           ),
-        !isLoading &&
-          0 === data.length &&
-          !areFiltersSet &&
+        ),
+      !isLoading &&
+        0 === data.length &&
+        !areFiltersSet &&
+        _react.createElement(
+          TableBodyExtraWrapper,
+          null,
           _react.createElement(
-            _index.Box,
-            {
-              as: 'div',
-              ...emptyTableContentProps,
-              className: (0, _classnames.default)(
-                'iui-table-empty',
-                emptyTableContentProps?.className,
-              ),
-            },
+            TableEmptyWrapper,
+            emptyTableContentProps,
             _react.createElement('div', null, emptyTableContent),
           ),
-        !isLoading &&
-          (0 === data.length || 0 === rows.length) &&
-          areFiltersSet &&
+        ),
+      !isLoading &&
+        (0 === data.length || 0 === rows.length) &&
+        areFiltersSet &&
+        _react.createElement(
+          TableBodyExtraWrapper,
+          null,
           _react.createElement(
-            _index.Box,
-            {
-              as: 'div',
-              ...emptyTableContentProps,
-              className: (0, _classnames.default)(
-                'iui-table-empty',
-                emptyTableContentProps?.className,
-              ),
-            },
+            TableEmptyWrapper,
+            emptyTableContentProps,
             _react.createElement('div', null, emptyFilteredTableContent),
           ),
-      ),
+        ),
       isLoading &&
         0 !== data.length &&
         _react.createElement(
-          _index.Box,
+          TableBodyExtraWrapper,
           {
-            className: 'iui-table-body-extra',
             'data-iui-loading': 'true',
           },
           _react.createElement(_ProgressRadial.ProgressRadial, {
@@ -764,4 +826,34 @@ const Table = (props) => {
     ),
   );
 };
-Table.displayName = 'Table';
+if ('development' === process.env.NODE_ENV) Table.displayName = 'Table';
+const TableBodyExtraWrapper = _react.forwardRef((props, ref) => {
+  let { children, ...rest } = props;
+  return _react.createElement(
+    _index.Box,
+    {
+      as: 'div',
+      ref: ref,
+      slot: 'iui-table-body-extra',
+      ...rest,
+      className: (0, _classnames.default)(
+        'iui-table-body-extra',
+        rest.className,
+      ),
+    },
+    children,
+  );
+});
+const TableEmptyWrapper = _react.forwardRef((props, ref) => {
+  let { children, ...rest } = props;
+  return _react.createElement(
+    _index.Box,
+    {
+      as: 'div',
+      ref: ref,
+      ...rest,
+      className: (0, _classnames.default)('iui-table-empty', rest.className),
+    },
+    children,
+  );
+});

package/DEV-cjs/core/Table/TableCell.js

@@ -56,10 +56,12 @@ const TableCell = (props) => {
   });
   let cellProps = {
     ...tableInstance,
-    cell,
-    row: cell.row,
-    value: cell.value,
-    column: cell.column,
+    ...{
+      cell,
+      row: cell.row,
+      value: cell.value,
+      column: cell.column,
+    },
   };
   let cellContent = _react.createElement(
     _react.Fragment,

package/DEV-cjs/core/Table/actionHandlers/expandHandler.js

@@ -9,10 +9,8 @@ Object.defineProperty(exports, 'onExpandHandler', {
   },
 });
 const onExpandHandler = (newState, instance, onExpand) => {
-  if (!instance?.preFilteredFlatRows.length) {
-    onExpand?.([], newState);
-    return;
-  }
+  if (!instance?.preFilteredFlatRows.length)
+    return void onExpand?.([], newState);
   let expandedData = [];
   instance.preFilteredFlatRows.forEach((row) => {
     if (newState.expanded[row.id]) expandedData.push(row.original);

package/DEV-cjs/core/Table/actionHandlers/selectHandler.js

@@ -22,10 +22,7 @@ _export(exports, {
 });
 const _Table = require('../Table.js');
 const onSelectHandler = (newState, instance, onSelect, isRowDisabled) => {
-  if (!instance?.rows.length) {
-    onSelect?.([], newState);
-    return;
-  }
+  if (!instance?.rows.length) return void onSelect?.([], newState);
   let newSelectedRowIds = {};
   let handleRow = (row) => {
     if (isRowDisabled?.(row.original)) return false;

package/DEV-cjs/core/Table/cells/DefaultCell.js

@@ -61,29 +61,31 @@ const DefaultCell = (props) => {
       _index.ShadowRoot,
       {
         key: `${cellElementKey}-shadow-root`,
+        flush: false,
+        css: css,
       },
       _react.createElement('slot', {
         name: 'start',
-        key: `${cellElementKey}-shadow-root-start`,
       }),
-      clamp
-        ? _react.createElement(
-            _index.LineClamp,
-            {
-              key: `${cellElementKey}-shadow-root-slot`,
-            },
-            _react.createElement('slot', null),
-          )
-        : _react.createElement('slot', {
-            key: `${cellElementKey}-shadow-root-slot`,
-          }),
+      _react.createElement(
+        'div',
+        {
+          className: '_iui-table-cell-main-content',
+          onClick: (e) => e.stopPropagation(),
+        },
+        clamp
+          ? _react.createElement(
+              _index.LineClamp,
+              null,
+              _react.createElement('slot', null),
+            )
+          : _react.createElement('slot', null),
+      ),
       _react.createElement('slot', {
         name: 'end',
-        key: `${cellElementKey}-shadow-root-end`,
       }),
       _react.createElement('slot', {
         name: 'shadows',
-        key: `${cellElementKey}-shadow-root-shadows`,
       }),
     ),
     startIcon &&
@@ -109,4 +111,18 @@ const DefaultCell = (props) => {
       ),
   );
 };
-DefaultCell.displayName = 'DefaultCell';
+if ('development' === process.env.NODE_ENV)
+  DefaultCell.displayName = 'DefaultCell';
+const css = `
+._iui-table-cell-main-content {
+  position: relative;
+  isolation: isolate;
+}
+._iui-table-cell-main-content::before {
+  content: '';
+  display: block;
+  position: absolute;
+  inset: -6px;
+  z-index: -1;
+}
+`;

package/DEV-cjs/core/Table/cells/EditableCell.js

@@ -88,4 +88,5 @@ const EditableCell = (props) => {
     children,
   );
 };
-EditableCell.displayName = 'EditableCell';
+if ('development' === process.env.NODE_ENV)
+  EditableCell.displayName = 'EditableCell';

package/DEV-cjs/core/Table/columns/expanderColumn.js

@@ -37,24 +37,23 @@ const ExpanderColumn = (props = {}) => {
     cellClassName: 'iui-slot',
     Cell: (props) => {
       let { row } = props;
-      if (subComponent?.(row))
-        return _react.createElement(
-          _IconButton.IconButton,
-          {
-            'aria-label': 'Toggle expandable content',
-            className: 'iui-table-row-expander',
-            styleType: 'borderless',
-            size: 'small',
-            onClick: (e) => {
-              e.stopPropagation();
-              row.toggleRowExpanded();
-            },
-            disabled: isDisabled?.(props.row.original),
-            'aria-expanded': row.isExpanded,
+      if (!subComponent?.(row)) return null;
+      return _react.createElement(
+        _IconButton.IconButton,
+        {
+          'aria-label': 'Toggle expandable content',
+          className: 'iui-table-row-expander',
+          styleType: 'borderless',
+          size: 'small',
+          onClick: (e) => {
+            e.stopPropagation();
+            row.toggleRowExpanded();
           },
-          _react.createElement(_index.SvgChevronRight, null),
-        );
-      return null;
+          disabled: isDisabled?.(props.row.original),
+          'aria-expanded': row.isExpanded,
+        },
+        _react.createElement(_index.SvgChevronRight, null),
+      );
     },
     cellRenderer: (props) =>
       _react.createElement(_index1.DefaultCell, {

package/DEV-cjs/core/Table/columns/selectionColumn.js

@@ -52,6 +52,7 @@ const SelectionColumn = (props = {}) => {
       );
       let indeterminate =
         !checked && Object.keys(state.selectedRowIds).length > 0;
+      let nextToggleState = !rows.some((row) => row.isSelected);
       return _react.createElement(_Checkbox.Checkbox, {
         ...getToggleAllRowsSelectedProps(),
         style: {},
@@ -59,8 +60,8 @@ const SelectionColumn = (props = {}) => {
         checked: checked && !disabled,
         indeterminate: indeterminate,
         disabled: disabled,
-        onChange: () =>
-          toggleAllRowsSelected(!rows.some((row) => row.isSelected)),
+        'aria-label': `${nextToggleState ? 'Select' : 'Deselect'} all rows`,
+        onChange: () => toggleAllRowsSelected(nextToggleState),
       });
     },
     Cell: ({ row, selectSubRows = true }) =>
@@ -70,6 +71,7 @@ const SelectionColumn = (props = {}) => {
         title: '',
         disabled: isDisabled?.(row.original),
         onClick: (e) => e.stopPropagation(),
+        'aria-label': `${row.isSelected ? 'Deselect' : 'Select'} row`,
         onChange: () => {
           if (
             row.subRows.length > 0 &&