Radix Primitives 版本及其更新日志。
radix-ui 包，该包从一个位置公开所有 Radix Primitives 的最新版本。这种可摇树优化的入口点使您可以更轻松地引入所需的任何组件，并保持它们的最新状态，而无需担心冲突或重复的依赖项。aria-hidden 和 react-remove-scroll 依赖项
allowPinchZoom 错误 – #3127referrerPolicy – #2772allowPinchZoom 错误 – #3127form 属性到气泡输入元素，以修复非父表单提交 – #3161form 属性到气泡输入元素，以修复非父表单提交 – #3161form 属性转发到每个滑块拇指的气泡输入元素，以修复非父表单提交 – #3161form 属性到气泡输入元素，以修复非父表单提交 – #3161hotkey 是空数组时焦点不正确的错误 – #2491CheckedState 类型TooltipProviderProps 类型package.json 中添加了缺少的内部实用程序。提供 Portal 部分的相应包也收到了补丁更新。 – #2966发布了所有基元的次要版本，并进行了以下更改
react-remove-scroll 依赖项版本，以避免边缘情况下出现双滚动条错误 – #2776onEscapeKeyDown 中调用 stopPropagation。hideWhenDetached 属性的组件不允许与隐藏内容进行交互 – #2743 – #2745disableOutsidePointerEvents 属性value={undefined} 表示不确定状态，与当前的实际行为匹配 – #2947nonce 属性，以便能够将 CSP nonce 传递给内联样式 – #2728nonce 属性，以便能够将 CSP nonce 传递给内联样式 – #2728Portal 部分类型错误 – #2178Dialog 内的 Popover 未打开的错误 – #2182scroll-behavior: smooth 兼容性 – #2175"" value 重置为占位符的功能。请注意，如果您正在使用 value 为 "" 的选项，则这只是一个重大更改。 – #2174Portal 部分类型错误 – #2178Portal 部分类型错误 – #2178Content 的选项 – #2092此版本确保我们所有的基元都与 ESM 兼容。我们还将所有 popper 定位的基元更新到最新版本的 Floating UI。
collisionBoundary 时正确计算 --radix-popper-available-width – #2032Slot 可以在 React 服务器组件中使用 – #2116此版本引入了一个全新的预览版基元：Form。
ContextMenu.CheckboxItem 上的 onCheckedChange 类型 – #1778DropdownMenu.CheckboxItem 上的 onCheckedChange 类型 – #1778Menubar.CheckboxItem 上的 onCheckedChange 类型 – #1778此版本引入了一个全新的基元：Menubar。它还为 Select 添加了对高需求功能的支持：以类似于 Popover 或 DropdownMenu 的方式定位内容的能力。
orientation 属性添加水平方向支持，以及使用 dir 添加 RTL 支持 – #1850position 属性添加到 Select.Content 以启用 popper 定位 – #1853disabled 属性添加到 ContextMenu.Trigger – #1746pointerId – #1753ContextMenu.CheckboxItem 添加了对不确定状态的支持。请注意，如果您当前正在使用 CheckboxItem 部分并且您的代码库是用 TypeScript 编写的，则这只是一个重大更改。 – #1624DropdownMenu.CheckboxItem 上添加对不确定状态的支持。请注意，如果您当前正在使用 CheckboxItem 组件，并且您的代码库是用 TypeScript 编写的，则这仅是一个重大变更。– #1624DropdownMenu.Trigger 关闭时，正确地将其打开状态与 aria-expanded 配对 – #1644asChild 时，项目被过早选中的问题 – #1647useLabelContext 和对完全自定义控件的支持。为了使原生标签正常工作，请确保您的自定义控件基于原生元素，例如 button 或 input。– #1686label 元素来改进原生行为 – #1686NavigationMenu.Root 添加 delayDuration 和 skipDelayDuration 属性。请注意，默认情况下，触发器现在在打开前会有短暂的延迟，以改善用户体验，这可以使用提供的属性进行修改。– #1716inverted 属性在 Slider.Root 上视觉反转滑块的功能 – #1695Slider.Root 添加 onValueCommit 属性，以更好地处理离散值更改 – #1696ref 赋值返回 null 的回归问题 – #1668Toast.Root 添加 onPause 和 onResume 属性 – #1669Toolbar.Item 点击处理程序触发两次 – #1526在此版本中，我们开始严格遵循语义版本控制。所有 primitives 现在都版本为 1.0.0。
我们还将 Select、Toast 和 NavigationMenu 从预览版移至稳定版。
dir 属性继承，则需要使用 DirectionProvider。– #1119allowPinchZoom 属性，现在默认为 true – #1514AlertDialog.Portal 上的 forceMount 改进了与 JS 动画库的兼容性 – #1075allowPinchZoom 属性，现在默认为 true – #1514Portal 部件。为避免回归，如果您想要 portal 行为，请使用此部件。请注意，z-index 不再被管理，因此您可以完全控制图层。– #1429Arrow 部件上的 offset – #1531Content 部件上的 collisionTolerance 重命名为 collisionPadding，并接受数字或 padding 对象 – #1531data-highlighted 属性以支持样式设置 – #1388Trigger 部件添加 data-state 属性 – #1455Content 部件上添加 collisionBoundary、arrowPadding、sticky、hideWhenDetached 属性 – #1531allowPinchZoom 属性，现在默认为 true – #1514Dialog.Portal 上的 forceMount 改进了与 JS 动画库的兼容性 – #1075allowPinchZoom 属性，现在默认为 true – #1514Portal 部件。为避免回归，如果您想要 portal 行为，请使用此部件。请注意，z-index 不再被管理，因此您可以完全控制图层。– #1429Arrow 部件上的 offset – #1531Content 部件上的 collisionTolerance 重命名为 collisionPadding，并接受数字或 padding 对象 – #1531data-highlighted 属性以支持样式设置 – #1388Content 部件上添加 collisionBoundary、arrowPadding、sticky、hideWhenDetached 属性 – #1531Portal 部件。为避免回归，如果您想要 portal 行为，请使用此部件。请注意，z-index 不再被管理，因此您可以完全控制图层。– #1426Arrow 部件上的 offset – #1531Content 部件上的 collisionTolerance 重命名为 collisionPadding，并接受数字或 padding 对象 – #1531Content 部件上添加 collisionBoundary、arrowPadding、sticky、hideWhenDetached 属性 – #1531allowPinchZoom 属性，现在默认为 true – #1514Portal 部件。为避免回归，如果您想要 portal 行为，请使用此部件。请注意，z-index 不再被管理，因此您可以完全控制图层。– #1425Arrow 部件上的 offset – #1531Content 部件上的 collisionTolerance 重命名为 collisionPadding，并接受数字或 padding 对象 – #1531Content 部件上添加 collisionBoundary、arrowPadding、sticky、hideWhenDetached 属性 – #1531z-index 不再被管理，因此您可以完全控制图层。提供自定义容器的属性从 containerRef (ref) 演变为 container (element)。data-radix-portal 已被移除，因为您可以使用 asChild 来控制元素。– #1463aria-required – #1422ScrollArea.Thumb 现在是可动画的 – #1392data-state 值从 active|inactive 重命名为 checked|unchecked – #1388Portal 部件。为避免回归，如果您想要 portal 行为，请使用此部件。请注意，z-index 不再被管理，因此您可以完全控制图层。– #1459Select.Content 上使用 asChild 时位置错乱的问题 – #1245Select.Content 具有 padding 时，触发器/内容对齐 – #1312data-highlighted 属性以支持样式设置 – #1388Select.Value 上的 placeholder 属性支持占位符的功能 – #1384Slottable 时子元素排序的问题 – #1376Tabs.Content 添加了对生命周期动画的支持 – #1346asChild 时的 Typescript 类型 – #1300key 属性时 toast 重新排序的问题 – #1283Portal 部件。为避免回归，如果您想要 portal 行为，请使用此部件。请注意，z-index 不再被管理，因此您可以完全控制图层。– #1427Tooltip.Content 将保持打开状态（符合 WCAG 2.1 悬停内容标准）。可以向 Tooltip.Provider 提供 disableHoverableContent 以恢复之前的行为 – #1490Tooltip.Content 上的 side 现在默认为 top – #1490Tooltip.Provider，您必须包装您的应用程序以避免回归。– #1490Arrow 部件上的 offset – #1531Content 部件上的 collisionTolerance 重命名为 collisionPadding，并接受数字或 padding 对象 – #1531Content 部件上添加 collisionBoundary、arrowPadding、sticky、hideWhenDetached 属性 – #1531此版本预览版中引入了 3 个全新的 primitives：Select、Toast 和 NavigationMenu，同时还发布了大量修复和改进。
Dialog.Title 现在是必需部件，因此如果未使用会抛出错误。如果不需要描述，则必须将 aria-describedby={undefined} 传递给 Dialog.Content。– #1098Dialog/AlertDialog 的可组合性 – #1097DropdownMenu.TriggerItem 点击触发两次 – #1057Home 和 End 键时页面滚动 – #1076此版本侧重于 React 18 支持，并为某些软件包引入了一些重大变更，主要与 portal 对话框有关。
IdProvider。 改进了对 React 18 的未来支持，并且在旧版本中不再需要。 从你的应用中移除以避免弃用警告。 – #1006type 和 value 属性不匹配时的错误信息 – #979Accordion.Content 在初始页面加载时的高度动画 – #977Portal 部分。 为了避免回归，如果你想要 portal 行为，请使用此部分。 – #936AlertDialog.Overlay 内滚动。 将 allowPinchZoom 移动到根元素。 – #963asChild TypeScript 错误 – #924Collapsible.Content 在初始页面加载时的高度动画 – #977Portal 部分。 为了避免回归，如果你想要 portal 行为，请使用此部分。 – #936Dialog.Overlay 内滚动。 将 allowPinchZoom 移动到根元素。 – #963HoverCard 的问题 – #920role=group 元素上无效的 aria-orientation 属性 – #965TooltipProvider 部分。 你必须包裹你的应用以避免回归。 – #1007Tooltip.Trigger 中移除 type=button 属性 – #1011key 警告 – #1015Accordion.Content 添加新的 CSS 变量以帮助实现宽度动画 – #879Collapsible.Content 添加新的 CSS 变量以帮助实现宽度动画 – #879Tooltip 的组合性 – #906allowPinchZoom 属性向 DropdownMenu.Content 添加捏合缩放支持 – #884allowPinchZoom 属性向 Popover.Content 添加捏合缩放支持 – #8840 时的计算错误 – #866Tabs.Content 中的内容 – #859as 属性替换为 asChild 布尔属性。 了解更多关于如何在此处更改渲染元素的信息 – #835DropdownMenu 的组合性 – #818Dialog 的组合性 – #818pointer-events – #819extendPrimitive 实用程序 – #840modal 属性添加模态支持 – #700ContextMenu.Content disableOutsidePointerEvents 属性 – #700modal 属性添加模态支持 – #700autofocus 属性时，焦点在关闭时恢复到触发器 – #739modal 属性添加模态支持 – #700DropdownMenu.Content disableOutsideScroll 属性 – #700DropdownMenu.Content disableOutsidePointerEvents 属性 – #700modal 属性添加模态支持 – #700Popover.Content disableOutsideScroll 属性 – #700Popover.Content disableOutsidePointerEvents 属性 – #700Popover.Content trapFocus 属性 – #700autofocus 属性时，焦点在关闭时恢复到触发器 – #739ScrollBar 部分添加 data-state 属性 – #801Title 和 Description 部分 – #741Accordion.Button 重命名为 Accordion.Trigger – #651Accordion.Panel 重命名为 Accordion.Content – #651--radix-accordion-content-height) – #651type=“single” Accordion 现在有一个新的 collapsible 属性，默认值为 false。 这意味着默认行为现在已更改。 默认情况下，用户无法关闭所有项目。 – #651onPointerDownOutside 中阻止默认行为，而不会无意中阻止焦点 – #654onCheckedChange(event) 现在是 onCheckedChange(checked: CheckedState) – #672Checkbox onClick 上停止传播 – #672label 的兼容性 – #672label 中时的可访问性 – #672Collapsible.Button 重命名为 Collapsible.Trigger – #651ContextMenu.TriggerItem – #682ContextMenu.Arrow – #682dir 属性 – #682onPointerDownOutside 中阻止默认行为，而不会无意中阻止焦点 – #654ContextMenu.Content side 属性 – #658ContextMenu.Content align 属性 – #658ContextMenu.Content 上使用了 sideOffset，那么现在应该使用 alignOffset。 这是为了标准化根菜单和子菜单的垂直对齐方式。 – #712onFocusOutside 现在是一个自定义事件 – #671onPointerDownOutside 中阻止默认行为，而不会无意中阻止焦点 – #654DropdownMenu.TriggerItem – #682dir 属性 – #682onPointerDownOutside 中阻止默认行为，而不会无意中阻止焦点 – #654onFocusOutside 现在是一个自定义事件 – #671onPointerDownOutside 中阻止默认行为，而不会无意中阻止焦点 – #654onFocusOutside 现在是一个自定义事件 – #671onValueChange(event) 现在是 onValueChange(value: string) – #685RadioGroup.Item onCheckedChange 属性 – #685Scrollbar 组件的挂载/卸载现在可以动画了 – #624overflowX 和 overflowY props – #624ScrollAreaButtonStart、ScrollAreaButtonEnd 和 ScrollAreaTrack 组件 – #624scrollbarVisibility prop 重命名为 type。可选值为 auto、always、scroll 或 hover – #624scrollbarVisibilityRestTimeout prop 重命名为 scrollHideDelay – #624trackClickBehavior prop，因为我们移除了内置动画。点击轨道始终会捕捉到指针位置 – #624ScrollAreaScrollbarX 和 ScrollAreaScrollbarY 现在分别是 <ScrollAreaScrollbar orientation="horizontal" /> 和 <ScrollAreaScrollbar orientation="vertical" /> – #624onCheckedChange(event) 现在是 onCheckedChange(checked: boolean) – #679label 时的可访问性 – #679readOnly prop – #600onOpenChange prop – #604anchorRef prop，并替换为可选的 Anchor 部分 – #580readOnly prop – #600orientation、dir、loop props – #618anchorRef prop – #580Content 在具有多个关闭动画时关闭 – #571ToggleButton primitive 组件重命名为 Toggle – #546toggled prop 重命名为 pressed – #546defaultToggled prop 重命名为 defaultPressed – #546onToggledChange prop 重命名为 onPressedChange – #546selector prop 和 data-radix-* 属性 – #517type prop 是必需的 – #527step 值被正确舍入 – #463dir prop) – #497<Trigger as={Slot}> 时，事件是组合的 – #461onCloseAutoFocus prop – #456onCloseAutoFocus prop – #456as prop 时的类型自动补全 – #421name prop 从 Item 移动到 Root – #424children – #414children – #414selector prop – #347Root 上设置 disabled={false} 不会启用禁用的项目 – #400