@itwin/itwinui-react 3.17.4 → 3.18.1

package/esm/core/Table/Table.js

@@ -23,6 +23,7 @@ import {
   useMergedRefs,
   useLatestRef,
   useVirtualScroll,
+  useId,
 } from '../../utils/index.js';
 import { TableInstanceContext } from './utils.js';
 import { TableRowMemoized } from './TableRowMemoized.js';
@@ -49,6 +50,7 @@ import {
 import { SELECTION_CELL_ID } from './columns/index.js';
 import { ColumnHeader } from './ColumnHeader.js';
 import { TableExpandableContentMemoized } from './TableExpandableContentMemoized.js';
+import { VisuallyHidden } from '../VisuallyHidden/VisuallyHidden.js';
 let singleRowSelectedAction = 'singleRowSelected';
 let shiftRowSelectedAction = 'shiftRowSelected';
 export const tableResizeStartAction = 'tableResizeStart';
@@ -105,10 +107,45 @@ export 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]);
   useGlobals();
   let ownerDocument = React.useRef(void 0);
   let defaultColumn = React.useMemo(
@@ -320,16 +357,21 @@ export const Table = (props) => {
   } = instance;
   let headerGroups = _headerGroups;
   let logWarning = useWarningLogger();
-  if (1 === columns.length && 'columns' in columns[0])
+  if (1 === columns.length && 'columns' in columns[0]) {
     headerGroups = _headerGroups.slice(1);
-  let ariaDataAttributes = Object.entries(rest).reduce(
-    (result, [key, value]) => {
-      if (key.startsWith('data-') || key.startsWith('aria-'))
-        result[key] = value;
-      return result;
-    },
-    {},
-  );
+    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 (
+    '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 areFiltersSet =
     allColumns.some(
       (column) => null != column.filterValue && '' !== column.filterValue,
@@ -344,7 +386,7 @@ export const Table = (props) => {
         !isDisabled &&
         selectRowOnClick &&
         !event.isDefaultPrevented()
-      ) {
+      )
         if ('multi' === selectionMode && event.shiftKey)
           dispatch({
             type: shiftRowSelectedAction,
@@ -358,7 +400,6 @@ export const Table = (props) => {
             type: singleRowSelectedAction,
             id: row.id,
           });
-      }
     },
     [
       isRowDisabled,
@@ -417,6 +458,7 @@ export const Table = (props) => {
   let tableRef = React.useRef(null);
   let { scrollToIndex, tableRowRef } = useScrollToRow({
     ...props,
+    scrollToRow,
     page,
   });
   let columnRefs = React.useRef({});
@@ -559,6 +601,7 @@ export const Table = (props) => {
   React.useEffect(() => {
     updateStickyState();
   }, []);
+  let captionId = useId();
   return React.createElement(
     TableInstanceContext.Provider,
     {
@@ -582,10 +625,46 @@ export const Table = (props) => {
             ...style,
           },
         }),
+        role: role,
+        'aria-labelledby': captionId,
         onScroll: () => updateStickyState(),
         'data-iui-size': 'default' === density ? void 0 : density,
-        ...ariaDataAttributes,
+        ...outerAriaRestAttributes,
+        ...nonAriaRestAttributes,
       },
+      React.createElement(
+        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,
+        {
+          slot: 'caption',
+          id: captionId,
+        },
+        caption,
+      ),
       headerGroups.map((headerGroup) => {
         headerGroup.headers = headerGroup.headers.filter(
           (header) =>
@@ -598,6 +677,7 @@ export const Table = (props) => {
         return React.createElement(
           Box,
           {
+            slot: 'iui-table-header-wrapper',
             as: 'div',
             key: headerGroupProps.key,
             ...headerWrapperProps,
@@ -650,6 +730,7 @@ export const Table = (props) => {
       React.createElement(
         Box,
         {
+          slot: 'iui-table-body',
           as: 'div',
           ...bodyProps,
           ...getTableBodyProps({
@@ -661,13 +742,13 @@ export const Table = (props) => {
               bodyProps?.className,
             ),
           }),
-          'aria-multiselectable':
-            (isSelectable && 'multi' === selectionMode) || void 0,
+          role: void 0,
         },
         React.createElement(
           ShadowRoot,
           {
             css: virtualizerCss,
+            flush: false,
           },
           enableVirtualization && 0 !== data.length
             ? React.createElement(
@@ -694,59 +775,49 @@ export const Table = (props) => {
                   )
               : page.map((_, index) => getPreparedRow(index)),
           ),
-        isLoading &&
-          0 === data.length &&
+      ),
+      isLoading &&
+        0 === data.length &&
+        React.createElement(
+          TableBodyExtraWrapper,
+          null,
           React.createElement(
-            Box,
-            {
-              as: 'div',
-              ...emptyTableContentProps,
-              className: cx(
-                'iui-table-empty',
-                emptyTableContentProps?.className,
-              ),
-            },
+            TableEmptyWrapper,
+            emptyTableContentProps,
             React.createElement(ProgressRadial, {
               indeterminate: true,
             }),
           ),
-        !isLoading &&
-          0 === data.length &&
-          !areFiltersSet &&
+        ),
+      !isLoading &&
+        0 === data.length &&
+        !areFiltersSet &&
+        React.createElement(
+          TableBodyExtraWrapper,
+          null,
           React.createElement(
-            Box,
-            {
-              as: 'div',
-              ...emptyTableContentProps,
-              className: cx(
-                '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(
-            Box,
-            {
-              as: 'div',
-              ...emptyTableContentProps,
-              className: cx(
-                'iui-table-empty',
-                emptyTableContentProps?.className,
-              ),
-            },
+            TableEmptyWrapper,
+            emptyTableContentProps,
             React.createElement('div', null, emptyFilteredTableContent),
           ),
-      ),
+        ),
       isLoading &&
         0 !== data.length &&
         React.createElement(
-          Box,
+          TableBodyExtraWrapper,
           {
-            className: 'iui-table-body-extra',
             'data-iui-loading': 'true',
           },
           React.createElement(ProgressRadial, {
@@ -758,3 +829,31 @@ export const Table = (props) => {
     ),
   );
 };
+if ('development' === process.env.NODE_ENV) Table.displayName = 'Table';
+let TableBodyExtraWrapper = React.forwardRef((props, ref) => {
+  let { children, ...rest } = props;
+  return React.createElement(
+    Box,
+    {
+      as: 'div',
+      ref: ref,
+      slot: 'iui-table-body-extra',
+      ...rest,
+      className: cx('iui-table-body-extra', rest.className),
+    },
+    children,
+  );
+});
+let TableEmptyWrapper = React.forwardRef((props, ref) => {
+  let { children, ...rest } = props;
+  return React.createElement(
+    Box,
+    {
+      as: 'div',
+      ref: ref,
+      ...rest,
+      className: cx('iui-table-empty', rest.className),
+    },
+    children,
+  );
+});

package/esm/core/Table/TableCell.js

@@ -35,10 +35,12 @@ export 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/esm/core/Table/actionHandlers/expandHandler.js

@@ -1,8 +1,6 @@
 export 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/esm/core/Table/actionHandlers/selectHandler.js

@@ -1,9 +1,6 @@
 import { iuiId } from '../Table.js';
 let 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/esm/core/Table/cells/DefaultCell.js

@@ -47,29 +47,31 @@ export const DefaultCell = (props) => {
       ShadowRoot,
       {
         key: `${cellElementKey}-shadow-root`,
+        flush: false,
+        css: css,
       },
       React.createElement('slot', {
         name: 'start',
-        key: `${cellElementKey}-shadow-root-start`,
       }),
-      clamp
-        ? React.createElement(
-            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(
+              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 &&
@@ -95,3 +97,18 @@ export const DefaultCell = (props) => {
       ),
   );
 };
+if ('development' === process.env.NODE_ENV)
+  DefaultCell.displayName = 'DefaultCell';
+let 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/esm/core/Table/cells/EditableCell.js

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

package/esm/core/Table/columns/expanderColumn.js

@@ -17,24 +17,23 @@ export const ExpanderColumn = (props = {}) => {
     cellClassName: 'iui-slot',
     Cell: (props) => {
       let { row } = props;
-      if (subComponent?.(row))
-        return React.createElement(
-          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,
+        {
+          'aria-label': 'Toggle expandable content',
+          className: 'iui-table-row-expander',
+          styleType: 'borderless',
+          size: 'small',
+          onClick: (e) => {
+            e.stopPropagation();
+            row.toggleRowExpanded();
           },
-          React.createElement(SvgChevronRight, null),
-        );
-      return null;
+          disabled: isDisabled?.(props.row.original),
+          'aria-expanded': row.isExpanded,
+        },
+        React.createElement(SvgChevronRight, null),
+      );
     },
     cellRenderer: (props) =>
       React.createElement(DefaultCell, {

package/esm/core/Table/columns/selectionColumn.js

@@ -32,6 +32,7 @@ export const SelectionColumn = (props = {}) => {
       );
       let indeterminate =
         !checked && Object.keys(state.selectedRowIds).length > 0;
+      let nextToggleState = !rows.some((row) => row.isSelected);
       return React.createElement(Checkbox, {
         ...getToggleAllRowsSelectedProps(),
         style: {},
@@ -39,8 +40,8 @@ export 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 }) =>
@@ -50,6 +51,7 @@ export 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 &&

package/esm/core/Tabs/Tabs.d.ts

@@ -52,12 +52,21 @@ type TabsWrapperOwnProps = {
      */
     defaultChecked?: never;
 } & TabsOrientationProps;
+type TabsWrapperPresentationOwnProps = {
+    orientation?: 'horizontal' | 'vertical';
+};
 type TabListOwnProps = {
     /**
      * Tab items.
      */
     children: React.ReactNode[];
 };
+type TabListPresentationOwnProps = {
+    type?: 'default' | 'borderless' | 'pill';
+    color?: 'blue' | 'green';
+    orientation?: 'horizontal' | 'vertical';
+    size?: 'default' | 'large';
+};
 type TabOwnProps = {
     /**
      * Value used to associate the tab with a given panel.
@@ -293,3 +302,31 @@ export declare const Tabs: PolymorphicForwardRefComponent<"div", TabsLegacyProps
      */
     Panel: PolymorphicForwardRefComponent<"div", TabsPanelOwnProps>;
 };
+/**
+ * Presentational version of `Tabs`. It renders purely static elements, without any associated behaviors.
+ */
+export declare const unstable_TabsPresentation: {
+    Wrapper: PolymorphicForwardRefComponent<"div", TabsWrapperPresentationOwnProps>;
+    /**
+     * This could be used with `role="list"` or `role="tablist"`.
+     */
+    TabList: PolymorphicForwardRefComponent<"div", TabListPresentationOwnProps>;
+    /**
+     * This renders a button without any role by default. The rendered element can be changed using the `as` prop
+     * (e.g. `as="a"` or `as="div"`)
+     *
+     * When _not_ using `role="tab"`, the selected state can be set using `aria-current="true"` (or `aria-current="page"`).
+     *
+     * When using `role="tab"`, the selected state can be set using `aria-selected="true"`.
+     *
+     * Example:
+     * ```jsx
+     * <TabsPresentation.Tab
+     *   as="a"
+     *   href=""
+     *   aria-current="true"
+     * />
+     * ```
+     */
+    Tab: PolymorphicForwardRefComponent<"button", {}>;
+};