github mui/base-ui v1.0.0-beta.5
on GitHub

latest release: v1.0.0-beta.6
pre-release17 hours ago

General changes

  • Breaking change: Replace trackAnchor with disableAnchorTracking.
    If you were using trackAnchor={false}, be sure to update your usage to disableAnchorTracking instead. (#3188) by @mnajdova
  • Breaking change: Rename loop to loopFocus (#3186) by @mnajdova
  • Fix type portability (#2912) by @atomiks
  • Accept a function for the style prop (#3038) by @mnajdova
  • Create portal elements inside React (#2889) by @atomiks
  • Avoid applying hidden attribute to indicator elements when they specify keepMounted and are invisible (#3228) by @atomiks
  • Fix crash in Next.js 16 when accessing render.props.ref (#3231) by @atomiks

Accordion

  • Breaking change: Change multiple prop to be false by default and add a demo (#3141) by @mnajdova
  • Fix flaky exit transition (#3101) by @atomiks

Alert Dialog

  • Fix initialFocus as function being called on close (#2949) by @atomiks
  • Support detached triggers (#2974) by @michaldudak
  • Place overflow: hidden on <body> for overlay scrollbars by default. Avoids sticky elements shifting if <body> has an overflow style specified. (#3083) by @atomiks
  • Add <AlertDialog.Viewport> part (#2808) by @atomiks

Autocomplete

  • Breaking change: Refactor alwaysSubmitOnEnter to submitOnItemClick prop.
    If you were using alwaysSubmitOnEnter, be sure to update your usage to submitOnItemClick instead. (#3018) by @atomiks
  • Prevent blocking filtering while composing text on Android (#2944) by @atomiks
  • Add empty state to List.State (#2934) by @atomiks
  • Fix initialFocus as function being called on close (#2949) by @atomiks
  • Add role="combobox" to <Autocomplete.Trigger> if <Autocomplete.Input> is inside Popup (#2973) by @atomiks
  • Fix stale onItemHighlighted data when filtering with autoHighlight (#2829) by @atomiks
  • Add empty and side styling attributes on <Autocomplete.Input> (#2926) by @atomiks
  • Fix <Autocomplete.Value> component return type for React 17 (#3050) by @atomiks
  • Support autoHighlight: "always", and add keepHighlight, highlightItemOnHover props (#2976) by @atomiks
  • Keep focus on input when pressing list element (#3092) by @atomiks
  • Allow Esc to bubble if <Autocomplete.Empty> is not used (#2935) by @atomiks
  • Add dialog role to popup when input is inside (#3213) by @atomiks

Button

Checkbox

  • Breaking change: Render root as <span> instead of <button> (#3205) by @mj12albert

Collapsible

Combobox

  • Take into account isItemEqualToValue when selecting an option in multiple mode (#2893) by @epr3
  • Move CompositeList to List component to make Input work with composites (#2883) by @chuganzy
  • Fix onValueChange type inference when value is unspecified (#2897) by @atomiks
  • Fix required form submission with multiple values (#2925) by @atomiks
  • Fix Home/End Input scroll in Chrome/Safari (#2928) by @atomiks
  • Prevent blocking filtering while composing text on Android (#2944) by @atomiks
  • Add empty state to List.State (#2934) by @atomiks
  • Fix initialFocus as function being called on close (#2949) by @atomiks
  • Add role="combobox" to <Combobox.Trigger> if <Combobox.Input> is inside Popup (#2973) by @atomiks
  • Fix Field control ref when input is inside popup (#2971) by @atomiks
  • Fix stale onItemHighlighted data when filtering with autoHighlight (#2829) by @atomiks
  • Add empty and side styling attributes on <Combobox.Input> (#2926) by @atomiks
  • Fix <Combobox.Value> component return type for React 17 (#3050) by @atomiks
  • Fix input value derivation on value and items prop updates (#3067) by @atomiks
  • Support autoHighlight: "always", and add keepHighlight, highlightItemOnHover props (#2976) by @atomiks
  • Keep focus on input when pressing list element (#3092) by @atomiks
  • Fix support of dialog + combobox pattern (#3049) by @atomiks
  • Support drag-to-select (#3167) by @atomiks
  • Allow Esc to bubble if <Combobox.Empty> is not used (#2935) by @atomiks
  • Fix stuck filtering with differing stringifiers (#3201) by @atomiks
  • Add dialog role to popup when input is inside (#3213) by @atomiks

Context Menu

  • Add open state to <ContextMenu.Trigger> (#3195) by @atomiks
  • Fix ignored anchor prop on <ContextMenu.Positioner> (#3202) by @atomiks

Dialog

  • Breaking change: Replace dismissible with disablePointerDismissal.
    If you were using dismissible={false}, replace it with disablePointerDismissal. (#3190) by @mnajdova
  • Fix initialFocus as function being called on close (#2949) by @atomiks
  • Support detached triggers (#2974) by @michaldudak
  • Place overflow: hidden on <body> for overlay scrollbars by default. Avoids sticky elements shifting if <body> has an overflow style specified. (#3083) by @atomiks
  • Add <Dialog.Viewport> part and scrollable demos on docs (#2808) by @atomiks

Field

  • Breaking change: Add onSubmit validation mode and make it the default over onBlur.
    Fields that use non-required attribute validation no longer validate the control on blur. Instead, validation first occurs onSubmit, and afterwards revalidation occurs onChange. (#3013) by @mj12albert
  • Add dirty and touched props (#2950) by @mj12albert
  • New <Field.Item> part (#2810) by @mj12albert
  • Fix validationMode="onChange" not clearing custom error state (#3048) by @mj12albert
  • Fix external onChange validation mode errors (#3137) by @atomiks

Form

  • Breaking change: The onClearErrors prop has been removed.
    Errors from the errors prop are always cleared when the value changes. (#3136) by @mj12albert
  • Add onSubmit validation mode.
    Additionally, validationMode can be set on <Form>. (#3013) by @mj12albert
  • Add onFormSubmit callback (#3131) by @mj12albert

Menu

  • Breaking change: Support detached triggers.
    openOnHover, delay, and closeDelay props have been moved from <Menu.Root> to <Menu.Trigger>.
    Additionally, menus now must have at least one <Menu.Trigger> element. (#3170) by @michaldudak
  • Ignore disabled item on initial focusing (#2604) by @mnajdova
  • Fix stealing focus from dialogs on close (#2920) by @atomiks
  • Place overflow: hidden on <body> for overlay scrollbars by default. Avoids sticky elements shifting if <body> has an overflow style specified. (#3083) by @atomiks

Navigation Menu

Number Field

Popover

  • Breaking change: Support detached triggers and multiple triggers per popover.
    openOnHover, delay, and closeDelay props have been moved from <Popover.Root> to <Popover.Trigger>. (#2336) by @michaldudak
  • Fix initialFocus as function being called on close (#2949) by @atomiks
  • Fix swiping or scrolling on nested popup dismissing popover on touch (#3011) by @atomiks
  • Place overflow: hidden on <body> for overlay scrollbars by default. Avoids sticky elements shifting if <body> has an overflow style specified. (#3083) by @atomiks

Preview Card

  • Breaking change: Move delay props to trigger.
    If you were using delay or closeDelay props, be sure to move them to from <PreviewCard.Root> to the <PreviewCard.Trigger> component. (#3182) by @atomiks

Radio Group

  • Breaking change: Render root as <span> instead of <button> (#3205) by @mj12albert

Scroll Area

  • Breaking change: Improve CSS vars performance.
    The CSS variables are now on the <ScrollArea.Viewport> part, not <ScrollArea.Root>, and inheritance is disabled for all child elements (or pseudo-elements). Children must manually opt in using --scroll-area-[variable-name]: inherit. (#3156) by @atomiks

Select

  • Breaking change: Make the trigger native button by default.
    The trigger now renders a <button> element, be sure to adjust your code if necessary. (#3177) by @mnajdova
  • Add open state type on Select.Icon interface (#2919) by @komkanit
  • Fix onValueChange type inference when value is unspecified (#2897) by @atomiks
  • Fix required form submission with multiple values (#2925) by @atomiks
  • Avoid re-rendering on popup height expansion (#2972) by @atomiks
  • Place overflow: hidden on <body> for overlay scrollbars by default. Avoids sticky elements shifting if <body> has an overflow style specified. (#3083) by @atomiks
  • Add data-placeholder attribute (#2737) by @seongminn

Slider

  • Breaking change: Add thumbCollisionBehavior prop.
    In range sliders, moving a thumb with a pointer will now push other thumbs it collides with to avoid blocking drag movements by default (the default value is push).
    The value swap was also added, which allows thumbs to be dragged past each other when they collide.
    Lastly, the value none is the same as the previous behavior, where thumbs can't be dragged past one another.
    Keyboard interactions always use none behavior. (#2856) by @atomiks
  • Granular change reasons (#3132) by @atomiks

Switch

  • Breaking change: Render root as <span> instead of <button> (#3205) by @mj12albert

Tabs

  • Breaking change: Fix selected/active state naming consistency. (#3024) by @atomiks
    • Renamed [data-selected] to [data-active] in <Tabs.Tab>
    • Removed [data-highlighted] (:focus-visible was already the recommendation in styles)
    • selectedTabPosition/selectedTabSize are now activeTabPosition/activeTabSize in Tabs.Indicator.State
  • Breaking change: Change activateOnFocus to false.
    If you need your Tabs to activate on focus, be sure to add activateOnFocus prop. (#3176) by @mnajdova
  • Fix Next.js 16 error from Math.random id generation (#3051) by @atomiks
  • Fix indicator sizing and offsets (#3214) by @atomiks

Toast

  • Allow React.ReactNode for title/description properties (#2929) by @atomiks
  • Add ability to anchor to an element (#3096) by @atomiks

Toolbar

  • Breaking change: The cols prop has been removed.
    This prop was not supposed to be exposed. (#3133) by @mj12albert

Tooltip

  • Breaking change: Support detached triggers.
    delay and closeDelay props have been moved from <Tooltip.Root> to <Tooltip.Trigger>. (#3071) by @michaldudak
  • Breaking change: Change hoverable to disableHoverablePopup.
    In case you need to disable the hoverable popup behavior, be sure to add the disableHoverablePopup prop. (#3178) by @mnajdova
  • Fix data-instant ending transition of same tooltip (#2962) by @atomiks

All contributors of this release in alphabetical order: @atomiks, @brianle1301, @brijeshb42, @chuganzy, @dav-is, @epr3, @fredericoo, @Janpot, @komkanit, @LukasTy, @michaldudak, @mj12albert, @mnajdova, @oliviertassinari, @romgrk, @seongminn, @sukvvon, @ZeeshanTamboli

Check out latest releases or
releases around mui/base-ui v1.0.0-beta.5

Don't miss a new base-ui release

NewReleases is sending notifications on new releases.

Get notifications