一种在桌面应用程序中常见的视觉持久菜单,可快速访问一组一致的命令。
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 设计模式和使用roving tabindex来管理菜单项之间的焦点移动。