@itwin/itwinui-react 3.14.2 → 3.15.0

package/esm/core/ColorPicker/ColorBuilder.js

@@ -6,6 +6,7 @@ import {
   useEventListener,
   useMergedRefs,
   Box,
+  mergeEventHandlers,
 } from '../../utils/index.js';
 import { Slider } from '../Slider/Slider.js';
 import { useColorPickerContext } from './ColorPickerContext.js';
@@ -18,7 +19,14 @@ let getHorizontalPercentageOfRectangle = (rect, pointer) => {
   return ((position - rect.left) / rect.width) * 100;
 };
 export const ColorBuilder = React.forwardRef((props, ref) => {
-  let { className, ...rest } = props;
+  let {
+    className,
+    colorFieldProps,
+    colorDotProps,
+    opacitySliderProps,
+    hueSliderProps,
+    ...rest
+  } = props;
   let builderRef = React.useRef();
   let refs = useMergedRefs(builderRef, ref);
   let {
@@ -206,54 +214,74 @@ export const ColorBuilder = React.forwardRef((props, ref) => {
     React.createElement(
       Box,
       {
-        className: 'iui-color-field',
+        as: 'div',
+        ...colorFieldProps,
+        className: cx('iui-color-field', colorFieldProps?.className),
         style: {
           '--iui-color-field-hue': hueColorString,
           '--iui-color-picker-selected-color': dotColorString,
+          ...colorFieldProps?.style,
         },
-        ref: squareRef,
-        onPointerDown: (event) => {
-          event.preventDefault();
-          updateSquareValue(event, 'onClick');
-          setColorDotActive(true);
-          colorDotRef.current?.focus();
-        },
+        ref: useMergedRefs(squareRef, colorFieldProps?.ref),
+        onPointerDown: mergeEventHandlers(
+          colorFieldProps?.onPointerDown,
+          (event) => {
+            event.preventDefault();
+            updateSquareValue(event, 'onClick');
+            setColorDotActive(true);
+            colorDotRef.current?.focus();
+          },
+        ),
       },
       React.createElement(Box, {
-        className: 'iui-color-dot',
+        as: 'div',
+        ...colorDotProps,
+        className: cx('iui-color-dot', colorDotProps?.className),
         style: {
           '--iui-color-dot-inset-block': `${squareTop.toString()}% auto`,
           '--iui-color-dot-inset-inline': `${squareLeft.toString()}% auto`,
+          ...colorDotProps?.style,
         },
-        onPointerDown: () => {
+        onPointerDown: mergeEventHandlers(colorDotProps?.onPointerDown, () => {
           setColorDotActive(true);
           colorDotRef.current?.focus();
-        },
-        onKeyDown: handleColorDotKeyDown,
-        onKeyUp: handleColorDotKeyUp,
+        }),
+        onKeyDown: mergeEventHandlers(
+          colorDotProps?.onKeyDown,
+          handleColorDotKeyDown,
+        ),
+        onKeyUp: mergeEventHandlers(
+          colorDotProps?.onKeyUp,
+          handleColorDotKeyUp,
+        ),
         tabIndex: 0,
-        ref: colorDotRef,
+        ref: useMergedRefs(colorDotRef, colorDotProps?.ref),
       }),
     ),
     React.createElement(Slider, {
       minLabel: '',
       maxLabel: '',
       values: [sliderValue],
-      className: 'iui-hue-slider',
       trackDisplayMode: 'none',
+      min: 0,
+      max: 359,
+      ...hueSliderProps,
+      className: cx('iui-hue-slider', hueSliderProps?.className),
       tooltipProps: () => ({
         visible: false,
+        ...hueSliderProps?.tooltipProps,
       }),
       onChange: (values) => {
+        hueSliderProps?.onChange?.(values);
         updateHueSlider(values[0], true);
       },
       onUpdate: (values) => {
+        hueSliderProps?.onUpdate?.(values);
         updateHueSlider(values[0], false);
       },
-      min: 0,
-      max: 359,
       thumbProps: () => ({
         'aria-label': 'Hue',
+        ...hueSliderProps?.thumbProps,
       }),
     }),
     showAlpha &&
@@ -261,25 +289,31 @@ export const ColorBuilder = React.forwardRef((props, ref) => {
         minLabel: '',
         maxLabel: '',
         values: [alphaValue],
-        className: 'iui-opacity-slider',
         trackDisplayMode: 'none',
+        min: 0,
+        max: 1,
+        step: 0.01,
+        ...opacitySliderProps,
+        className: cx('iui-opacity-slider', opacitySliderProps?.className),
         tooltipProps: () => ({
           visible: false,
+          ...opacitySliderProps?.tooltipProps,
         }),
         onChange: (values) => {
+          opacitySliderProps?.onChange?.(values);
           updateOpacitySlider(values[0], true);
         },
         onUpdate: (values) => {
+          opacitySliderProps?.onUpdate?.(values);
           updateOpacitySlider(values[0], false);
         },
-        min: 0,
-        max: 1,
-        step: 0.01,
         style: {
           '--iui-color-picker-selected-color': hueColorString,
+          ...opacitySliderProps?.style,
         },
         thumbProps: () => ({
           'aria-label': 'Opacity',
+          ...opacitySliderProps?.thumbProps,
         }),
       }),
   );

package/esm/core/ColorPicker/ColorInputPanel.d.ts

@@ -1,3 +1,5 @@
+import * as React from 'react';
+import { IconButton } from '../Buttons/IconButton.js';
 import type { PolymorphicForwardRefComponent } from '../../utils/index.js';
 type ColorInputPanelProps = {
     /**
@@ -12,6 +14,22 @@ type ColorInputPanelProps = {
      * @default ['hsl', 'rgb', 'hex']
      */
     allowedColorFormats?: ('hsl' | 'rgb' | 'hex')[];
+    /**
+     * Passes props to the color picker section label.
+     */
+    panelLabelProps?: React.ComponentProps<'div'>;
+    /**
+     * Passes props to the color input container.
+     */
+    colorInputContainerProps?: React.ComponentProps<'div'>;
+    /**
+     * Passes props to the color input fields group.
+     */
+    inputFieldsGroupProps?: React.ComponentProps<'div'>;
+    /**
+     * Passes props to the swap color format button.
+     */
+    swapColorFormatButtonProps?: React.ComponentProps<typeof IconButton>;
 };
 /**
  * `ColorInputPanel` shows input fields to enter precise color values in the specified format.

package/esm/core/ColorPicker/ColorInputPanel.js

@@ -2,13 +2,24 @@ import * as React from 'react';
 import cx from 'classnames';
 import { IconButton } from '../Buttons/IconButton.js';
 import { Input } from '../Input/Input.js';
-import { ColorValue, SvgSwap, Box, useId } from '../../utils/index.js';
+import {
+  ColorValue,
+  SvgSwap,
+  Box,
+  useId,
+  useMergedRefs,
+  mergeEventHandlers,
+} from '../../utils/index.js';
 import { useColorPickerContext } from './ColorPickerContext.js';
 export const ColorInputPanel = React.forwardRef((props, ref) => {
   let {
     defaultColorFormat,
     allowedColorFormats = ['hsl', 'rgb', 'hex'],
     className,
+    colorInputContainerProps,
+    panelLabelProps,
+    inputFieldsGroupProps,
+    swapColorFormatButtonProps,
     ...rest
   } = props;
   let inputsContainerRef = React.useRef(null);
@@ -352,10 +363,12 @@ export const ColorInputPanel = React.forwardRef((props, ref) => {
           Number(input[3]) < 0 || Number(input[3]) > 1 ? 'negative' : void 0,
       }),
   );
-  let labelId = useId();
+  let fallbackLabelId = useId();
+  let labelId = panelLabelProps?.id ?? fallbackLabelId;
   return React.createElement(
     Box,
     {
+      as: 'div',
       className: cx('iui-color-input-wrapper', className),
       ref: ref,
       ...rest,
@@ -363,7 +376,12 @@ export const ColorInputPanel = React.forwardRef((props, ref) => {
     React.createElement(
       Box,
       {
-        className: 'iui-color-picker-section-label',
+        as: 'div',
+        ...panelLabelProps,
+        className: cx(
+          'iui-color-picker-section-label',
+          panelLabelProps?.className,
+        ),
         id: labelId,
       },
       showAlpha && 'hex' !== currentFormat
@@ -373,26 +391,37 @@ export const ColorInputPanel = React.forwardRef((props, ref) => {
     React.createElement(
       Box,
       {
-        className: 'iui-color-input',
+        as: 'div',
+        ...colorInputContainerProps,
+        className: cx('iui-color-input', colorInputContainerProps?.className),
       },
       allowedColorFormats.length > 1 &&
         React.createElement(
           IconButton,
           {
-            styleType: 'borderless',
-            onClick: swapColorFormat,
             size: 'small',
+            styleType: 'borderless',
             label: 'Switch format',
+            ...swapColorFormatButtonProps,
+            onClick: mergeEventHandlers(
+              swapColorFormatButtonProps?.onClick,
+              swapColorFormat,
+            ),
           },
           React.createElement(SvgSwap, null),
         ),
       React.createElement(
         Box,
         {
-          ref: inputsContainerRef,
-          className: 'iui-color-input-fields',
+          as: 'div',
           role: 'hex' !== currentFormat ? 'group' : void 0,
           'aria-labelledby': 'hex' !== currentFormat ? labelId : void 0,
+          ...inputFieldsGroupProps,
+          ref: useMergedRefs(inputsContainerRef, inputFieldsGroupProps?.ref),
+          className: cx(
+            'iui-color-input-fields',
+            inputFieldsGroupProps?.className,
+          ),
         },
         'hex' === currentFormat && hexInputField,
         'rgb' === currentFormat && rgbInputs,

package/esm/core/ColorPicker/ColorPalette.d.ts

@@ -6,6 +6,10 @@ export type ColorPaletteProps = {
      * Label shown above the palette.
      */
     label?: React.ReactNode;
+    /**
+     * Passes props to the color picker section label.
+     */
+    labelProps?: React.ComponentProps<'div'>;
     /**
      * List of colors shown as swatches in the palette.
      */
@@ -14,6 +18,10 @@ export type ColorPaletteProps = {
      * Pass any custom swatches as children.
      */
     children?: React.ReactNode;
+    /**
+     * Passes props to the color palette container.
+     */
+    paletteContainerProps?: React.ComponentProps<'div'>;
 };
 /**
  * `ColorPalette` is used to show a group of `ColorSwatch` components.

package/esm/core/ColorPicker/ColorPalette.js

@@ -5,7 +5,15 @@ import { getColorValue } from './ColorPicker.js';
 import { ColorSwatch } from './ColorSwatch.js';
 import { useColorPickerContext } from './ColorPickerContext.js';
 export const ColorPalette = React.forwardRef((props, ref) => {
-  let { colors, label, className, children, ...rest } = props;
+  let {
+    colors,
+    label,
+    labelProps,
+    className,
+    children,
+    paletteContainerProps,
+    ...rest
+  } = props;
   let { activeColor, setActiveColor, onChangeComplete } =
     useColorPickerContext();
   return React.createElement(
@@ -19,14 +27,21 @@ export const ColorPalette = React.forwardRef((props, ref) => {
       React.createElement(
         Box,
         {
-          className: 'iui-color-picker-section-label',
+          as: 'div',
+          ...labelProps,
+          className: cx(
+            'iui-color-picker-section-label',
+            labelProps?.className,
+          ),
         },
         label,
       ),
     React.createElement(
       Box,
       {
-        className: 'iui-color-palette',
+        as: 'div',
+        ...paletteContainerProps,
+        className: cx('iui-color-palette', paletteContainerProps?.className),
       },
       children,
       colors &&

package/esm/core/ComboBox/ComboBox.d.ts

@@ -1,7 +1,8 @@
 import * as React from 'react';
 import type { SelectOption } from '../Select/Select.js';
 import type { Input } from '../Input/Input.js';
-import type { InputContainerProps, CommonProps } from '../../utils/index.js';
+import { usePopover } from '../Popover/Popover.js';
+import type { InputContainerProps, CommonProps, PortalProps } from '../../utils/index.js';
 import { ComboBoxEndIcon } from './ComboBoxEndIcon.js';
 type ActionType = 'added' | 'removed';
 type MultipleOnChangeProps<T> = {
@@ -59,7 +60,7 @@ export type ComboBoxProps<T> = {
     /**
      * Props to customize dropdown menu behavior.
      */
-    dropdownMenuProps?: React.ComponentProps<'div'>;
+    dropdownMenuProps?: React.ComponentProps<'div'> & Pick<Parameters<typeof usePopover>['0'], 'middleware'> & Pick<PortalProps, 'portal'>;
     /**
      * End icon props.
      */

package/esm/core/ComboBox/ComboBox.js

@@ -38,7 +38,7 @@ export const ComboBox = React.forwardRef((props, forwardedRef) => {
     filterFunction = defaultFilterFunction,
     inputProps,
     endIconProps,
-    dropdownMenuProps,
+    dropdownMenuProps: { middleware, ...dropdownMenuProps } = {},
     emptyStateMessage = 'No options found',
     itemRenderer,
     enableVirtualization = false,
@@ -318,6 +318,7 @@ export const ComboBox = React.forwardRef((props, forwardedRef) => {
       size: {
         maxHeight: 'var(--iui-menu-max-height)',
       },
+      ...middleware,
     },
     closeOnOutsideClick: true,
     interactions: {

package/esm/core/ComboBox/ComboBoxMenu.js

@@ -90,7 +90,7 @@ let VirtualizedComboBoxMenu = (props) => {
   );
 };
 export const ComboBoxMenu = React.forwardRef((props, forwardedRef) => {
-  let { className, children, style, ...rest } = props;
+  let { className, children, style, portal = true, ...rest } = props;
   let { id, enableVirtualization, popover } =
     useSafeContext(ComboBoxStateContext);
   let { menuRef } = useSafeContext(ComboBoxRefsContext);
@@ -100,7 +100,7 @@ export const ComboBoxMenu = React.forwardRef((props, forwardedRef) => {
     React.createElement(
       Portal,
       {
-        portal: true,
+        portal: portal,
       },
       React.createElement(
         List,

package/esm/core/DropdownMenu/DropdownMenu.d.ts

@@ -16,6 +16,17 @@ export type DropdownMenuProps = {
      * Child element to wrap dropdown with.
      */
     children: React.ReactNode;
+    /**
+     * Middleware options.
+     *
+     * By default, `hide` is enabled. If the menu gets hidden even when it shouldn't (e.g. some custom styles interfering
+     * with the trigger's hide detection) consider disabling the `hide` middleware.
+     *
+     * @see https://floating-ui.com/docs/middleware
+     */
+    middleware?: {
+        hide?: boolean;
+    };
 } & Pick<Parameters<typeof usePopover>[0], 'visible' | 'onVisibleChange' | 'placement' | 'matchWidth'> & Pick<PortalProps, 'portal'>;
 /**
  * Dropdown menu component.

package/esm/core/DropdownMenu/DropdownMenu.js

@@ -22,6 +22,7 @@ let DropdownMenuContent = React.forwardRef((props, forwardedRef) => {
     matchWidth = false,
     onVisibleChange,
     portal = true,
+    middleware,
     ...rest
   } = props;
   let [visible, setVisible] = useControlledState(
@@ -35,28 +36,28 @@ let DropdownMenuContent = React.forwardRef((props, forwardedRef) => {
     return menuItems;
   }, [menuItems, setVisible]);
   return React.createElement(
-    React.Fragment,
-    null,
-    React.createElement(
-      Menu,
-      {
-        trigger: children,
-        onKeyDown: mergeEventHandlers(props.onKeyDown, (e) => {
-          if (e.defaultPrevented) return;
-          if ('Tab' === e.key) setVisible(false);
-        }),
-        role: role,
-        ref: forwardedRef,
-        portal: portal,
-        popoverProps: {
+    Menu,
+    {
+      trigger: children,
+      onKeyDown: mergeEventHandlers(props.onKeyDown, (e) => {
+        if (e.defaultPrevented) return;
+        if ('Tab' === e.key) setVisible(false);
+      }),
+      role: role,
+      ref: forwardedRef,
+      portal: portal,
+      popoverProps: React.useMemo(
+        () => ({
           placement,
           matchWidth,
           visible,
           onVisibleChange: setVisible,
-        },
-        ...rest,
-      },
-      menuContent,
-    ),
+          middleware,
+        }),
+        [matchWidth, middleware, placement, setVisible, visible],
+      ),
+      ...rest,
+    },
+    menuContent,
   );
 });

package/esm/core/Overlay/Overlay.js

@@ -1,5 +1,5 @@
 import * as React from 'react';
-import { Box, isUnitTest, polymorphic } from '../../utils/index.js';
+import { Box, polymorphic } from '../../utils/index.js';
 let OverlayComponent = React.forwardRef((props, forwardedRef) => {
   let { content, children, ...rest } = props;
   return React.createElement(
@@ -14,7 +14,6 @@ let OverlayComponent = React.forwardRef((props, forwardedRef) => {
 });
 let OverlayHiddenContent = React.forwardRef((props, ref) => {
   let { children, ...rest } = props;
-  useInertPolyfill();
   return React.createElement(
     Box,
     {
@@ -32,20 +31,3 @@ export const Overlay = Object.assign(OverlayComponent, {
   HiddenContent: OverlayHiddenContent,
   Overlay: OverlayOverlay,
 });
-let useInertPolyfill = () => {
-  let loaded = React.useRef(false);
-  let modulePath =
-    'https://cdn.jsdelivr.net/npm/wicg-inert@3.1.2/dist/inert.min.js';
-  React.useEffect(() => {
-    (async () => {
-      if (
-        !HTMLElement.prototype.hasOwnProperty('inert') &&
-        !loaded.current &&
-        !isUnitTest
-      ) {
-        await new Function('url', 'return import(url)')(modulePath);
-        loaded.current = true;
-      }
-    })();
-  }, []);
-};

package/esm/core/Popover/Popover.d.ts

@@ -26,7 +26,10 @@ type PopoverOptions = {
     /**
      * Middleware options.
      *
-     * By default, `flip`, `shift` and `size` are enabled.
+     * By default, `flip`, `shift`, `size`, and `hide` are enabled.
+     *
+     * If the floating content gets hidden even when it shouldn't (e.g. some custom styles interfering with the trigger's
+     * hide detection) consider disabling the `hide` middleware.
      *
      * @see https://floating-ui.com/docs/middleware
      */

package/esm/core/Popover/Popover.js

@@ -25,6 +25,7 @@ import {
   Box,
   ShadowRoot,
   cloneElementWithRef,
+  isUnitTest,
   mergeEventHandlers,
   useControlledState,
   useId,
@@ -47,21 +48,22 @@ export const usePopover = (options) => {
   } = options;
   let mergedInteractions = React.useMemo(
     () => ({
-      click: true,
-      dismiss: true,
-      hover: false,
-      focus: false,
       ...interactionsProp,
+      click: interactionsProp?.click ?? true,
+      dismiss: interactionsProp?.dismiss ?? true,
+      hover: interactionsProp?.hover ?? false,
+      focus: interactionsProp?.focus ?? false,
     }),
     [interactionsProp],
   );
   let tree = useFloatingTree();
   let middleware = React.useMemo(
     () => ({
-      flip: true,
-      shift: true,
-      size: true,
       ...options.middleware,
+      flip: options.middleware?.flip ?? true,
+      shift: options.middleware?.shift ?? true,
+      size: options.middleware?.size ?? true,
+      hide: options.middleware?.hide || !isUnitTest,
     }),
     [options.middleware],
   );
@@ -166,17 +168,23 @@ export const usePopover = (options) => {
                 maxInlineSize: `min(${2 * referenceWidth}px, 90vw)`,
               }
             : {}),
+          ...(middleware.hide &&
+            floating.middlewareData.hide?.referenceHidden && {
+              visibility: 'hidden',
+            }),
           ...userProps?.style,
         },
       }),
     [
-      floating.floatingStyles,
       interactions,
-      matchWidth,
-      referenceWidth,
+      floating.floatingStyles,
+      floating.middlewareData.hide?.referenceHidden,
       middleware.size,
+      middleware.hide,
       availableHeight,
       maxHeight,
+      matchWidth,
+      referenceWidth,
     ],
   );
   let getReferenceProps = React.useCallback(

package/esm/core/Select/Select.d.ts

@@ -1,5 +1,5 @@
 import * as React from 'react';
-import type { CommonProps } from '../../utils/index.js';
+import type { CommonProps, PortalProps } from '../../utils/index.js';
 import { usePopover } from '../Popover/Popover.js';
 /**
  * Select component to select value from options.
@@ -182,7 +182,19 @@ export type CustomSelectProps<T> = SelectCommonProps & {
     /**
      * Props to customize Popover behavior.
      */
-    popoverProps?: Pick<Parameters<typeof usePopover>[0], 'visible' | 'onVisibleChange' | 'placement' | 'matchWidth' | 'closeOnOutsideClick'>;
+    popoverProps?: Pick<Parameters<typeof usePopover>[0], 'visible' | 'onVisibleChange' | 'placement' | 'matchWidth' | 'closeOnOutsideClick'> & {
+        /**
+         * Middleware options.
+         *
+         * By default, `hide` is enabled. If the floating options get hidden even when they shouldn't (e.g. some custom
+         * styles interfering with the trigger's hide detection) consider disabling the `hide` middleware.
+         *
+         * @see https://floating-ui.com/docs/middleware
+         */
+        middleware?: {
+            hide?: boolean;
+        };
+    } & Pick<PortalProps, 'portal'>;
     /**
      * Props to pass to the select button (trigger) element.
      */

package/esm/core/Select/Select.js

@@ -109,7 +109,7 @@ let CustomSelect = React.forwardRef((props, forwardedRef) => {
     multiple = false,
     triggerProps,
     status,
-    popoverProps,
+    popoverProps: { portal = true, ...popoverProps } = {},
     styleType,
     ...rest
   } = props;
@@ -303,7 +303,9 @@ let CustomSelect = React.forwardRef((props, forwardedRef) => {
     popover.open &&
       React.createElement(
         Portal,
-        null,
+        {
+          portal: portal,
+        },
         React.createElement(
           SelectListbox,
           {