下拉菜单

一个基于 React Aria 构建的可组合弹出菜单 - Select 在其触发器中选择一个值,Dropdown 是一个自由形式的分组操作行面板,带有 BoardUI 表面(半径 16,下拉阴影)和 150ms 缩放 + 模糊出现动画。仪表盘侧边栏的团队和账户菜单以及人工智能聊天编辑器的添加菜单背后的配方相同。

安装

您可以使用我们的 CLI 或手动添加此下拉组件:

已支持深色模式,此 组件 会自动使用 BoardUI 的语义设计变量。 设置主题切换.

CLI 将组件源(及其内部依赖项)复制到您的项目中并安装任何所需的 npm 包。

npx boardui@latest add dropdown

使用共享 UI 包或自定义导入别名? 配置您的安装路径 在运行 CLI 之前。复制粘贴示例使用默认导入。

模型选择器

AI 聊天编辑器的模型菜单:行充当单选组 - 已选择 保持当前行突出显示,并且无线电标志符号位于该行的末尾 justify-between.

{/* Radio-group rows: selected state on the row + a radio glyph at the end */}const [model, setModel] = useState("Fable 5"); <Dropdown isOpen={isOpen} onOpenChange={setIsOpen}> <DropdownTrigger className="…pill trigger with the current model + chevron…"> {model} <ChevronDownSmall className={cx("size-4", isOpen && "rotate-180")} /> </DropdownTrigger> <DropdownPopover aria-label="Models" placement="bottom start"> <DropdownGroup label="Models"> <div role="radiogroup" aria-label="Model" className="flex w-full flex-col gap-1"> {MODELS.map((name) => ( <DropdownItem key={name} selected={name === model} onSelect={() => { setModel(name); setIsOpen(false); }} className="justify-between gap-2.5" > <span className="truncate text-body-medium text-text-primary">{name}</span> <RadioDot selected={name === model} /> </DropdownItem> ))} </div> </DropdownGroup> </DropdownPopover></Dropdown>

团队菜单

侧边栏的团队卡菜单:页眉和页脚并排 DropdownGroup作为普通兄弟姐妹,行带有尾随徽章,并且 DropdownDivider 渗透各部分之间的面板填充。

{/* Header, grouped rows with counters, and a footer in one panel */}<Dropdown isOpen={isOpen} onOpenChange={setIsOpen}> <DropdownTrigger aria-label="Board team" className="…team card styles…"> <Avatar size="md" color="blue" src="/logo.png" alt="Board team" /> …name, email, chevron… </DropdownTrigger> <DropdownPopover aria-label="Board team menu" className="w-[265px]" dialogClassName="gap-[7px]"> <div className="flex items-center gap-2 px-2 pt-1"> <Avatar size="md" color="blue" src="/logo.png" alt="Board team" /> …name + email… </div> <DropdownGroup> <DropdownItem onSelect={close}> <span className="flex min-w-0 flex-1 items-center gap-2"> <RiMessage2Line className="size-5 text-foreground-icon-secondary" aria-hidden /> <span className="truncate text-body-medium text-text-primary">Messages</span> </span> <Counter color="neutral" className="bg-team-menu-count-background text-team-menu-count-foreground">94</Counter> </DropdownItem> </DropdownGroup> <DropdownDivider /> <DropdownGroup label="Company">…</DropdownGroup> </DropdownPopover></Dropdown>

账户菜单

侧边栏的账户切换器:行呈现头像而不是图标,面板通过一对辅助按钮关闭 - 行内容是自由格式的,因此任何内容都可以在 DropdownItem.

{/* Row content is free-form: avatars, then buttons below a divider */}<DropdownPopover aria-label="Account menu" className="w-[265px]"> <DropdownGroup label="Users with access"> {users.map((user) => ( <DropdownItem key={user.name} onSelect={close} className="px-2 py-1.5"> <Avatar size="xs" color={user.color} initials={user.initials} /> <span className="truncate text-body-medium text-text-primary">{user.name}</span> </DropdownItem> ))} </DropdownGroup> <DropdownDivider className="my-3.5" /> <div className="flex items-center gap-3 px-2 pb-2"> <Button variant="secondary" size="small" leadingIcon={RiAddFill} className="flex-1"> Add user </Button> <Button variant="secondary" size="small" leadingIcon={RiEqualizer3Line} className="flex-1"> Manage </Button> </div></DropdownPopover>