Native Solid 2 fork. Original documentation and designs © WorkOS; historical posts retain their original context.

Releases

July 20, 2026

Dialog

• Fixed broken ARIA references in Dialogs where title or description elements are not rendered. – #4031

Slider

• Fixed a bug where onValueCommit was not called when a slider thumb was dragged across another thumb. – #3832

Toast

• Fixed Toast removing non-focused toasts when pressing Escape. – #4005

Tooltip

• Fixed a bug where Tooltip.Content children were mounted to the DOM twice. – #4029

Other updates

• Fixed overriding inline animation style in Popper.Content. – #4046
• Improved tree-shaking so bundlers can drop unused components. Component parts are now marked /* @__PURE__ */ and use named render functions instead of Component.displayName = ... assignments, which previously prevented dead-code elimination with some bundlers. – #4038
• Widened the virtualRef prop type to allow RefObject<Measurable | null> in popover components. – #4034
• Fixed dev-only checks with conditional exports so dev warnings are dropped from production builds. – #4039
• Added per-primitive subpath entry points so each primitive can be imported directly, eg. import { Accordion } from "radix-ui/accordion" or import * as Accordion from "radix-ui/accordion". This mirrors the namespaced exports available from the root radix-ui entry point. – #4020
• Fixed a bug where updating a Checkbox, Switch, or RadioGroup value programmatically (eg. a "select all" control) while inside a <form> would dispatch a click event from the hidden bubble input that propagated to ancestor onClick handlers. – #4028

July 6, 2026

Other updates

• Added CSS custom properties for Navigation Menu item indicators' translate values.
• Fixed a bug in Dismissable Layer causing background nested popovers to close all layers on outside click. – #3987
• Fixed runtime errors for Form.Message, Form.Control, Form.Label, and Form.ValidityState when they are rendered outside of Form.Field components. – #3992
• Fixed a bug in form control components to ensure their values are updated when their associated form is reset. This affects RadioGroup, Slider, Select, and Switch. – #3958
• Fixed menu items, tab triggers, toolbar links, and select items intercepting Space/Enter keys that originate from focusable descendants. – #3999
• Fixed a bug where calling an event handler without an argument would throw, preventing successive event handlers from being called. This affected all components that accept event handlers with internal implementations. – #4001
• Fixed a bug in Context Menu to ensure that the menu properly re-anchors to the latest pointer position when re-triggered in its open state. – #4003
• Fixed stale onEscapeKeyDown/onDismiss handlers on React 19.2. – #4015
• Fixed items in a Roving Focus Group not being auto-focused on mount within a Focus Scope component. – #4002
• Fixed a regression in Dismissable Layer originating from a bug in React's useEffectEvent. – #4015
• Fixed --radix-scroll-area-corner-width and --radix-scroll-area-corner-height not resetting to 0 when a corner is removed. Previously these values would stick around and leave a permanent gap on the remaining scrollbar. – #4009
• Fixed a bug in Slider where stepping with the keyboard would skip a valid value when the current value is off the step grid. Stepping now snaps to the next step-aligned value in the direction of travel, matching native <input type="range"> behavior. – #4006

June 30, 2026

• Cleared the close timer when unmounting Toast components to prevent memory leaks and errors in test environments. – #3794
• Fixed infinite re-render loop in React 19 caused by unstable composed ref callback references. – #3967 – #3968
• Removed global React.CSSProperties augmentation from emitted declaration files. – #3983

June 6, 2026

This release introduces new composition APIs, a controlled Context Menu, and a number of bug fixes and performance improvements across primitives.

Context Menu

Added support for a controlled open prop on ContextMenu.Root. This is intended for reading the open state and closing the menu programmatically. We discourage opening the menu programmatically, since opening it depends on user interaction to position the menu correctly.

import { createSignal } from "solid-js";
import { ContextMenu } from "@radix-solid/primitives";
function ControlledContextMenu() {
  const [open, setOpen] = createSignal(false);
  return <ContextMenu.Root open={open()} onOpenChange={setOpen}>
			<ContextMenu.Trigger asChild>{target => target("button", { children: "Open" })}</ContextMenu.Trigger>
			<ContextMenu.Content>
				<button type="button" onClick={() => setOpen(false)}>
					Close me
				</button>
				<ContextMenu.Item>Item 1</ContextMenu.Item>
				<ContextMenu.Item>Item 2</ContextMenu.Item>
			</ContextMenu.Content>
		</ContextMenu.Root>;
}

We also fixed a bug where submenus remained expanded after re-opening on long-press touch events.

New unstable composition parts

Several form-control primitives now expose their previously internal composition, so you can directly access and recompose the visually hidden inputs they render for form submission. Each component continues to render these parts by default, and the new parts are exported with the unstable_ prefix.

• Radio Group — unstable_ItemProvider, unstable_ItemTrigger, and unstable_ItemBubbleInput
• Select — unstable_Provider and unstable_BubbleInput
• Slider — unstable_ThumbProvider, unstable_ThumbTrigger, and unstable_BubbleInput
• Switch — unstable_Provider, unstable_Trigger, and unstable_BubbleInput

import { Switch } from "@radix-solid/primitives";
function ExampleSwitch() {
  return <Switch.unstable_Provider>
			<Switch.unstable_Trigger>
				<Switch.Thumb />
			</Switch.unstable_Trigger>
			{/* the hidden input is now exposed and can be omitted if not needed */}
			<Switch.unstable_BubbleInput />
		</Switch.unstable_Provider>;
}

Select

• Added support for presence-based exit animations.
• Fixed the bubble hidden input so that it submits an empty string when no value is selected.
• Fixed Select closing unexpectedly after touch-scrolling its content when rendered inside an open shadow DOM.
• Fixed Select.Value logging invalid prop errors when used with both asChild and a placeholder.

Slider

• Added focusVisible support for non-keyboard interactions with slider thumbs, for progressively enabling styles using :focus-visible alongside programmatic focus management.
• Fixed a bug where very small step values made the thumbs unresponsive.
• Fixed focus bugs for sliders in a scrollable context.

Slot

• Added support for nested Slottable items via a render prop. This allows a slotted element to be wrapped while still merging Slot props and refs onto it.
• Fixed an infinite re-render loop in React 19 caused by Slot creating a new ref callback on every render.
• Improved error messages for invalid slot children.

Dialog

• Fixed a bug where iOS text selection and editing on HTML inputs within dialogs were broken.
• Fixed a bug causing disabled pointer events in closed dialogs.

One-Time Password Field

• Fixed pasting in environments that do not support the legacy "Text" clipboard format by reading the pasted value as "text/plain".
• Fixed issues with focus management in React 19.2+.
• Ensured that pasted values exceeding the field length are truncated.

Tooltip

• Fixed a runtime error when an event target is a non-Node entity.
• Fixed a bug so that skipDelayDuration={0} works as expected. Previously, the open delay could still be skipped when moving between triggers.

Other updates

• Added an align prop to the SubContent part of Dropdown Menu, Context Menu, and Menubar to control the direction the submenu appears from its anchor item.
• Added an announcerContainer prop to Toast.Provider so you can specify a container for toast announcements.
• Exposed data-side and data-align attributes on the Popper anchor element.
• Added an align prop to Menu.SubContent.
• Fixed a missing data-state attribute for Scroll Area scrollbars.
• Fixed a "Maximum update depth exceeded" bug for pages with a large number of popper instances, as well as a similar bug in Presence under React 19.
• Now uses React's built-in useSyncExternalStore (React 18+) instead of the CJS-only shim, which previously crashed ESM-only browser bundles when importing some components.
• Fixed triggers referencing non-existent elements via aria-controls when their content is removed from the DOM – #3243.
• Improved focus-guard performance when opening overlays by caching the shared guard pair and only writing to the DOM when their edge position changes.
• Added missing use client directives to modules causing errors in RSC.

August 13, 2025

One-Time Password Field

• Fixed a bug so that all input elements are disabled when the Root component is disabled.
• Fixed a bug with iOS Chrome autocomplete – #3641.

Other updates

• Fixed a Popper bug causing infinite render loops.
• Ensured the animationend event is handled correctly when the keyframe has escapable characters – #2763.
• Fixed how Slot components interact with lazy React components in React 19. In the case of a lazy component instance, the resulting promise is now consumed to render the desired component.
• Fixed several Toast accessibility issues, including removing aria-hidden from focusable elements, removing role=status from the list item element, and removing a redundant default aria-atomic.
• Added displayName to internal context objects for improved debugging.

May 20, 2025

• Dependency maintenance release with no user-facing API changes.

May 6, 2025

• Dependency maintenance release with no user-facing API changes.

May 5, 2025

This release introduces a brand new primitive in preview: PasswordToggleField.

This new primitive provides components for rendering a password input alongside a button to toggle its visibility. Aside from its primary functionality, it also includes:

• Returning focus to the input when toggling with a pointer
• Maintaining focus when toggling with keyboard or virtual navigation
• Resetting visibility to hidden after form submission to prevent accidental storage
• Implicit accessible labeling for icon-based toggle buttons

This API is currently unstable, and we hope you'll help us test it out! Import the primitive using the unstable_ prefix.

import { unstable_PasswordToggleField as PasswordToggleField } from "@radix-solid/primitives";
export function PasswordField() {
  return <PasswordToggleField.Root>
			<PasswordToggleField.Input />
			<PasswordToggleField.Toggle>
				<PasswordToggleField.Icon visible={target => target(EyeOpenIcon, {})} hidden={target => target(EyeClosedIcon, {})} />
			</PasswordToggleField.Toggle>
		</PasswordToggleField.Root>;
}

Other updates

• Add unstable Provider, Trigger and BubbleInput parts to Checkbox (#3459)
• Update default input type to text and pass to the underlying input element (#3510)

April 22, 2025

• Update the dependency for use-sync-external-store to ensure entrypoint is valid – #3491

April 17, 2025

This release introduces a brand new primitive in preview: OneTimePasswordField.

This new group of components are designed to implement a common design pattern for one-time password fields displayed as separate input fields for each character. This UI is deceptively complex to implement in such a way that interactions follow user expectations. The new primitive handles all of this complexity for you, including:

• Keyboard navigation mimicking the behavior of a single input field
• Overriding values on paste
• Password manager autofill support
• Input validation for numeric and alphanumeric values
• Auto-submit on completion
• Focus management
• Hidden input to provide a single value to form data

As this is a preview release, the API is currently unstable. We hope you'll help us test it out and let us know how it goes.

Import the primitive using the unstable_ prefix.

import { unstable_OneTimePasswordField as OneTimePasswordField } from "@radix-solid/primitives";
export function Verify() {
  return <OneTimePasswordField.Root>
			<OneTimePasswordField.Input />
			<OneTimePasswordField.Input />
			<OneTimePasswordField.Input />
			<OneTimePasswordField.Input />
			<OneTimePasswordField.Input />
			<OneTimePasswordField.Input />
			<OneTimePasswordField.HiddenInput />
		</OneTimePasswordField.Root>;
}

Other updates

• All form controls with internal bubble inputs now use the Radix Primitive component by default. This will allow us to expose these components in a future release so users can better control this behavior in the future.
• Minor improvements to useControllableState to enhance performance, reduce surface area for bugs, and log warnings when misused

April 8, 2025

• Improved rendering performance for the Tooltip provider – #2720
• Ensure Tooltip is closed when pointerdown is fired on the trigger – #3380
• Add support for crossOrigin in Avatar images – #3261
• Fix Avatar flashing when an image is already cached – #3008
• Improve displayName for better debugging of slottable components – #3441

February 5, 2025

• Updated dependencies to remove peer dependency warnings for react and react-dom – #3350
• Skip forwarding refs to SlotClone when the child is a Fragment – #3229

January 22, 2025

• Added a radix-ui package that exposes the latest version of all Radix Primitives from a single place. This tree-shakable entrypoint makes it easier to bring in whatever components you need and keep them up-to-date without worrying about conflicting or duplicate dependencies.
• Updated aria-hidden and react-remove-scroll dependencies for the following components:
  • Alert Dialog
  • Context Menu
  • Dialog
  • Dropdown Menu
  • Hover Card
  • Menubar
  • Navigation Menu
  • Popover
  • Select
  • Toast
  • Tooltip

October 1, 2024

• Fix allowPinchZoom bug for trackpad users – #3127

• Check for referrerPolicy when checking the image loading status – #2772

• Fix a bug where defaultChecked unexpectedly changed for uncontrolled checkboxes – #2135
• Forward the form prop to the bubble input element to fix non-parent form submissions – #3161

• Fix allowPinchZoom bug for trackpad users – #3127

• Forward the form prop to the bubble input element to fix non-parent form submissions – #3161

• Fix asChild prop not working as expected on the Viewport – #2945
• Update internal styles to fix other issues with Viewport – #2945

• Fix error thrown when items are initially undefined – #2623
• Fix several bugs for touch devices – #2939
• Forward the form prop to the bubble input element to fix non-parent form submissions – #3161
• Fix position bug where popover may start off-screen for long items – #3149

• Forward the root form prop to each thumb's bubble input element to fix non-parent form submissions – #3161

• Forward the form prop to the bubble input element to fix non-parent form submissions – #3161

• Fix incorrect focus when hotkey is an empty array – #2491

June 28, 2024

• Export CheckedState type

• Export TooltipProviderProps type

June 21, 2024

• Add a missing internal utility to package.json. The corresponding packages that provide a Portal part also received a patch update. – #2966

June 19, 2024

Released minor versions for all primitives with the following changes:

• Full React 19 compatability – #2952
• Full RSC compatibility – #2923
• Internal build tooling changes – #2922 – #2931
• Update and pin react-remove-scroll dependency version to avoid double scrollbar bugs in edge cases – #2776
• Don’t scroll menu items in response to hover – #2451
• Make sure that components that close on Escape key press capture the corresponding keyboard event. This way you can call stopPropagation in onEscapeKeyDown if you need more control rendering Radix components within another component that closes on Escape key press.
• Make sure that components with roving focus do not interfere with browser or system hotkeys, such as back navigation – #2739
• Make sure that components that support hideWhenDetached prop do not allow interactions with hidden content – #2743 – #2745

• Log an error when an accessible title via the Dialog.Title part is missing – #2948
• Log a warning when an accessible description via the Dialog.Description part is missing – #2948

• Make sure that the component doesn’t interfere when clicking on the spinner of a number input

• Remove unsupported disableOutsidePointerEvents prop

• Fix hydration error in SSR on the initial render – #2923

• Explicitly allow value={undefined} to represent an indeterminate state, matching the current practical behaviour – #2947

• Add nonce prop to be able to pass CSP nonce to the inline styles – #2728

• Add nonce prop to be able to pass CSP nonce to the inline styles – #2728

September 25, 2023

• Fix pointer-events issue when clicking outside – #2177
• Fix Portal part types lying about accepting DOM props – #2178

• Prevent image flash – #2340

• Fix pointer-events issue when clicking outside – #2177
• Fix Portal part types lying about accepting DOM props – #2178

• Fix pointer-events issue when clicking outside – #2177
• Fix Portal part types lying about accepting DOM props – #2178

• Fix pointer-events issue when clicking outside – #2177
• Fix Portal part types lying about accepting DOM props – #2178

• Fix pointer-events issue when clicking outside – #2177
• Fix Portal part types lying about accepting DOM props – #2178

• Fix pointer-events issue when clicking outside – #2177
• Fix Portal part types lying about accepting DOM props – #2178

• Fix pointer-events issue when clicking outside – #2177
• Fix Portal part types lying about accepting DOM props – #2178

• Fix pointer-events issue when clicking outside – #2177
• Fix Portal part types lying about accepting DOM props – #2178
• Fix Popover nested inside Dialog not opening – #2182

• Add scroll-behavior: smooth compatibility – #2175

• [Breaking] Add ability to reset to placeholder using "" value. Note that this is only a breaking change if you were using an option with a value of "". – #2174
• Fix pointer-events issue when clicking outside – #2177
• Fix Portal part types lying about accepting DOM props – #2178

• Fix pointer-events issue when clicking outside – #2177

• Fix pointer-events issue when clicking outside – #2177
• Fix Portal part types lying about accepting DOM props – #2178
• Fix issue with boundary padding calculations – #2185
• Add option to always re-position Content on the fly – #2092

May 26, 2023

This release ensures all of our primitives are ESM compatible. We have also updated to the latest version of Floating UI for all of our popper-positioned primitives.

• Improve ESM compatibility – #2130
• Fix possible upstream compiler errors (@types/react phantom dependency) – #1896

• Position content correctly when matching trigger size – #1995

• Prevent non-modal dialog from re-opening when closing using trigger in Safari – #2110
• Ensure focus trapping is maintained when the focused item is deleted – #2145

• Position content correctly when matching trigger size – #1995

• Position content correctly when matching trigger size – #1995

• Position content correctly when matching trigger size – #1995

• Do not close when clicking items and meta key is down – #2080

• Position content correctly when matching trigger size – #1995
• Prevent non-modal popover from re-opening when closing using trigger in Safari – #2110
• Ensure --radix-popper-available-width is calculated correctly when using collisionBoundary – #2032

• Position content correctly when matching trigger size – #1995
• Improve scroll buttons touch screen support – #1771

• Clamp thumb position within range – #1988

• Ensure Slot can be used in a React Server Component – #2116

• Position content correctly when matching trigger size – #1995
• Improve large content hoverability – #2155

March 8, 2023

This release introduces a brand new primitive in preview: Form.

• New primitive – #1998

February 24, 2023

• Reset checkbox state when form is reset – #1733

• Expose new CSS custom properties to enable size constraints – #1942
• Don't exit fullscreen mode when pressing escape to dismiss from submenu – #1752
• Relax onCheckedChange type on ContextMenu.CheckboxItem – #1778

• Expose new CSS custom properties to enable size constraints – #1942
• Don't exit fullscreen mode when pressing escape to dismiss from submenu – #1752
• Relax onCheckedChange type on DropdownMenu.CheckboxItem – #1778

• Expose new CSS custom properties to enable size constraints – #1942

• Expose new CSS custom properties to enable size constraints – #1943
• Don't exit fullscreen mode when pressing escape to dismiss from submenu – #1752
• Relax onCheckedChange type on Menubar.CheckboxItem – #1778

• Expose new CSS custom properties to enable size constraints – #1942

• Expose new CSS custom properties to enable size constraints – #1942

January 17, 2023

This release introduces a brand new primitive: Menubar. It also adds support for a highly requested feature for Select: the ability to position the content in a similar way to Popover or DropdownMenu.

• Add horizontal orientation support with new orientation prop, as well as RTL support with dir – #1850

• Fix consistency issue with RTL positioning – #1890

• Fix consistency issue with RTL positioning – #1890

• Fix consistency issue with RTL positioning – #1890

• New primitive – #1846

• Fix consistency issue with RTL positioning – #1890

• Add position prop to Select.Content to enable popper positioning – #1853

• Fix consistency issue with RTL positioning – #1890

December 14, 2022

• Add disabled prop to ContextMenu.Trigger – #1746

November 15, 2022

• Fix invalid pointerId in Cypress when running Firefox – #1753

October 17, 2022

• Fix initial animation playback in Firefox and Safari – #1710

• Fix issue with textarea elements not being scrollable in Firefox – #1550

• Fix initial animation playback in Firefox and Safari – #1710

• [Breaking] Add support for indeterminate state on ContextMenu.CheckboxItem. Note that this is only a breaking change if you are currently using the CheckboxItem part and your codebase is written in TypeScript. – #1624

• Fix issue with textarea elements not being scrollable in Firefox – #1550

• [Breaking] Add support for indeterminate state on DropdownMenu.CheckboxItem. Note that this is only a breaking change if you are currently using the CheckboxItem part and your codebase is written in TypeScript. – #1624
• Correctly pair DropdownMenu.Trigger open state with aria-expanded when closed – #1644
• Fix issue with eager selection of items when using asChild – #1647
• Fix issue with dismissing when the component is used in a separate popup window – #1677

• Improve text selection experience – #1692

• [Breaking] Remove useLabelContext and support for fully custom controls. For native labelling to work, ensure your custom controls are based on native elements such as button or input. – #1686
• Improve native behavior by using the native label element – #1686

• Prevent menu from re-opening with the pointer after being dismissed with escape – #1579
• Add delayDuration and skipDelayDuration props to NavigationMenu.Root. Note that by default, triggers now have a brief delay before opening in order to improve UX, this can be modified using the props provided. – #1716

• Add disabled prop to RadioGroup.Root – #1530
• Fix issue where RadioGroup.Root was focusable when all items were disabled – #1530

• Add disabled prop to Select.Root – #1699
• Add required prop to Select.Root – #1598

• Add ability to visually invert the slider using the new inverted prop on Slider.Root – #1695
• Add onValueCommit prop to Slider.Root to better handle discrete value changes – #1696

• Stop eagerly creating callback props – #1713

• Fix regression with screen readers announcing as "group" rather than "status" – #1556
• Fix regression with ref assignments on child elements returning null – #1668
• Add onPause and onResume props to Toast.Root – #1669
• Fix timer reset issue which would cause toasts to dismiss early in some cases – #1682

• Prevent Toolbar.Item click handlers firing twice – #1526

• Ensure tooltip doesn't open if interacting with the trigger before the open timer expires – #1693

July 21, 2022

With this release, we start following semantic versioning strictly. All primitives are now versioned 1.0.0.

We also move the Select, Toast and NavigationMenu from preview to stable.

• Improve support for React 18 – #1329
• [Breaking] Improve RTL performance. You need to use DirectionProvider if you were relying on dir attribute inheritance from document (or any element). – #1119

• [Breaking] Remove allowPinchZoom prop, now defaults to true – #1514
• Improve compatibility with JS animation libraries with forceMount on AlertDialog.Portal – #1075
• Fix regressions with page interactivity while/after closing dialog – #1401

• [Breaking] Improve indirect nesting of context menus. Submenus must now be created using explicit parts. – #1394
• [Breaking] Remove allowPinchZoom prop, now defaults to true – #1514
• [Breaking] Add new Portal part. To avoid regressions, use this part if you want portalling behavior. Note that z-index isn't managed anymore so you have full control of layering. – #1429
• [Breaking] Remove offset on Arrow part – #1531
• [Breaking] Rename collisionTolerance to collisionPadding on Content part and accepts a number or a padding object – #1531
• Fix issue with native context menu appearing in React 18 – #1378
• Add data-highlighted attribute to support styling – #1388
• Add data-state attribute to Trigger part – #1455
• Add collisionBoundary, arrowPadding, sticky, hideWhenDetached props on Content part – #1531

• [Breaking] Remove allowPinchZoom prop, now defaults to true – #1514
• Improve compatibility with JS animation libraries with forceMount on Dialog.Portal – #1075
• Fix regressions with page interactivity while/after closing dialog – #1401

• [Breaking] Improve indirect nesting of dropdown menus. Submenus must now be created using explicit parts. – #1394
• [Breaking] Remove allowPinchZoom prop, now defaults to true – #1514
• [Breaking] Add new Portal part. To avoid regressions, use this part if you want portalling behavior. Note that z-index isn't managed anymore so you have full control of layering. – #1429
• [Breaking] Remove offset on Arrow part – #1531
• [Breaking] Rename collisionTolerance to collisionPadding on Content part and accepts a number or a padding object – #1531
• Add data-highlighted attribute to support styling – #1388
• Prevent escape key from exiting fullscreen mode in Firefox & Safari – #1423
• Add collisionBoundary, arrowPadding, sticky, hideWhenDetached props on Content part – #1531

• [Breaking] Add new Portal part. To avoid regressions, use this part if you want portalling behavior. Note that z-index isn't managed anymore so you have full control of layering. – #1426
• [Breaking] Remove offset on Arrow part – #1531
• [Breaking] Rename collisionTolerance to collisionPadding on Content part and accepts a number or a padding object – #1531
• Add collisionBoundary, arrowPadding, sticky, hideWhenDetached props on Content part – #1531

• Ensure menu closes after clicking NavigationMenu.Link – #1347
• Add onSelect prop to NavigationMenu.Link – #1372

• [Breaking] Remove allowPinchZoom prop, now defaults to true – #1514
• [Breaking] Add new Portal part. To avoid regressions, use this part if you want portalling behavior. Note that z-index isn't managed anymore so you have full control of layering. – #1425
• [Breaking] Remove offset on Arrow part – #1531
• [Breaking] Rename collisionTolerance to collisionPadding on Content part and accepts a number or a padding object – #1531
• Add collisionBoundary, arrowPadding, sticky, hideWhenDetached props on Content part – #1531

• [Breaking] Note that z-index isn't managed anymore so you have full control of layering. The prop to provide a custom container evolves from containerRef (ref) to container (element). The data-radix-portal was removed because you can use asChild to control the element. – #1463

• Add aria-required to root – #1422

• ScrollArea.Thumb is now animatable – #1392

• [Breaking] Renamed data-state values from active|inactive to checked|unchecked – #1388
• [Breaking] Add new Portal part. To avoid regressions, use this part if you want portalling behavior. Note that z-index isn't managed anymore so you have full control of layering. – #1459
• Fix position breaking when using asChild on Select.Content – #1245
• Improve trigger/content alignment when Select.Content has padding – #1312
• Fix trigger/content alignment when there are less than 5 items – #1355
• Support trigger/content alignment when no value is provided – #1379
• Add data-highlighted attribute to support styling – #1388
• Add support for placeholder via placeholder prop on Select.Value – #1384
• Resolve value mismatch with underlying native select – #1421

• Fix issue with children ordering when using Slottable – #1376

• Add support for lifecycle animation to Tabs.Content – #1346

• [Breaking] The default toast order has changed, they now render top to bottom from oldest to newest – #1469
• Improve Typescript types when using asChild – #1300
• Fix issue with toast reordering when updating React's key prop – #1283
• Improve compatability with animation libraries – #1468

• [Breaking] Add new Portal part. To avoid regressions, use this part if you want portalling behavior. Note that z-index isn't managed anymore so you have full control of layering. – #1427
• [Breaking] By default Tooltip.Content will remain open when hovering (WCAG 2.1 Content on Hover compliance). disableHoverableContent can be supplied to Tooltip.Provider to restore previous behavior – #1490
• [Breaking] side on Tooltip.Content now defaults to top – #1490
• [Breaking] Tooltip.Provider is now required, you must wrap your app to avoid regressions. – #1490
• [Breaking] Remove offset on Arrow part – #1531
• [Breaking] Rename collisionTolerance to collisionPadding on Content part and accepts a number or a padding object – #1531
• Improve layering of tooltip with other primitives – #1314
• Fix tooltip closing when transforming/animation trigger – #937
• Add collisionBoundary, arrowPadding, sticky, hideWhenDetached props on Content part – #1531

February 28, 2022

This release introduces 3 brand new primitives in preview: Select, Toast and NavigationMenu, whilst also shipping a ton of fixes and improvements.

• Prevent form submission when pressing Accordion.Trigger – #1085
• Fix animation issue with React 18 – #1125

• Improve pointer-events management – #1079

• Prevent activation via enter key – #1104

• Fix animation issue with React 18 – #1125

• Prevent DropdownMenu.TriggerItem click from firing twice – #1057
• Improve idle performance – #1040

• Improve pointer-events management – #1079
• [Breaking] Dialog.Title is now a required part so will throw an error if not used. aria-describedby={undefined} must be passed to Dialog.Content if no description is needed. – #1098

• Improve composability with Dialog/AlertDialog – #1097
• Prevent clicking trigger to close from immediately reopening in non-modal mode – #1059
• Prevent DropdownMenu.TriggerItem click from firing twice – #1057
• Improve idle performance – #1040

• New primitive – #1172

• Prevent activation via enter key – #1104

• New primitive – #1169

• Prevent page scroll when using Home and End keys – #1076

• Prevent accidental focus activation via right click – #1114

• New primitive – #1165

• Improve accessibility by using radio role for single toggle group – #1118

December 13, 2021

This release focuses on React 18 support and introduces a number of breaking changes to some packages, mostly related to portalling dialogs.

• [Breaking] Deprecate IdProvider. Improves support for React 18 going forward and is no longer needed in older versions. Remove from your app to avoid deprecation warnings. – #1006

• Improve React 18 support – #984
• Improve dev mode errors with mismatched type and value props – #979
• Prevent Accordion.Content height animation on initial page load – #977

• [Breaking] Add new Portal part. To avoid regressions, use this part if you want portalling behavior. – #936
• [Breaking] Support scrolling within AlertDialog.Overlay. Move allowPinchZoom to root. – #963
• Fix asChild TypeScript error – #924

• Prevent Collapsible.Content height animation on initial page load – #977

• [Breaking] Add new Portal part. To avoid regressions, use this part if you want portalling behavior. – #936
• [Breaking] Support scrolling within Dialog.Overlay. Move allowPinchZoom to root. – #963

• Prevent disabled trigger from opening menu – #974

• Fix ability to focus HoverCard when inside a dialog – #920

• Prevent programmatic focus from changing value – #939

• [Breaking] Change Tabs.Trigger to button element – #981
• Improve TSDocs – #978

• Remove invalid aria-orientation attribute on role=group element – #965

• Fix asChild TypeScript error – #924
• Remove invalid toolbaritem role – #950

• [Breaking] Add new TooltipProvider part. You must wrap your app to avoid regressions. – #1007
• [Breaking] Remove type=button attribute from Tooltip.Trigger – #1011
• Fix tooltip activation regression – #1035

• Fix key warnings – #1015

October 15, 2021

• All primitives are now versioned 0.1.1
• Fix composability issues between primitives by scoping context – #906
• Fix CSS unmount animations – #851

• Add new CSS variable to Accordion.Content to help with width animations – #879

• Improve composability with Dialog – #906
• [Breaking] Remove AlertDialog.Content onInteractOutside prop – #846

• Improve composability with AlertDialog – #906
• Add pinch to zoom support to DropdownMenu.Content via allowPinchZoom prop – #884

• Add pinch to zoom support to ContextMenu.Content via allowPinchZoom prop – #884
• Prevent scroll via arrow keypress on submenu triggers – #908

• Add new CSS variable to Collapsible.Content to help with width animations – #879

• Prevent screen reader virtual cursor from accessing hidden input – #870

• Improve composability with Tooltip – #906
• Add pinch to zoom support to DropdownMenu.Content via allowPinchZoom prop – #884
• Prevent scroll via arrow keypress on submenu triggers – #908

• Open on focus to improve keyboard support – #902
• Compose correct pointer events internally – #893

• Allow its children to prevent event propagation – #861

• Prevent screen reader virtual cursor from accessing hidden inputs – #870

• Add pinch to zoom support to Popover.Content via allowPinchZoom prop – #884

• Fix calculations when value is 0 – #866

• Prevent screen reader virtual cursor from accessing hidden input – #870

• [Breaking] Unmount content within Tabs.Content when tab is inactive – #859

September 7, 2021

• All primitives moved to Beta and are now versioned 0.1.0
• [Breaking] Replace polymorphic as prop with asChild boolean prop. Learn more about how to change the rendered element here – #835

• Improve composability with DropdownMenu – #818

• Improve composability with Dialog – #818
• Re-enable pointer-events when closed – #819
• Prevent body text from selecting on close (Firefox) – #812
• Ensure sub triggers receive focus on click (iOS Safari) – #820

• [Breaking] Deprecate extendPrimitive utility – #840

August 4, 2021

• Improve polymorphic types performance – #784

• [Breaking] Remove AlertDialog.Content onPointerDownOutside prop – #700
• Prevent outside pointer events triggering prematurely on touch devices – #767

• Add modality support via modal prop – #700
• [Breaking] Remove ContextMenu.Content disableOutsidePointerEvents prop – #700
• Prevent outside pointer events triggering prematurely on touch devices – #767

• Add modality support via modal prop – #700
• Improve animation rendering in React 18 – #776
• Ensure focus is restored to trigger on close when using the autofocus attribute on a child element – #739
• Prevent outside pointer events triggering prematurely on touch devices – #767
• Ensure iOS Safari consistently focuses the first focusable element – #776

• Add modality support via modal prop – #700
• [Breaking] Remove DropdownMenu.Content disableOutsideScroll prop – #700
• [Breaking] Remove DropdownMenu.Content disableOutsidePointerEvents prop – #700
• Prevent outside pointer events triggering prematurely on touch devices – #767

• Add modality support via modal prop – #700
• [Breaking] Remove Popover.Content disableOutsideScroll prop – #700
• [Breaking] Remove Popover.Content disableOutsidePointerEvents prop – #700
• [Breaking] Remove Popover.Content trapFocus prop – #700
• Improve animation rendering in React 18 – #776
• Ensure focus is restored to trigger on close when using the autofocus attribute on a child element – #739
• Prevent outside pointer events triggering prematurely on touch devices – #767
• Ensure iOS Safari consistently focuses the first focusable element – #776

• Add data-state to ScrollBar part – #801

• Prevent thumb receiving focus when disabled – #777
• Prevent focus loss on thumb when using React.StrictMode – #794

June 24, 2021

• Can now be triggered on touch with a long press – #743

• Add optional Title and Description parts for simpler labelling – #741

• Add data-orientation to Scrollbar for styling convenience – #720
• Fix forceMount type issue on Scrollbar – #738

• Ensure the correct thumb is focused when using keyboard and crossing another thumb – #731
• Ensure only one arrow press is needed when crossing another thumb – #733

• Improve types compatibility – #737

• Ensure only one click is needed to toggle a single controlled toggle group – #722
• Ensure focus behavior is consistent on Safari – #727

June 15, 2021

• Improve polymorphic types – #648

• [Breaking] Rename Accordion.Button to Accordion.Trigger – #651
• [Breaking] Rename Accordion.Panel to Accordion.Content – #651
• [Breaking] Rename custom property accordingly (--radix-accordion-content-height) – #651
• [Breaking] type=“single” Accordion now has a new collapsible prop which is false by default. This means that the default behavior has now changed. By default a user cannot close all items. – #651

• [Breaking] Allow preventing default in onPointerDownOutside without inadvertently preventing focus – #654

• [Breaking] onCheckedChange(event) is now onCheckedChange(checked: CheckedState) – #672
• Improve compatibility with native form validation – #650
• Allow stopping propagation on Checkbox onClick – #672
• Improve compatibility with native label – #672
• Improve accessibility when wrapped in native label – #672

• [Breaking] Rename Collapsible.Button to Collapsible.Trigger – #651

• Add submenu support – #682
• Add ContextMenu.TriggerItem – #682
• Add ContextMenu.Arrow – #682
• Add dir prop for RTL support with submenus – #682
• [Breaking] Allow preventing default in onPointerDownOutside without inadvertently preventing focus – #654
• [Breaking] Remove ContextMenu.Content side prop – #658
• [Breaking] Remove ContextMenu.Content align prop – #658
• [Breaking] If you had sideOffset on ContextMenu.Content before, you should now use alignOffset. This is to standardize vertical alignment for both root and sub-menus. – #712
• [Breaking] onFocusOutside is now a custom event – #671
• Improve support of content and item with no padding – #658
• Align with WAI-ARIA spec by focusing first item when opening via keyboard – #694

• [Breaking] Allow preventing default in onPointerDownOutside without inadvertently preventing focus – #654

• Add submenu support – #682
• Add DropdownMenu.TriggerItem – #682
• Add dir prop for RTL support with submenus – #682
• [Breaking] Allow preventing default in onPointerDownOutside without inadvertently preventing focus – #654
• [Breaking] onFocusOutside is now a custom event – #671
• [Breaking] The up arrow no longer opens the menu – #702
• Align with WAI-ARIA spec by focusing first item when opening via keyboard – #694

• [Breaking] Allow preventing default in onPointerDownOutside without inadvertently preventing focus – #654
• [Breaking] onFocusOutside is now a custom event – #671

• [Breaking] onValueChange(event) is now onValueChange(value: string) – #685
• [Breaking] Remove RadioGroup.Item onCheckedChange prop – #685
• Improve compatibility with native form validation – #650
• Improve usage within forms – #685

• Brand new version with a simpler API – #624
• Improve Safari support – #624
• Improve RTL support – #624
• Improve touch support – #624
• Scrollbar mount/unmount can now be animated – #624
• Add minimum width/height to thumb so it's always grabbable – #624
• Move functional CSS into component to improve DX – #624
• Bundle size significantly reduced – #624
• [Breaking] Remove overflowX and overflowY props – #624
• [Breaking] Remove ScrollAreaButtonStart, ScrollAreaButtonEnd and ScrollAreaTrack – #624
• [Breaking] Rename scrollbarVisibility prop to type. The values are auto, always, scroll or hover – #624
• [Breaking] Rename scrollbarVisibilityRestTimeout prop to scrollHideDelay – #624
• [Breaking] Remove trackClickBehavior prop as we've removed built-in animation. Clicking on track always snaps to pointer position – #624
• [Breaking] ScrollAreaScrollbarX and ScrollAreaScrollbarY are now <ScrollAreaScrollbar orientation="horizontal" /> and <ScrollAreaScrollbar orientation="vertical" /> – #624
• Ensure no scrollbars are shown when scrolling is disabled – #624
• Ensure children event handlers don't break – #624
• Ensure scroll area updates when children content size changes – #624

• Improve usage within forms – #678
• Fix key binding issue in LTR – #718

• [Breaking] onCheckedChange(event) is now onCheckedChange(checked: boolean) – #679
• Improve compatibility with native form validation – #650
• Improve usage within forms – #679
• Improve accessibility when wrapped in native label – #679

• [Breaking] Rename Tabs.Tab to Tabs.Trigger – #652
• [Breaking] Rename Tabs.Panel to Tabs.Content – #652

May 3, 2021

• Improve polymorphic types performance – #613

• Ensure only one click is needed to close a single controlled accordion – #594

• [Breaking] Remove readOnly prop – #600

• Add onOpenChange prop – #604

• Ensure focus position isn't lost when blurring out window and re-focusing it – #589

• Take into account non-visible items – #618
• [Breaking] Remove anchorRef prop – #580
• Prevent page from scrolling when selecting an item with space key – #626

• New primitive – #595

• [Breaking] Remove anchorRef prop and replace with optional Anchor part – #580

• Add optional orientation, dir, loop props – #618
• [Breaking] Remove readOnly prop – #600

• [Breaking] Remove readOnly prop – #600

• Add optional orientation, dir, loop props – #618

• [Breaking] Remove anchorRef prop – #580

March 26, 2021

• Improve tree-shaking – #577

• Ensure you can open a context menu when one is already open – #565

• Fix potential overlap issue – #541

• Ensure Content closes when it has multiple close animations – #571

• [Breaking] Rename ToggleButton primitive to Toggle – #546
• [Breaking] Rename toggled prop to pressed – #546
• [Breaking] Rename defaultToggled prop to defaultPressed – #546
• [Breaking] Rename onToggledChange prop to onPressedChange – #546

• New primitive – #376

• New primitive – #412 #451 #545

• Add custom timing support – #550 #551 #554 #558
• Add unmount animation support – #558

March 5, 2021

• Add height CSS custom property to panel for easier animation – #537

• Add height CSS custom property to content for easier animation – #537

• Fix type definition conflicts – #538

March 3, 2021

• Add support for SSR
• [Breaking] Remove selector prop and data-radix-* atributes – #517

• [Breaking] Add support for multiple values. Note that this is a breaking change because the new type prop is required – #527

• Ensure step is rounded correctly – #463

• Add RTL support (dir prop) – #497

February 17, 2021

• Ensure events are composed when using <Trigger as={Slot}> – #461

February 15, 2021

• Expose onCloseAutoFocus prop – #456

• Expose onCloseAutoFocus prop – #456

February 10, 2021

• Fix type autocompletion when using as prop – #421

• Prevent open/close flickering – #431

• Ensure focus is returned properly on close – #422

• [Breaking] Move name prop from Item to Root – #424

February 1, 2021

• Re–add missing children – #414

• Re–add missing children – #414

• Prevent flickering (sliding) issue – #415

January 29, 2021

• New utility – #409

January 25, 2021

• Fix regression when tabbing out would close – #403

• Fix broken arrow keys navigation – #404

January 22, 2021

• Add selector prop – #347

• Ensure setting disabled={false} on Root doesn't enable disabled items – #400

• Add enter key support on trigger – #381
• Prevent focus race condition – #394

• Ensure Content repositions on window resize – #359
• Ensure last element inside Content triggers blur event – #395

December 15, 2020

• Initial release! 🎉 – #338