Radix 组件版本发布及其变更日志。
CheckedState
类型TooltipProviderProps
类型package.json
中添加一个缺失的内部实用程序。提供传送门部分的相应包也收到了补丁更新。 – #2966发布了所有组件的次要版本,包含以下更改
react-remove-scroll
依赖项版本,以避免在极端情况下出现双滚动条错误 – #2776onEscapeKeyDown
中调用 stopPropagation
。hideWhenDetached
属性的组件不允许与隐藏内容交互 – #2743 – #2745disableOutsidePointerEvents
属性value={undefined}
代表不确定的状态,匹配当前的实际行为 – #2947nonce
属性,以便能够将 CSP nonce 传递给内联样式 – #2728nonce
属性,以便能够将 CSP nonce 传递给内联样式 – #2728Portal
部分类型关于接受 DOM 属性的错误信息 – #2178Dialog
内部的 Popover
无法打开的问题 – #2182scroll-behavior: smooth
兼容性 – #2175""
value
重置为占位符的功能。请注意,这只有在您使用 value
为 ""
的选项时才是破坏性变更。 – #2174Portal
部分类型关于接受 DOM 属性的错误信息 – #2178Portal
部分类型关于接受 DOM 属性的错误信息 – #2178Content
– #2092此版本确保我们所有的原语都与 ESM 兼容。我们还更新到了最新版本的 Floating UI,用于我们所有的弹出式定位原语。
collisionBoundary
时,--radix-popper-available-width
正确计算 – #2032Slot
可以用在 React 服务器组件中 – #2116此版本引入了预览版中的全新原语:Form
。
onCheckedChange
在 ContextMenu.CheckboxItem
上的类型 – #1778onCheckedChange
在 DropdownMenu.CheckboxItem
上的类型 – #1778Menubar.CheckboxItem
上添加了 onCheckedChange
类型的事件 – #1778此版本引入了一个全新的原语:Menubar
。它还为 Select
添加了对一项高度需求的功能的支持:以类似于 Popover
或 DropdownMenu
的方式定位内容。
orientation
属性,以及使用 dir
的 RTL 支持 – #1850Select.Content
添加了 position
属性以启用 Popper 定位 – #1853ContextMenu.Trigger
添加了 disabled
属性 – #1746pointerId
无效问题 – #1753ContextMenu.CheckboxItem
添加了对不确定状态的支持。请注意,如果您当前正在使用 CheckboxItem
部分,并且您的代码库是用 TypeScript 编写的,则这将是一个破坏性更改。 – #1624DropdownMenu.CheckboxItem
添加了对不确定状态的支持。请注意,如果您当前正在使用 CheckboxItem
部分,并且您的代码库是用 TypeScript 编写的,则这将是一个破坏性更改。 – #1624DropdownMenu.Trigger
的打开状态与 aria-expanded
正确配对 – #1644asChild
时急切选择项目的问题 – #1647useLabelContext
和对完全自定义控件的支持。为了使本地标签起作用,请确保您的自定义控件基于本地元素,例如 button
或 input
。 – #1686label
元素来改进本地行为 – #1686NavigationMenu.Root
添加了 delayDuration
和 skipDelayDuration
属性。请注意,默认情况下,触发器现在在打开之前会有短暂的延迟以改善 UX,可以使用提供的属性修改此延迟。 – #1716Slider.Root
上的新 inverted
属性以视觉方式反转滑块的功能 – #1695Slider.Root
添加了 onValueCommit
属性,以更好地处理离散值更改 – #1696ref
赋值返回 null
的回归问题 – #1668Toast.Root
添加了 onPause
和 onResume
属性 – #1669Toolbar.Item
点击处理程序两次触发 – #1526从本版本开始,我们将严格遵循语义版本控制。所有原语现在都使用 1.0.0 版本。
我们还将 Select
、Toast
和 NavigationMenu
从预览版移至稳定版。
dir
属性从文档(或任何元素)继承,你需要使用 DirectionProvider
。 – #1119allowPinchZoom
属性,现在默认值为 true
– #1514AlertDialog.Portal
上使用 forceMount
,提高与 JS 动画库的兼容性 – #1075allowPinchZoom
属性,现在默认值为 true
– #1514Portal
部分。为了避免回归,如果你想要门户行为,请使用此部分。请注意,z-index
现在不再管理,因此你可以完全控制分层。 – #1429offset
在 Arrow
部分 – #1531collisionTolerance
重命名为 collisionPadding
在 Content
部分,并接受数字或填充对象 – #1531data-highlighted
属性以支持样式 – #1388data-state
属性到 Trigger
部分 – #1455collisionBoundary
、arrowPadding
、sticky
、hideWhenDetached
属性在 Content
部分 – #1531allowPinchZoom
属性,现在默认值为 true
– #1514Dialog.Portal
上使用 forceMount
,提高与 JS 动画库的兼容性 – #1075allowPinchZoom
属性,现在默认值为 true
– #1514Portal
部分。为了避免回归,如果你想要门户行为,请使用此部分。请注意,z-index
现在不再管理,因此你可以完全控制分层。 – #1429offset
在 Arrow
部分 – #1531collisionTolerance
重命名为 collisionPadding
在 Content
部分,并接受数字或填充对象 – #1531data-highlighted
属性以支持样式 – #1388collisionBoundary
、arrowPadding
、sticky
、hideWhenDetached
属性在 Content
部分 – #1531Portal
部分。为了避免回归,如果你想要门户行为,请使用此部分。请注意,z-index
现在不再管理,因此你可以完全控制分层。 – #1426offset
在 Arrow
部分 – #1531collisionTolerance
重命名为 collisionPadding
在 Content
部分,并接受数字或填充对象 – #1531collisionBoundary
、arrowPadding
、sticky
、hideWhenDetached
属性在 Content
部分 – #1531allowPinchZoom
属性,现在默认值为 true
– #1514Portal
部分。为了避免回归,如果你想要门户行为,请使用此部分。请注意,z-index
现在不再管理,因此你可以完全控制分层。 – #1425offset
在 Arrow
部分 – #1531collisionTolerance
重命名为 collisionPadding
在 Content
部分,并接受数字或填充对象 – #1531collisionBoundary
、arrowPadding
、sticky
、hideWhenDetached
属性在 Content
部分 – #1531z-index
现在不再管理,因此你可以完全控制分层。提供自定义容器的属性从 containerRef
(引用)演变为 container
(元素)。data-radix-portal
已被删除,因为你可以使用 asChild
来控制元素。 – #1463aria-required
到根节点 – #1422ScrollArea.Thumb
现在可动画化 – #1392data-state
值从 active|inactive
重命名为 checked|unchecked
– #1388Portal
部分。为了避免回归,如果你想要门户行为,请使用此部分。请注意,z-index
现在不再管理,因此你可以完全控制分层。 – #1459Select.Content
上使用 asChild
时位置中断的问题 – #1245Select.Content
有填充时,改进触发器/内容对齐 – #1312data-highlighted
属性以支持样式 – #1388placeholder
属性在 Select.Value
上添加对占位符的支持 – #1384Slottable
时子元素排序问题 – #1376Tabs.Content
添加对生命周期动画的支持 – #1346asChild
时的Typescript 类型 – #1300key
属性时吐司重新排序的问题 – #1283Portal
部分。为了避免出现回归,如果您想要门户行为,请使用此部分。请注意,z-index
不再被管理,因此您可以完全控制分层。 – #1427Tooltip.Content
在悬停时将保持打开状态(WCAG 2.1 悬停内容合规性)。可以将 disableHoverableContent
提供给 Tooltip.Provider
以恢复之前的行为 – #1490side
在 Tooltip.Content
上现在默认为 top
– #1490Tooltip.Provider
,您必须包装您的应用程序以避免出现回归。 – #1490offset
在 Arrow
部分 – #1531collisionTolerance
重命名为 collisionPadding
在 Content
部分,并接受数字或填充对象 – #1531collisionBoundary
、arrowPadding
、sticky
、hideWhenDetached
属性在 Content
部分 – #1531此版本引入了 3 个全新的预览版基本元素:Select
、Toast
和 NavigationMenu
,同时还发布了许多修复和改进。
Dialog.Title
现在是必需的部分,因此如果不使用它将抛出错误。如果不需要描述,则必须将 aria-describedby={undefined}
传递给 Dialog.Content
。 – #1098Dialog
/AlertDialog
的组合性 – #1097DropdownMenu.TriggerItem
点击两次触发 – #1057Home
和 End
键时防止页面滚动 – #1076此版本侧重于 React 18 支持,并对一些软件包引入了许多重大变更,主要与门户对话框相关。
IdProvider
。改进对未来 React 18 的支持,并且在旧版本中不再需要。从您的应用程序中删除它以避免出现弃用警告。 – #1006type
和 value
属性相关的开发模式错误 – #979Accordion.Content
在初始页面加载时出现高度动画 – #977Portal
部分。为了避免出现回归,如果您想要门户行为,请使用此部分。 – #936AlertDialog.Overlay
内滚动。将 allowPinchZoom
移动到根目录。 – #963asChild
TypeScript 错误 – #924Collapsible.Content
在页面初始加载时出现高度动画 – #977Portal
部分。为了避免出现回归,如果您想要门户行为,请使用此部分。 – #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
内的内容 – #859DropdownMenu
的可组合性 – #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
属性时,焦点会恢复到触发关闭的元素上 – #739data-state
到 ScrollBar
部分 – #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
属性,用于子菜单的 RTL 支持 – #682onPointerDownOutside
中阻止默认行为,而不会无意中阻止焦点 – #654ContextMenu.Content
side
属性 – #658ContextMenu.Content
align
属性 – #658ContextMenu.Content
上使用了 sideOffset
,现在应该使用 alignOffset
。这是为了将根菜单和子菜单的垂直对齐方式标准化。 – #712onFocusOutside
现在是一个自定义事件 – #671onPointerDownOutside
中阻止默认行为,而不会无意中阻止焦点 – #654DropdownMenu.TriggerItem
– #682dir
属性,用于子菜单的 RTL 支持 – #682onPointerDownOutside
中阻止默认行为,而不会无意中阻止焦点 – #654onFocusOutside
现在是一个自定义事件 – #671onPointerDownOutside
中阻止默认行为,而不会无意中阻止焦点 – #654onFocusOutside
现在是一个自定义事件 – #671onValueChange(event)
现在是 onValueChange(value: string)
– #685RadioGroup.Item
onCheckedChange
属性 – #685Scrollbar
现在可以对挂载/卸载进行动画 – #624overflowX
和 overflowY
属性 – #624ScrollAreaButtonStart
、ScrollAreaButtonEnd
和 ScrollAreaTrack
– #624scrollbarVisibility
属性重命名为 type
。其值可以是 auto
、always
、scroll
或 hover
– #624scrollbarVisibilityRestTimeout
属性重命名为 scrollHideDelay
– #624trackClickBehavior
属性,因为我们已经删除了内置动画。点击轨道始终会立即跳转到指针位置 – #624ScrollAreaScrollbarX
和 ScrollAreaScrollbarY
现在是 <ScrollAreaScrollbar orientation="horizontal" />
和 <ScrollAreaScrollbar orientation="vertical" />
– #624onCheckedChange(event)
现在是 onCheckedChange(checked: boolean)
– #679label
中包装时,改进可访问性 – #679readOnly
属性 – #600onOpenChange
属性 – #604anchorRef
属性,并用可选的 Anchor
部分代替 – #580readOnly
属性 – #600orientation
,dir
,loop
属性 – #618anchorRef
属性 – #580Content
有多个关闭动画时,它会关闭 – #571ToggleButton
基本组件重命名为 Toggle
– #546toggled
属性重命名为 pressed
– #546defaultToggled
属性重命名为 defaultPressed
– #546onToggledChange
属性重命名为 onPressedChange
– #546selector
属性和 data-radix-*
属性 – #517type
属性是必需的 – #527step
正确四舍五入 – #463dir
属性) – #497<Trigger as={Slot}>
时,事件是组合的 – #461onCloseAutoFocus
属性 – #456onCloseAutoFocus
属性 – #456as
属性时的类型自动完成 – #421name
属性从 Item
移动到 Root
– #424children
– #414children
– #414selector
属性 – #347Root
上设置 disabled={false}
不会启用禁用的项目 – #400