@itwin/itwinui-react 3.0.0-dev.5 → 3.0.0-dev.7

package/esm/core/FileUpload/FileUpload.d.ts

@@ -15,6 +15,10 @@ type FileUploadProps = {
      * Either pass `FileUploadCard` (for default state) or a different component to wrap.
      */
     children: React.ReactNode;
+    /**
+     *  Allows for custom prop to be passed for content.
+     */
+    contentProps?: React.ComponentProps<'div'>;
 };
 /**
  * File upload component to be wrapped around `FileUploadCard` or any arbitrary component.

package/esm/core/FileUpload/FileUpload.js

@@ -13,7 +13,14 @@ import { Box, useMergedRefs } from '../utils/index.js';
  * <FileUpload dragContent='Drop file here' onFileDropped={console.log}><Textarea /></FileUpload>
  */
 export const FileUpload = React.forwardRef((props, ref) => {
-  const { dragContent, children, onFileDropped, className, ...rest } = props;
+  const {
+    dragContent,
+    children,
+    onFileDropped,
+    className,
+    contentProps,
+    ...rest
+  } = props;
   const [isDragActive, setIsDragActive] = React.useState(false);
   const fileUploadRef = React.useRef(null);
   const refs = useMergedRefs(fileUploadRef, ref);
@@ -58,9 +65,25 @@ export const FileUpload = React.forwardRef((props, ref) => {
     },
     dragContent
       ? children
-      : React.createElement(Box, { className: 'iui-content' }, children),
+      : React.createElement(
+          Box,
+          {
+            as: 'div',
+            ...contentProps,
+            className: cx('iui-content', contentProps?.className),
+          },
+          children,
+        ),
     dragContent &&
-      React.createElement(Box, { className: 'iui-content' }, dragContent),
+      React.createElement(
+        Box,
+        {
+          as: 'div',
+          ...contentProps,
+          className: cx('iui-content', contentProps?.className),
+        },
+        dragContent,
+      ),
   );
 });
 export default FileUpload;

package/esm/core/Header/HeaderBasicButton.js

@@ -4,30 +4,17 @@
  *--------------------------------------------------------------------------------------------*/
 import cx from 'classnames';
 import * as React from 'react';
-import { Box } from '../utils/index.js';
+import { ButtonBase } from '../utils/index.js';
 export const HeaderBasicButton = React.forwardRef((props, ref) => {
-  const {
-    onClick,
-    className,
-    children,
-    style,
-    startIcon,
-    endIcon,
-    styleType,
-    size,
-    ...rest
-  } = props;
+  const { className, children, startIcon, endIcon, styleType, size, ...rest } =
+    props;
   styleType; // To omit and prevent eslint error.
   size; // To omit and prevent eslint error.
   return React.createElement(
-    Box,
+    ButtonBase,
     {
-      as: 'button',
       className: cx('iui-header-breadcrumb-button', className),
-      onClick: onClick,
       ref: ref,
-      type: 'button',
-      style: style,
       ...rest,
     },
     startIcon,

package/esm/core/Header/HeaderButton.d.ts

@@ -16,6 +16,10 @@ type HeaderButtonProps = {
      * @default false
      */
     isActive?: boolean;
+    /**
+     * Modify the native `name` attribute of the `<button>` element.
+     */
+    htmlName?: string;
 } & Partial<Pick<DropdownButtonProps, 'menuItems'>> & Pick<ButtonProps, 'startIcon' | 'endIcon'>;
 /**
  * Header button that handles slim state of the `Header` it's in.

package/esm/core/Header/HeaderButton.js

@@ -21,6 +21,7 @@ export const HeaderButton = React.forwardRef((props, ref) => {
   const {
     name,
     description,
+    htmlName,
     isActive = false,
     startIcon,
     menuItems,
@@ -59,6 +60,7 @@ export const HeaderButton = React.forwardRef((props, ref) => {
     ),
     ref: ref,
     disabled: disabled,
+    name: htmlName,
     ...(!!menuItems && { menuItems }),
     ...rest,
   }; // eslint-disable-line @typescript-eslint/no-explicit-any

package/esm/core/Header/HeaderDropdownButton.js

@@ -26,7 +26,7 @@ export const HeaderDropdownButton = React.forwardRef((props, ref) => {
     DropdownMenu,
     {
       menuItems: menuItems,
-      style: { minWidth: menuWidth },
+      style: { minInlineSize: menuWidth },
       onShow: () => setIsMenuOpen(true),
       onHide: () => setIsMenuOpen(false),
     },

package/esm/core/Header/HeaderSplitButton.js

@@ -5,7 +5,12 @@
 import cx from 'classnames';
 import * as React from 'react';
 import { DropdownMenu } from '../DropdownMenu/index.js';
-import { SvgCaretDownSmall, SvgCaretUpSmall, Box } from '../utils/index.js';
+import {
+  SvgCaretDownSmall,
+  SvgCaretUpSmall,
+  Box,
+  ButtonBase,
+} from '../utils/index.js';
 import { HeaderBasicButton } from './HeaderBasicButton.js';
 export const HeaderSplitButton = React.forwardRef((props, forwardedRef) => {
   const {
@@ -40,15 +45,13 @@ export const HeaderSplitButton = React.forwardRef((props, forwardedRef) => {
       {
         placement: menuPlacement,
         menuItems: menuItems,
-        style: { minWidth: menuWidth },
+        style: { minInlineSize: menuWidth },
         onShow: React.useCallback(() => setIsMenuOpen(true), []),
         onHide: React.useCallback(() => setIsMenuOpen(false), []),
       },
       React.createElement(
-        Box,
+        ButtonBase,
         {
-          as: 'button',
-          type: 'button',
           className:
             'iui-header-breadcrumb-button iui-header-breadcrumb-button-split',
           disabled: disabled,

package/esm/core/Input/Input.d.ts

@@ -4,6 +4,11 @@ export type InputProps = {
      * Modify size of the input.
      */
     size?: 'small' | 'large';
+    /**
+     * Modify the native `size` attribute of the `<input>` element.
+     * The `width` or `inline-size` property must be unset in order to use this prop.
+     */
+    htmlSize?: number;
 };
 /**
  * Basic input component

package/esm/core/Input/Input.js

@@ -13,13 +13,14 @@ import { useMergedRefs, Box } from '../utils/index.js';
  * <Input size='small' />
  */
 export const Input = React.forwardRef((props, ref) => {
-  const { size, className, ...rest } = props;
+  const { size, htmlSize, className, ...rest } = props;
   const inputRef = React.useRef(null);
   const refs = useMergedRefs(inputRef, ref);
   return React.createElement(Box, {
     as: 'input',
     className: cx('iui-input', className),
     'data-iui-size': size,
+    size: htmlSize,
     ref: refs,
     ...rest,
   });

package/esm/core/ProgressIndicators/ProgressLinear.d.ts

@@ -24,6 +24,10 @@ type ProgressLinearProps = {
      * Status of progress.
      */
     status?: 'positive' | 'negative';
+    /**
+     * Pass props to ProgressLinear label group.
+     */
+    labelGroupProps?: React.ComponentProps<'div'>;
 };
 /**
  * Shows progress on a linear bar

package/esm/core/ProgressIndicators/ProgressLinear.js

@@ -28,6 +28,7 @@ export const ProgressLinear = React.forwardRef((props, forwardedRef) => {
     isAnimated = false,
     status,
     className,
+    labelGroupProps,
     ...rest
   } = props;
   const boundedValue = getBoundedValue(value ?? 100, 0, 100);
@@ -47,7 +48,14 @@ export const ProgressLinear = React.forwardRef((props, forwardedRef) => {
     labels.length > 0 &&
       React.createElement(
         Box,
-        { className: 'iui-progress-indicator-linear-label' },
+        {
+          as: 'div',
+          ...labelGroupProps,
+          className: cx(
+            'iui-progress-indicator-linear-label',
+            labelGroupProps?.className,
+          ),
+        },
         labels.map((label, index) =>
           React.createElement('span', { key: index }, label),
         ),

package/esm/core/Radio/Radio.d.ts

@@ -9,6 +9,14 @@ type RadioProps = {
      * Status of the radio.
      */
     status?: 'positive' | 'warning' | 'negative';
+    /**
+     * Passes props to Radio label.
+     */
+    labelProps?: React.ComponentProps<'span'>;
+    /**
+     * Passes props to Radio wrapper.
+     */
+    wrapperProps?: React.ComponentProps<'label'>;
 };
 /**
  * Basic radio input component

package/esm/core/Radio/Radio.js

@@ -16,13 +16,22 @@ import { useMergedRefs, Box } from '../utils/index.js';
  * <Radio status='negative' label='Negative' />
  */
 export const Radio = React.forwardRef((props, ref) => {
-  const { className, disabled = false, label, status, style, ...rest } = props;
+  const {
+    className,
+    disabled = false,
+    label,
+    status,
+    labelProps,
+    wrapperProps,
+    style,
+    ...rest
+  } = props;
   const inputElementRef = React.useRef(null);
   const refs = useMergedRefs(inputElementRef, ref);
   const radio = React.createElement(Box, {
     as: 'input',
-    className: cx('iui-radio', className && { [className]: !label }),
-    style: !label ? style : undefined,
+    className: cx('iui-radio', className),
+    style: style,
     disabled: disabled,
     type: 'radio',
     ref: refs,
@@ -34,18 +43,22 @@ export const Radio = React.forwardRef((props, ref) => {
         Box,
         {
           as: 'label',
+          ...wrapperProps,
           className: cx(
             'iui-radio-wrapper',
             { 'iui-disabled': disabled, [`iui-${status}`]: !!status },
-            className,
+            wrapperProps?.className,
           ),
-          style: style,
         },
         radio,
         label &&
           React.createElement(
             Box,
-            { as: 'span', className: 'iui-radio-label' },
+            {
+              as: 'span',
+              ...labelProps,
+              className: cx('iui-radio-label', labelProps?.className),
+            },
             label,
           ),
       );

package/esm/core/RadioTiles/RadioTile.d.ts

@@ -13,6 +13,22 @@ type RadioTileProps = {
      * Additional description, if needed.
      */
     description?: React.ReactNode;
+    /**
+     * Passes props to tile wrapper.
+     */
+    wrapperProps?: React.ComponentProps<'label'>;
+    /**
+     * Passes props to tile icon.
+     */
+    iconProps?: React.ComponentProps<'span'>;
+    /**
+     * Passes props to tile label.
+     */
+    labelProps?: React.ComponentProps<'div'>;
+    /**
+     * Passes props to tile sublabel.
+     */
+    subLabelProps?: React.ComponentProps<'div'>;
 };
 /**
  * RadioTile component to be used in RadioTileGroup component

package/esm/core/RadioTiles/RadioTile.js

@@ -11,37 +11,67 @@ import { useMergedRefs, Box } from '../utils/index.js';
  * <RadioTile label='My tile' description='Some info' icon={<SvgSmileyHappy />} />
  */
 export const RadioTile = React.forwardRef((props, ref) => {
-  const { icon, label, description, className, style, ...rest } = props;
+  const {
+    icon,
+    label,
+    description,
+    className,
+    wrapperProps,
+    iconProps,
+    labelProps,
+    subLabelProps,
+    style,
+    ...rest
+  } = props;
   const inputElementRef = React.useRef(null);
   const refs = useMergedRefs(inputElementRef, ref);
   return React.createElement(
     Box,
-    { as: 'label', className: cx('iui-radio-tile', className), style: style },
+    {
+      as: 'label',
+      'data-iui-disabled': props.disabled ? 'true' : undefined,
+      ...wrapperProps,
+      className: cx('iui-radio-tile', wrapperProps?.className),
+    },
     React.createElement(Box, {
       as: 'input',
-      className: 'iui-radio-tile-input',
-      type: 'radio',
       ref: refs,
+      className: cx('iui-radio-tile-input', className),
+      style: style,
+      type: 'radio',
       ...rest,
     }),
-    React.createElement(
-      Box,
-      { className: 'iui-radio-tile-content' },
-      icon &&
-        React.createElement(
-          Box,
-          { as: 'span', className: 'iui-radio-tile-icon', 'aria-hidden': true },
-          icon,
-        ),
-      label &&
-        React.createElement(Box, { className: 'iui-radio-tile-label' }, label),
-      description &&
-        React.createElement(
-          Box,
-          { className: 'iui-radio-tile-sublabel' },
-          description,
-        ),
-    ),
+    icon &&
+      React.createElement(
+        Box,
+        {
+          as: 'span',
+          'aria-hidden': true,
+          ...iconProps,
+          className: cx('iui-radio-tile-icon', iconProps?.className),
+        },
+        icon,
+      ),
+    label &&
+      React.createElement(
+        Box,
+        {
+          as: 'div',
+          ...labelProps,
+          className: cx('iui-radio-tile-label', labelProps?.className),
+        },
+        label,
+      ),
+    description &&
+      React.createElement(
+        Box,
+        {
+          as: 'div',
+          ...subLabelProps,
+          className: cx('iui-radio-tile-sublabel', subLabelProps?.className),
+        },
+        description,
+      ),
   );
 });
 export default RadioTile;

package/esm/core/Select/Select.js

@@ -210,8 +210,8 @@ export const Select = (props) => {
             role: 'listbox',
             className: cx('iui-scroll', menuClassName),
             style: {
-              minWidth,
-              maxWidth: `min(${minWidth * 2}px, 90vw)`,
+              minInlineSize: minWidth,
+              maxInlineSize: `min(${minWidth * 2}px, 90vw)`,
               ...menuStyle,
             },
             id: `${uid}-menu`,

package/esm/core/SideNavigation/SideNavigation.d.ts

@@ -48,6 +48,22 @@ type SideNavigationProps = {
      * @default false
      */
     isSubmenuOpen?: boolean;
+    /**
+     * Passes props for SideNav wrapper.
+     */
+    wrapperProps?: React.ComponentProps<'div'>;
+    /**
+     * Passes props for SideNav content.
+     */
+    contentProps?: React.ComponentProps<'div'>;
+    /**
+     * Passes props for SideNav top.
+     */
+    topProps?: React.ComponentProps<'div'>;
+    /**
+     * Passes props for SideNav bottom.
+     */
+    bottomProps?: React.ComponentProps<'div'>;
 };
 /**
  * Left side navigation menu component.

package/esm/core/SideNavigation/SideNavigation.js

@@ -31,6 +31,10 @@ export const SideNavigation = React.forwardRef((props, forwardedRef) => {
     onExpanderClick,
     submenu,
     isSubmenuOpen = false,
+    wrapperProps,
+    contentProps,
+    topProps,
+    bottomProps,
     ...rest
   } = props;
   const [_isExpanded, _setIsExpanded] = React.useState(isExpanded);
@@ -51,25 +55,39 @@ export const SideNavigation = React.forwardRef((props, forwardedRef) => {
   return React.createElement(
     Box,
     {
-      className: cx('iui-side-navigation-wrapper', className),
+      ...wrapperProps,
+      className: cx('iui-side-navigation-wrapper', wrapperProps?.className),
       ref: forwardedRef,
-      ...rest,
     },
     React.createElement(
       Box,
       {
-        className: cx('iui-side-navigation', {
-          'iui-expanded': _isExpanded,
-          'iui-collapsed': !_isExpanded,
-        }),
+        as: 'div',
+        className: cx(
+          'iui-side-navigation',
+          {
+            'iui-expanded': _isExpanded,
+            'iui-collapsed': !_isExpanded,
+          },
+          className,
+        ),
+        ...rest,
       },
       expanderPlacement === 'top' && ExpandButton,
       React.createElement(
         Box,
-        { className: 'iui-sidenav-content' },
+        {
+          as: 'div',
+          ...contentProps,
+          className: cx('iui-sidenav-content', contentProps?.className),
+        },
         React.createElement(
           Box,
-          { className: 'iui-top' },
+          {
+            as: 'div',
+            ...topProps,
+            className: cx('iui-top', topProps?.className),
+          },
           items.map((sidenavButton, index) =>
             !_isExpanded
               ? React.createElement(
@@ -86,7 +104,11 @@ export const SideNavigation = React.forwardRef((props, forwardedRef) => {
         ),
         React.createElement(
           Box,
-          { className: 'iui-bottom' },
+          {
+            as: 'div',
+            ...bottomProps,
+            className: cx('iui-bottom', bottomProps?.className),
+          },
           secondaryItems?.map((sidenavButton, index) =>
             !_isExpanded
               ? React.createElement(

package/esm/core/Slider/Slider.d.ts

@@ -68,6 +68,30 @@ export type SliderProps = {
      * Additional props for container `<div>` that hold the slider rail, thumbs, and tracks.
      */
     railContainerProps?: React.HTMLAttributes<HTMLDivElement>;
+    /**
+     * Allows props to be passed for slider-min
+     */
+    minProps?: React.ComponentProps<'span'>;
+    /**
+     * Allows props to be passed for slider-max
+     */
+    maxProps?: React.ComponentProps<'span'>;
+    /**
+     * Allows props to be passed for slider-rail
+     */
+    railProps?: React.ComponentProps<'div'>;
+    /**
+     * Allows props to be passed for slider-track
+     */
+    trackProps?: React.ComponentProps<'div'>;
+    /**
+     * Allows props to be passed for slider-tick
+     */
+    tickProps?: React.ComponentProps<'span'>;
+    /**
+     * Allows props to be passed for slider-ticks
+     */
+    ticksProps?: React.ComponentProps<'div'>;
     /**
      * Defines the allowed behavior when moving Thumbs when multiple Thumbs are
      * shown. It controls if a Thumb movement should be limited to only move in

package/esm/core/Slider/Slider.js

@@ -79,6 +79,12 @@ export const Slider = React.forwardRef((props, ref) => {
     thumbProps,
     className,
     railContainerProps,
+    minProps,
+    maxProps,
+    railProps,
+    trackProps,
+    tickProps,
+    ticksProps,
     orientation = 'horizontal',
     ...rest
   } = props;
@@ -263,18 +269,27 @@ export const Slider = React.forwardRef((props, ref) => {
     if (Array.isArray(tickLabels)) {
       return React.createElement(
         Box,
-        { className: 'iui-slider-ticks' },
+        {
+          as: 'div',
+          ...ticksProps,
+          className: cx('iui-slider-ticks', ticksProps?.className),
+        },
         tickLabels.map((label, index) =>
           React.createElement(
             Box,
-            { as: 'span', key: index, className: 'iui-slider-tick' },
+            {
+              as: 'span',
+              ...tickProps,
+              key: index,
+              className: cx('iui-slider-tick', tickProps?.className),
+            },
             label,
           ),
         ),
       );
     }
     return tickLabels;
-  }, [tickLabels]);
+  }, [tickLabels, tickProps, ticksProps]);
   const generateTooltipProps = React.useCallback(
     (index, val) => {
       const outProps = tooltipProps ? tooltipProps(index, val, step) : {};
@@ -302,20 +317,33 @@ export const Slider = React.forwardRef((props, ref) => {
     minValueLabel &&
       React.createElement(
         Box,
-        { as: 'span', className: 'iui-slider-min' },
+        {
+          as: 'span',
+          ...minProps,
+          className: cx('iui-slider-min', minProps?.className),
+        },
         minValueLabel,
       ),
     React.createElement(
       Box,
       {
+        as: 'div',
         ref: containerRef,
-        className: cx('iui-slider-container', {
-          'iui-grabbing': undefined !== activeThumbIndex,
-        }),
-        onPointerDown: handlePointerDownOnSlider,
         ...railContainerProps,
+        className: cx(
+          'iui-slider-container',
+          {
+            'iui-grabbing': undefined !== activeThumbIndex,
+          },
+          railContainerProps?.className,
+        ),
+        onPointerDown: handlePointerDownOnSlider,
       },
-      React.createElement(Box, { className: 'iui-slider-rail' }),
+      React.createElement(Box, {
+        as: 'div',
+        ...railProps,
+        className: cx('iui-slider-rail', railProps?.className),
+      }),
       currentValues.map((thumbValue, index) => {
         const [minVal, maxVal] = getAllowableThumbRange(index);
         const thisThumbProps = thumbProps?.(index);
@@ -343,13 +371,18 @@ export const Slider = React.forwardRef((props, ref) => {
         sliderMax: max,
         values: currentValues,
         orientation: orientation,
+        ...trackProps,
       }),
       tickMarkArea,
     ),
     maxValueLabel &&
       React.createElement(
         Box,
-        { as: 'span', className: 'iui-slider-max' },
+        {
+          as: 'span',
+          ...maxProps,
+          className: cx('iui-slider-max', maxProps?.className),
+        },
         maxValueLabel,
       ),
   );

package/esm/core/Slider/Thumb.js

@@ -97,8 +97,8 @@ export const Thumb = (props) => {
       style: {
         ...style,
         ...(orientation === 'horizontal'
-          ? { left: `${lowPercent}%` }
-          : { bottom: `${lowPercent}%` }),
+          ? { insetInlineStart: `${lowPercent}%` }
+          : { insetBlockEnd: `${lowPercent}%` }),
       },
       className: cx('iui-slider-thumb', { 'iui-active': isActive }, className),
       role: 'slider',

package/esm/core/Slider/Track.d.ts

@@ -6,7 +6,7 @@ export type TrackProps = {
     sliderMax: number;
     values: number[];
     orientation: SliderProps['orientation'];
-};
+} & React.HTMLAttributes<HTMLDivElement>;
 /**
  * Track displays color segments above Rail. Which, if any, segments that are
  * colorized is based on `trackDisplayMode`.