v1.3.0
Mar 12, 2026
View as MarkdownGeneral Changes
- Warn when a component function is rendered directly (#4077)
- Reset
openMethodafter close transition (#4128) - Fire Space activation on
keydownin composite widgets (#4053) - Skip CSS-hidden items during keyboard navigation in composite widgets (#4195)
- Optimize hot paths in
useHoverhooks andsafePolygon(#4199) - Snap
--anchor-widthand--anchor-heightto device pixel grid (#4082) - Fix outside press dismissal when a component is portaled into a shadow DOM (#4230)
- Fix nested hoverable popups (#4206)
- Apply
data-base-ui-inertto highest-level node (#3955) - Fix portable types (#4058)
Accordion
- Add generic
Valuetyping (#4138)
Autocomplete
Avatar
- Remove fallback transition logic and prevent premature image display (#4110)
Button
- Avoid checking
disabledtwice inonKeyDownandonKeyUp(#4132)
Checkbox
- Add automatic
aria-labelledbysupport (#4142)
Combobox
- Avoid applying field attributes to input when it is inside popup (#4154)
- Preserve inline input on
Enterwhen nothing is highlighted (#4235) - Fix ARIA attributes during SSR (#4179)
- Fix wrapping in virtualized grid arrow-key navigation (#4164)
- Add
InputGrouppart (#3745) - Add support for a visually hidden close button and improve modal focus trapping (#4084)
- Add
Labelpart (#4167)
Context Menu
- Ignore
mouseupon non-Mac platforms (#3944)
Drawer
- Breaking change:
Draweris no longer marked as preview
Draweris now stable and should be imported as{ Drawer } from '@base-ui/react/drawer'(#4293) - Fix React 17 support (#4178)
- Include border in frontmost height variable (#4202)
- Improve touch selection (#4104)
- Preserve cross-axis scrolling during touch gestures (#4187)
- Prevent swipe dismissal when component is controlled (#4133)
- Add
SwipeAreapart (#4102) - Make
data-base-ui-swipe-ignoreexplicit for touch interactions (#4295) - Disable inheritance for swipe CSS variables (#4099)
Field
- Fix field validation when
Formerrors orinvalidprop are present at same time (#4112)
Menu
- Prevent
pointerleavefrom stealing focus from dialogs (#4125) - Optimize
pointer-eventsfor submenu hover interactions (#4231) - Fix
closeDelaynot being applied toMenu.SubmenuTrigger(#4134) - Implement content transitions with
Viewport(#4060)
Meter
- Fix label announcements in NVDA (#4200)
Navigation Menu
- Fix support for nested inline menus (#4198)
- Fix close propagation in nested hover menus (#4285)
- Close parent menus when nested link with
closeOnClickis clicked (#4276) - Fix duplicate
aria-orientation(#4309) - Fix delayed trigger switches in Safari (#4310)
Number Field
- Fix increment/decrement press
reasonvalues inonValueCommitted(#4259)
Popover
- Trap focus when
<Popover.Close>is rendered inside andmodalistrue, and add support for a visually hidden close button (#4084) - Fix nested hoverable popups (#3798)
Preview Card
- Fix nested hoverable popups (#3798)
Progress
- Fix label announcements in NVDA (#4200)
Radio Group
- Add automatic
aria-labelledbysupport (#4142)
Scroll Area
Select
- Fix hidden input
idfallback (#4135) - Fix
Valueplaceholder not rendering withRecorditems (#4137) - Fire
onClickduring drag-to-select (#3969) - Fix
itemstype definition for groups (#3884) - Fix
alignItemWithTriggerfallback with browser zoom (#4292) - Add
Labelpart (#4167)
Slider
Switch
- Add automatic
aria-labelledbysupport (#4142)
Tabs
- Re-render indicator position on tab resize (#4165)
Toast
Tooltip
- Add
closeOnClickprop (#4140)