按钮组

一排辅助样式按钮融合到一个控件中 - 来自 Button 系列的共享边框、半径/2lg 和阴影/xs,项目按细线划分,仅外角为圆角。对于带有动画拇指的分段切换器,请使用“分段控制”;按钮组是工具栏/过滤器风格。

安装

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

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

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

npx boardui@latest add button-group

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

所选项目

已选择 将项目保持在悬停填充状态并设置 aria-pressed - 从单选或多选工具栏状态驱动它。

const [view, setView] = useState("list"); <ButtonGroup aria-label="View"> {views.map(({ id, label, icon }) => ( <ButtonGroupItem key={id} leadingIcon={icon} selected={view === id} onClick={() => setView(id)} > {label} </ButtonGroupItem> ))}</ButtonGroup>

仅图标

iconOnly 项目折叠成正方形 - 给每个项目一个 aria-label 因为没有可见的文字。

{/* Icon-only items are square - aria-label each one */}<ButtonGroup size="small" aria-label="Formatting"> <ButtonGroupItem iconOnly leadingIcon={RiBold} aria-label="Bold" /> <ButtonGroupItem iconOnly leadingIcon={RiItalic} aria-label="Italic" /> <ButtonGroupItem iconOnly leadingIcon={RiUnderline} aria-label="Underline" /></ButtonGroup>