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