一种在桌面应用程序中常见的可视持久菜单,它提供对一组一致命令的快速访问。
import * as React from "react";import { Menubar } from "radix-ui";import {CheckIcon,ChevronRightIcon,DotFilledIcon,} from "@radix-ui/react-icons";import "./styles.css";const RADIO_ITEMS = ["Andy", "Benoît", "Luis"];const CHECK_ITEMS = ["Always Show Bookmarks Bar", "Always Show Full URLs"];const MenubarDemo = () => {const [checkedSelection, setCheckedSelection] = React.useState([CHECK_ITEMS[1],]);const [radioSelection, setRadioSelection] = React.useState(RADIO_ITEMS[2]);return (<Menubar.Root className="MenubarRoot"><Menubar.Menu><Menubar.Trigger className="MenubarTrigger">File</Menubar.Trigger><Menubar.Portal><Menubar.Content className="MenubarContent" align="start" sideOffset={5} alignOffset={-3} ><Menubar.Item className="MenubarItem">New Tab <div className="RightSlot">⌘ T</div></Menubar.Item><Menubar.Item className="MenubarItem">New Window <div className="RightSlot">⌘ N</div></Menubar.Item><Menubar.Item className="MenubarItem" disabled>New Incognito Window</Menubar.Item><Menubar.Separator className="MenubarSeparator" /><Menubar.Sub><Menubar.SubTrigger className="MenubarSubTrigger">Share<div className="RightSlot"><ChevronRightIcon /></div></Menubar.SubTrigger><Menubar.Portal><Menubar.SubContent className="MenubarSubContent" alignOffset={-5} ><Menubar.Item className="MenubarItem">Email Link</Menubar.Item><Menubar.Item className="MenubarItem">Messages</Menubar.Item><Menubar.Item className="MenubarItem">Notes</Menubar.Item></Menubar.SubContent></Menubar.Portal></Menubar.Sub><Menubar.Separator className="MenubarSeparator" /><Menubar.Item className="MenubarItem">Print… <div className="RightSlot">⌘ P</div></Menubar.Item></Menubar.Content></Menubar.Portal></Menubar.Menu><Menubar.Menu><Menubar.Trigger className="MenubarTrigger">Edit</Menubar.Trigger><Menubar.Portal><Menubar.Content className="MenubarContent" align="start" sideOffset={5} alignOffset={-3} ><Menubar.Item className="MenubarItem">Undo <div className="RightSlot">⌘ Z</div></Menubar.Item><Menubar.Item className="MenubarItem">Redo <div className="RightSlot">⇧ ⌘ Z</div></Menubar.Item><Menubar.Separator className="MenubarSeparator" /><Menubar.Sub><Menubar.SubTrigger className="MenubarSubTrigger">Find<div className="RightSlot"><ChevronRightIcon /></div></Menubar.SubTrigger><Menubar.Portal><Menubar.SubContent className="MenubarSubContent" alignOffset={-5} ><Menubar.Item className="MenubarItem">Search the web…</Menubar.Item><Menubar.Separator className="MenubarSeparator" /><Menubar.Item className="MenubarItem">Find…</Menubar.Item><Menubar.Item className="MenubarItem">Find Next</Menubar.Item><Menubar.Item className="MenubarItem">Find Previous</Menubar.Item></Menubar.SubContent></Menubar.Portal></Menubar.Sub><Menubar.Separator className="MenubarSeparator" /><Menubar.Item className="MenubarItem">Cut</Menubar.Item><Menubar.Item className="MenubarItem">Copy</Menubar.Item><Menubar.Item className="MenubarItem">Paste</Menubar.Item></Menubar.Content></Menubar.Portal></Menubar.Menu><Menubar.Menu><Menubar.Trigger className="MenubarTrigger">View</Menubar.Trigger><Menubar.Portal><Menubar.Content className="MenubarContent" align="start" sideOffset={5} alignOffset={-14} >{CHECK_ITEMS.map((item) => (<Menubar.CheckboxItem className="MenubarCheckboxItem inset" key={item} checked={checkedSelection.includes(item)} onCheckedChange={() => setCheckedSelection((current) => current.includes(item) ? current.filter((el) => el !== item) : current.concat(item), ) } ><Menubar.ItemIndicator className="MenubarItemIndicator"><CheckIcon /></Menubar.ItemIndicator>{item}</Menubar.CheckboxItem>))}<Menubar.Separator className="MenubarSeparator" /><Menubar.Item className="MenubarItem inset">Reload <div className="RightSlot">⌘ R</div></Menubar.Item><Menubar.Item className="MenubarItem inset" disabled>Force Reload <div className="RightSlot">⇧ ⌘ R</div></Menubar.Item><Menubar.Separator className="MenubarSeparator" /><Menubar.Item className="MenubarItem inset">Toggle Fullscreen</Menubar.Item><Menubar.Separator className="MenubarSeparator" /><Menubar.Item className="MenubarItem inset">Hide Sidebar</Menubar.Item></Menubar.Content></Menubar.Portal></Menubar.Menu><Menubar.Menu><Menubar.Trigger className="MenubarTrigger">Profiles</Menubar.Trigger><Menubar.Portal><Menubar.Content className="MenubarContent" align="start" sideOffset={5} alignOffset={-14} ><Menubar.RadioGroup value={radioSelection} onValueChange={setRadioSelection} >{RADIO_ITEMS.map((item) => (<Menubar.RadioItem className="MenubarRadioItem inset" key={item} value={item} ><Menubar.ItemIndicator className="MenubarItemIndicator"><DotFilledIcon /></Menubar.ItemIndicator>{item}</Menubar.RadioItem>))}<Menubar.Separator className="MenubarSeparator" /><Menubar.Item className="MenubarItem inset">Edit…</Menubar.Item><Menubar.Separator className="MenubarSeparator" /><Menubar.Item className="MenubarItem inset">Add Profile…</Menubar.Item></Menubar.RadioGroup></Menubar.Content></Menubar.Portal></Menubar.Menu></Menubar.Root>);};export default MenubarDemo;
可控或非控。
支持具有可配置阅读方向的子菜单。
支持项、标签、项组。
支持可勾选项(单个或多个)。
自定义侧面、对齐、偏移量、碰撞处理。
可选择性地渲染指向箭头。
焦点完全管理。
完整的键盘导航。
支持提前输入。
从命令行安装组件。
导入所有部件并将其组合在一起。
包含菜单栏的所有部分。
顶级菜单项,包含触发器与内容组合。
切换内容的按钮。默认情况下,Menubar.Content
将相对于触发器进行定位。
当使用时,将内容部分传送到 body
。
菜单打开时弹出的组件。
一个可选的箭头元素,可以与菜单栏菜单一起呈现。这可以帮助在视觉上将触发器与 Menubar.Content
关联。必须在 Menubar.Content
内部呈现。
包含菜单栏项的组件。
用于分组多个 Menubar.Item
。
用于呈现标签。无法使用箭头键聚焦。
可以控制并呈现为复选框的项。
用于分组多个 Menubar.RadioItem
。
可以控制并呈现为单选的项。
当父 Menubar.CheckboxItem
或 Menubar.RadioItem
被选中时呈现。您可以直接样式化此元素,或者将其用作放置图标的包装器,或两者兼而有之。
用于在菜单栏菜单中视觉上分隔项。
包含子菜单的所有部分。
打开子菜单的项。必须在 Menubar.Sub
内部呈现。
子菜单打开时弹出的组件。必须在 Menubar.Sub
内部呈现。
您可以通过结合使用 Menubar.Sub
及其部分来创建子菜单。
您可以通过 data-disabled
属性为禁用项添加特殊样式。
使用 Separator
部件在项之间添加分隔符。
使用 Label
部件帮助标记一个部分。
使用 CheckboxItem
部件添加可以勾选的项。
使用 RadioGroup
和 RadioItem
部件添加可以在其他选项之间选择的项。
您可以在 Item
部件中添加额外的装饰元素,例如图像。
您可能希望限制内容(或子内容)的宽度,以与触发器(或子触发器)宽度匹配。您还可能希望限制其高度,以不超过视口。
我们公开几个 CSS 自定义属性,例如 --radix-menubar-trigger-width
和 --radix-menubar-content-available-height
来支持此功能。使用它们限制内容尺寸。
我们公开一个 CSS 自定义属性 --radix-menubar-content-transform-origin
。使用它根据 side
、sideOffset
、align
、alignOffset
和任何碰撞进行内容动画。
我们公开 data-side
和 data-align
属性。它们的值将在运行时更改以反映碰撞。使用它们创建碰撞和方向感知的动画。
遵循 菜单按钮 WAI-ARIA 设计模式 并使用 游走的 tabindex 来管理菜单项之间的焦点移动。