向用户展示菜单——例如一组操作或功能——由按钮触发。
import * as React from "react";import { DropdownMenu } from "radix-ui";import { HamburgerMenuIcon, DotFilledIcon, CheckIcon, ChevronRightIcon, } from "@radix-ui/react-icons";import "./styles.css";const DropdownMenuDemo = () => {const [bookmarksChecked, setBookmarksChecked] = React.useState(true);const [urlsChecked, setUrlsChecked] = React.useState(false);const [person, setPerson] = React.useState("pedro");return (<DropdownMenu.Root><DropdownMenu.Trigger asChild><button className="IconButton" aria-label="Customise options"><HamburgerMenuIcon /></button></DropdownMenu.Trigger><DropdownMenu.Portal><DropdownMenu.Content className="DropdownMenuContent" sideOffset={5}><DropdownMenu.Item className="DropdownMenuItem">New Tab <div className="RightSlot">⌘+T</div></DropdownMenu.Item><DropdownMenu.Item className="DropdownMenuItem">New Window <div className="RightSlot">⌘+N</div></DropdownMenu.Item><DropdownMenu.Item className="DropdownMenuItem" disabled>New Private Window <div className="RightSlot">⇧+⌘+N</div></DropdownMenu.Item><DropdownMenu.Sub><DropdownMenu.SubTrigger className="DropdownMenuSubTrigger">More Tools<div className="RightSlot"><ChevronRightIcon /></div></DropdownMenu.SubTrigger><DropdownMenu.Portal><DropdownMenu.SubContent className="DropdownMenuSubContent" sideOffset={2} alignOffset={-5} ><DropdownMenu.Item className="DropdownMenuItem">Save Page As… <div className="RightSlot">⌘+S</div></DropdownMenu.Item><DropdownMenu.Item className="DropdownMenuItem">Create Shortcut…</DropdownMenu.Item><DropdownMenu.Item className="DropdownMenuItem">Name Window…</DropdownMenu.Item><DropdownMenu.Separator className="DropdownMenu.Separator" /><DropdownMenu.Item className="DropdownMenuItem">Developer Tools</DropdownMenu.Item></DropdownMenu.SubContent></DropdownMenu.Portal></DropdownMenu.Sub><DropdownMenu.Separator className="DropdownMenuSeparator" /><DropdownMenu.CheckboxItem className="DropdownMenuCheckboxItem" checked={bookmarksChecked} onCheckedChange={setBookmarksChecked} ><DropdownMenu.ItemIndicator className="DropdownMenuItemIndicator"><CheckIcon /></DropdownMenu.ItemIndicator>Show Bookmarks <div className="RightSlot">⌘+B</div></DropdownMenu.CheckboxItem><DropdownMenu.CheckboxItem className="DropdownMenuCheckboxItem" checked={urlsChecked} onCheckedChange={setUrlsChecked} ><DropdownMenu.ItemIndicator className="DropdownMenuItemIndicator"><CheckIcon /></DropdownMenu.ItemIndicator>Show Full URLs</DropdownMenu.CheckboxItem><DropdownMenu.Separator className="DropdownMenuSeparator" /><DropdownMenu.Label className="DropdownMenuLabel">People</DropdownMenu.Label><DropdownMenu.RadioGroup value={person} onValueChange={setPerson}><DropdownMenu.RadioItem className="DropdownMenuRadioItem" value="pedro" ><DropdownMenu.ItemIndicator className="DropdownMenuItemIndicator"><DotFilledIcon /></DropdownMenu.ItemIndicator>Pedro Duarte</DropdownMenu.RadioItem><DropdownMenu.RadioItem className="DropdownMenuRadioItem" value="colm" ><DropdownMenu.ItemIndicator className="DropdownMenuItemIndicator"><DotFilledIcon /></DropdownMenu.ItemIndicator>Colm Tuite</DropdownMenu.RadioItem></DropdownMenu.RadioGroup><DropdownMenu.Arrow className="DropdownMenuArrow" /></DropdownMenu.Content></DropdownMenu.Portal></DropdownMenu.Root>);};export default DropdownMenuDemo;
可以是可控的或不可控的。
支持可配置阅读方向的子菜单。
支持项、标签、项组。
支持可选的单选或多选可勾选项,具有可选的不确定状态。
支持模态和非模态模式。
自定义侧边、对齐、偏移、碰撞处理。
可选渲染指向箭头。
焦点完全管理。
完整的键盘导航。
支持前置输入。
关闭和层叠行为高度可定制。
从命令行安装组件。
导入所有部分并将它们组合在一起。
包含下拉菜单的所有部分。
切换下拉菜单的按钮。默认情况下,DropdownMenu.Content
将相对于触发器定位。
使用时,将内容部分传送到 body
。
下拉菜单打开时弹出的组件。
一个可选的箭头元素,用于渲染在下拉菜单旁边。可以用来帮助视觉链接触发器与 DropdownMenu.Content
。必须在 DropdownMenu.Content
内部渲染。
包含下拉菜单项的组件。
用于对多个 DropdownMenu.Item
进行分组。
用于渲染标签。不能通过箭头键聚焦。
可以像复选框一样控制和渲染的项。
用于对多个 DropdownMenu.RadioItem
进行分组。
一个可以控制和渲染为单选框的项。
当父 DropdownMenu.CheckboxItem
或 DropdownMenu.RadioItem
被选中时渲染。您可以直接样式此元素,或者可以将其用作放置图标的包装器,或两者兼而有之。
用于在下拉菜单中视觉上分隔项。
包含所有子菜单的部分。
打开子菜单的项。必须在 DropdownMenu.Sub
内部渲染。
您可以通过组合使用 DropdownMenu.Sub
以及其部分来创建子菜单。
您可以通过 data-disabled
属性为禁用的项添加特殊样式。
使用 Separator
部件在项之间添加分隔符。
使用 Label
部件帮助标记一个部分。
使用 CheckboxItem
部件添加一个可以被选中的项。
使用 RadioGroup
和 RadioItem
部件,添加一个可以在其他选项中选择的项。
您可以在 Item
部件中添加额外的装饰元素,例如图像。
您可能想限制内容(或子内容)的宽度,以使其与触发器(或子触发器)的宽度匹配。您可能还希望限制其高度,以免超过视口。
我们公开了多个 CSS 自定义属性,如 --radix-dropdown-menu-trigger-width
和 --radix-dropdown-menu-content-available-height
来支持此功能。使用它们来限制内容尺寸。
我们公开了 CSS 自定义属性 --radix-dropdown-menu-content-transform-origin
。使用它从其计算的原点为内容动画,基于 side
、sideOffset
、align
、alignOffset
和任何碰撞。
我们公开了 data-side
和 data-align
属性。它们的值将在运行时更改以反映碰撞。使用它们来创建具有碰撞和方向意识的动画。
遵循 菜单按钮 WAI-ARIA 设计模式 并使用 游走 tabindex 来管理菜单项间的焦点移动。
通过将原始部件抽象为您自己的组件来创建自己的 API。
此示例抽象了 DropdownMenu.Arrow
和 DropdownMenu.ItemIndicator
部件。它还封装了 CheckboxItem
和 RadioItem
的实现细节。