@itwin/itwinui-react 3.11.3 → 3.12.1

package/esm/core/TransferList/TransferList.js

@@ -1,142 +1,176 @@
-/*---------------------------------------------------------------------------------------------
- * Copyright (c) Bentley Systems, Incorporated. All rights reserved.
- * See LICENSE.md in the project root for license terms and full copyright notice.
- *--------------------------------------------------------------------------------------------*/
-import React from 'react';
+import * as React from 'react';
 import cx from 'classnames';
-import { getFocusableElements, useMergedRefs, useId, useSafeContext, Box, polymorphic, } from '../../utils/index.js';
+import {
+  getFocusableElements,
+  useMergedRefs,
+  useId,
+  useSafeContext,
+  Box,
+  polymorphic,
+} from '../../utils/index.js';
 import { List } from '../List/List.js';
 import { ListItem } from '../List/ListItem.js';
 import { Label } from '../Label/Label.js';
-// ----------------------------------------------------------------------------
-// TransferListComponent
 const TransferListComponent = polymorphic('iui-transfer-list-wrapper');
 TransferListComponent.displayName = 'TransferList';
 const TransferListListboxWrapper = React.forwardRef((props, ref) => {
-    const { className, children, ...rest } = props;
-    const uid = useId();
-    const [labelId, setLabelId] = React.useState(uid);
-    return (React.createElement(Box, { as: 'div', className: cx('iui-transfer-list-listbox-wrapper', className), ref: ref, ...rest },
-        React.createElement(TransferListContext.Provider, { value: { labelId, setLabelId } }, children)));
+  const { className, children, ...rest } = props;
+  const uid = useId();
+  const [labelId, setLabelId] = React.useState(uid);
+  return React.createElement(
+    Box,
+    {
+      as: 'div',
+      className: cx('iui-transfer-list-listbox-wrapper', className),
+      ref: ref,
+      ...rest,
+    },
+    React.createElement(
+      TransferListContext.Provider,
+      {
+        value: {
+          labelId,
+          setLabelId,
+        },
+      },
+      children,
+    ),
+  );
 });
 TransferListListboxWrapper.displayName = 'TransferList.ListboxWrapper';
 const TransferListListbox = React.forwardRef((props, ref) => {
-    const { children, className, ...rest } = props;
-    const { labelId } = useSafeContext(TransferListContext);
-    const [focusedIndex, setFocusedIndex] = React.useState();
-    const listRef = React.useRef(null);
-    const refs = useMergedRefs(listRef, ref);
-    const getFocusableNodes = React.useCallback(() => {
-        const focusableItems = getFocusableElements(listRef.current);
-        // Filter out focusable elements that are inside each list item, e.g. checkbox, anchor
-        return focusableItems.filter((i) => !focusableItems.some((p) => p.contains(i.parentElement)));
-    }, []);
-    React.useEffect(() => {
-        const items = getFocusableNodes();
-        if (focusedIndex != null) {
-            items?.[focusedIndex]?.focus();
-            return;
-        }
-    }, [focusedIndex, getFocusableNodes]);
-    const onKeyDown = (event) => {
-        if (event.altKey) {
-            return;
-        }
-        const items = getFocusableNodes();
-        if (!items?.length) {
-            return;
-        }
-        const currentIndex = focusedIndex ?? 0;
-        switch (event.key) {
-            case 'ArrowDown': {
-                setFocusedIndex(Math.min(currentIndex + 1, items.length - 1));
-                event.preventDefault();
-                event.stopPropagation();
-                break;
-            }
-            case 'ArrowUp': {
-                setFocusedIndex(Math.max(currentIndex - 1, 0));
-                event.preventDefault();
-                event.stopPropagation();
-                break;
-            }
-            default:
-                break;
-        }
-    };
-    return (React.createElement(List, { className: cx('iui-transfer-list-listbox', className), onKeyDown: onKeyDown, role: 'listbox', "aria-multiselectable": true, "aria-labelledby": labelId, tabIndex: 0, ref: refs, ...rest }, children));
+  const { children, className, ...rest } = props;
+  const { labelId } = useSafeContext(TransferListContext);
+  const [focusedIndex, setFocusedIndex] = React.useState();
+  const listRef = React.useRef(null);
+  const refs = useMergedRefs(listRef, ref);
+  const getFocusableNodes = React.useCallback(() => {
+    const focusableItems = getFocusableElements(listRef.current);
+    return focusableItems.filter(
+      (i) => !focusableItems.some((p) => p.contains(i.parentElement)),
+    );
+  }, []);
+  React.useEffect(() => {
+    const items = getFocusableNodes();
+    if (focusedIndex != null) {
+      items?.[focusedIndex]?.focus();
+      return;
+    }
+  }, [focusedIndex, getFocusableNodes]);
+  const onKeyDown = (event) => {
+    if (event.altKey) {
+      return;
+    }
+    const items = getFocusableNodes();
+    if (!items?.length) {
+      return;
+    }
+    const currentIndex = focusedIndex ?? 0;
+    switch (event.key) {
+      case 'ArrowDown': {
+        setFocusedIndex(Math.min(currentIndex + 1, items.length - 1));
+        event.preventDefault();
+        event.stopPropagation();
+        break;
+      }
+      case 'ArrowUp': {
+        setFocusedIndex(Math.max(currentIndex - 1, 0));
+        event.preventDefault();
+        event.stopPropagation();
+        break;
+      }
+      default:
+        break;
+    }
+  };
+  return React.createElement(
+    List,
+    {
+      className: cx('iui-transfer-list-listbox', className),
+      onKeyDown: onKeyDown,
+      role: 'listbox',
+      'aria-multiselectable': true,
+      'aria-labelledby': labelId,
+      tabIndex: 0,
+      ref: refs,
+      ...rest,
+    },
+    children,
+  );
 });
 TransferListListbox.displayName = 'TransferList.Listbox';
 const TransferListItem = React.forwardRef((props, ref) => {
-    const { actionable = true, disabled, onActiveChange, children, active, ...rest } = props;
-    const onClickEvents = () => actionable && onActiveChange && onActiveChange(!active);
-    const onKeyDown = (event) => {
-        if (event.altKey) {
-            return;
-        }
-        if (event.key === 'Enter' ||
-            event.key === ' ' ||
-            event.key === 'Spacebar') {
-            !disabled && onClickEvents();
-            event.preventDefault();
-        }
-    };
-    return (React.createElement(ListItem, { ref: ref, onClick: onClickEvents, onKeyDown: onKeyDown, active: active, actionable: actionable, tabIndex: -1, role: 'option', "aria-disabled": disabled ? 'true' : undefined, "aria-selected": active ? 'true' : undefined, disabled: disabled, ...rest }, children));
+  const {
+    actionable = true,
+    disabled,
+    onActiveChange,
+    children,
+    active,
+    ...rest
+  } = props;
+  const onClickEvents = () =>
+    actionable && onActiveChange && onActiveChange(!active);
+  const onKeyDown = (event) => {
+    if (event.altKey) {
+      return;
+    }
+    if (
+      event.key === 'Enter' ||
+      event.key === ' ' ||
+      event.key === 'Spacebar'
+    ) {
+      !disabled && onClickEvents();
+      event.preventDefault();
+    }
+  };
+  return React.createElement(
+    ListItem,
+    {
+      ref: ref,
+      onClick: onClickEvents,
+      onKeyDown: onKeyDown,
+      active: active,
+      actionable: actionable,
+      tabIndex: -1,
+      role: 'option',
+      'aria-disabled': disabled ? 'true' : undefined,
+      'aria-selected': active ? 'true' : undefined,
+      disabled: disabled,
+      ...rest,
+    },
+    children,
+  );
 });
 TransferListItem.displayName = 'TransferList.Item';
 const TransferListListboxLabel = React.forwardRef((props, ref) => {
-    const { children, id, ...rest } = props;
-    const { labelId, setLabelId } = useSafeContext(TransferListContext);
-    React.useEffect(() => {
-        if (id && id !== labelId) {
-            setLabelId(id);
-        }
-    }, [id, labelId, setLabelId]);
-    return (React.createElement(Label, { as: 'div', id: labelId, ref: ref, ...rest }, children));
+  const { children, id, ...rest } = props;
+  const { labelId, setLabelId } = useSafeContext(TransferListContext);
+  React.useEffect(() => {
+    if (id && id !== labelId) {
+      setLabelId(id);
+    }
+  }, [id, labelId, setLabelId]);
+  return React.createElement(
+    Label,
+    {
+      as: 'div',
+      id: labelId,
+      ref: ref,
+      ...rest,
+    },
+    children,
+  );
 });
 TransferListListboxLabel.displayName = 'TransferList.ListboxLabel';
-// ----------------------------------------------------------------------------
-// TransferList.Toolbar component
 const TransferListToolbar = polymorphic('iui-transfer-list-toolbar', {
-    role: 'toolbar',
+  role: 'toolbar',
 });
 TransferListToolbar.displayName = 'TransferList.Toolbar';
-/**
- * The TransferList component is used to display a list within a box
- * @example
- * <TransferList>
- *   <TransferList.ListboxWrapper>
- *     <TransferList.Listbox>
- *       <TransferList.Item>Item 1</TransferList.Item>
- *       <TransferList.Item>Item 2</TransferList.Item>
- *       <TransferList.Item>Item 3</TransferList.Item>
- *       <TransferList.Item>Item 4</TransferList.Item>
- *       <TransferList.Item>Item 5</TransferList.Item>
- *       <TransferList.Item>Item 6</TransferList.Item>
- *     </TransferList.Listbox>
- *   </TransferList.ListboxWrapper>
- * </TransferList>
- */
 export const TransferList = Object.assign(TransferListComponent, {
-    /**
-     * 	TransferList listbox wrapper subcomponent
-     */
-    ListboxWrapper: TransferListListboxWrapper,
-    /**
-     * 	TransferList listbox subcomponent
-     */
-    Listbox: TransferListListbox,
-    /**
-     * 	TransferList item subcomponent
-     */
-    Item: TransferListItem,
-    /**
-     * 	TransferList listbox label subcomponent
-     */
-    ListboxLabel: TransferListListboxLabel,
-    /**
-     * 	TransferList toolbar subcomponent
-     */
-    Toolbar: TransferListToolbar,
+  ListboxWrapper: TransferListListboxWrapper,
+  Listbox: TransferListListbox,
+  Item: TransferListItem,
+  ListboxLabel: TransferListListboxLabel,
+  Toolbar: TransferListToolbar,
 });
 export const TransferListContext = React.createContext(undefined);