October 2, 2025 Release

Happy fall! This release brings some long-awaited features, including multi-selection in React Aria Select and enhanced animation support across our components. For example, React Aria Disclosure now provides —-disclosure-panel-width and —-disclosure-panel-height CSS variables to help you implement smooth animations. We've also added a new SelectionIndicator component that can be used within components that support single selection (e.g., GridList, ListBox, Menu, RadioGroup, Table, Tabs, TagGroup, ToggleButtonGroup, Tree) to animate selection changes.

In addition, this release includes important bug fixes such as improved collection handling with React Suspense, as well as enhancements to React Aria Modal, particularly for those using iOS 26, which also includes fixing the pinch zooming and text selection on mobile. Lastly, onAction can now be used on a ComboBoxItem to perform a custom action when the item is selected, enabling the ability to add a “Create” option for the current input value.

Multi-Selection in React Aria Select:#

In order to support multi-selection in React Aria Select, we are updating the API from selectedKey to value. The deprecated API is supported for backward compatibility, but only supports single selection. Please see our docs to see more on how to implement multi-selection in Select.

Enhancements#


Fixes#


  • Color
    • Fix ColorLoupe position in ColorSlider for RTL locales - @chirokas - PR
  • Collection
    • Prevent crash in React Aria collections when used with Suspense and useTransition - @LFDanLu - PR
    • Fix collection dirty node tracking with Suspense - @devongovett - PR
  • Date and Time
    • Fix the day the week starts with when specifiying ISO 8601 in the locale - @snowystinger - PR, PR
    • Fix date parsing when there are seconds in the offset - @LFDanLu - PR
    • Ensure isReadonly applies to all non-literal date segments - @Persists - PR
    • Add isReadOnly to the render props in React Aria DateField/DatePicker - @Mr-Heidari - PR
  • Disclosure
    • Don't display DisclosurePanel content when it is not expanded and disabled - @LFDanLu - PR
  • Focus Management
    • Fix keyboard navigation to skip over hidden inputs to next available input - @snowystinger - PR
    • Fix unexpected onBlur events in React Aria Checkbox and Radio - @snowystinger - PR
  • GridList
    • Fix accessibiilty violations in GridList sections - @yihuiliao - PR
  • Layout and Positioning
    • Make scrollIntoView respect scroll-margin - @nwidynski - PR
    • Fix DOMLayoutDelegate miscalculation of item & visible rects - @nwidynski - PR
    • Fix overlay positioning when animation starts on first render - @devongovett - PR
  • Menu
    • Show checkboxes for selected items when ContextualHelpTrigger isUnavailable is set to false - @reidbarber - PR
  • NumberField
    • Pass disabled prop to hidden input in React Aria NumberField - @tklepzig - PR
  • Tree
    • Speed up flattening when expandening keys in Tree Collection - @snowystinger = PR
  • Miscellaneous
    • Avoid triggering onClick on disabled links - @lixiaoyan - PR

Docs#


  • Clarify React Aria Toast close button placement - @reidbarber - PR

Under Construction#


  • Autocomplete
    • Automatically detect if wrapped collection supports virtual focus - @LFDanLu - PR
    • Properly allow user to keyboard edit the Autocomplete input field when collection becomes empty - @LFDanLu - PR