在 GitHub 上查看
按钮组
使用按钮组将一系列按钮组合在单行上,并使用 JavaScript 为其赋予超能力。
基本示例
使用 .btn-group
中的 .btn
包装一系列按钮。使用 我们的按钮插件 添加可选的 JavaScript 单选按钮和复选框样式行为。
<div class="btn-group" role="group" aria-label="Basic example">
<button type="button" class="btn btn-secondary">Left</button>
<button type="button" class="btn btn-secondary">Middle</button>
<button type="button" class="btn btn-secondary">Right</button>
</div>
确保正确的 role
并提供标签
为了让辅助技术(如屏幕阅读器)传达一系列按钮已分组,需要提供适当的 role
属性。对于按钮组,这将是 role="group"
,而工具栏应具有 role="toolbar"
。
此外,应为组和工具栏提供明确的标签,因为尽管存在正确的 role 属性,但大多数辅助技术不会宣布它们。在本文档提供的示例中,我们使用 aria-label
,但也可以使用其他替代方案,如 aria-labelledby
。
按钮工具栏
将成组的按钮组合到按钮工具栏中,以获得更复杂的组件。根据需要使用实用程序类来为组、按钮等设置间距。
<div class="btn-toolbar" role="toolbar" aria-label="Toolbar with button groups">
<div class="btn-group mr-2" role="group" aria-label="First group">
<button type="button" class="btn btn-secondary">1</button>
<button type="button" class="btn btn-secondary">2</button>
<button type="button" class="btn btn-secondary">3</button>
<button type="button" class="btn btn-secondary">4</button>
</div>
<div class="btn-group mr-2" role="group" aria-label="Second group">
<button type="button" class="btn btn-secondary">5</button>
<button type="button" class="btn btn-secondary">6</button>
<button type="button" class="btn btn-secondary">7</button>
</div>
<div class="btn-group" role="group" aria-label="Third group">
<button type="button" class="btn btn-secondary">8</button>
</div>
</div>
请随意在工具栏中将输入组与按钮组混合使用。与上述示例类似,您可能需要一些实用程序来正确设置间距。
<div class="btn-toolbar mb-3" role="toolbar" aria-label="Toolbar with button groups">
<div class="btn-group mr-2" role="group" aria-label="First group">
<button type="button" class="btn btn-secondary">1</button>
<button type="button" class="btn btn-secondary">2</button>
<button type="button" class="btn btn-secondary">3</button>
<button type="button" class="btn btn-secondary">4</button>
</div>
<div class="input-group">
<div class="input-group-prepend">
<div class="input-group-text" id="btnGroupAddon">@</div>
</div>
<input type="text" class="form-control" placeholder="Input group example" aria-label="Input group example" aria-describedby="btnGroupAddon">
</div>
</div>
<div class="btn-toolbar justify-content-between" role="toolbar" aria-label="Toolbar with button groups">
<div class="btn-group" role="group" aria-label="First group">
<button type="button" class="btn btn-secondary">1</button>
<button type="button" class="btn btn-secondary">2</button>
<button type="button" class="btn btn-secondary">3</button>
<button type="button" class="btn btn-secondary">4</button>
</div>
<div class="input-group">
<div class="input-group-prepend">
<div class="input-group-text" id="btnGroupAddon2">@</div>
</div>
<input type="text" class="form-control" placeholder="Input group example" aria-label="Input group example" aria-describedby="btnGroupAddon2">
</div>
</div>
尺寸
不要对组中的每个按钮应用按钮尺寸类,只需将 .btn-group-*
添加到每个 .btn-group
,包括在嵌套多个组时添加每个组。
<div class="btn-group btn-group-lg" role="group" aria-label="...">...</div>
<div class="btn-group" role="group" aria-label="...">...</div>
<div class="btn-group btn-group-sm" role="group" aria-label="...">...</div>
嵌套
当您希望将下拉菜单与一系列按钮混合使用时,请将 .btn-group
放置在另一个 .btn-group
中。
<div class="btn-group" role="group" aria-label="Button group with nested dropdown">
<button type="button" class="btn btn-secondary">1</button>
<button type="button" class="btn btn-secondary">2</button>
<div class="btn-group" role="group">
<button type="button" class="btn btn-secondary dropdown-toggle" data-toggle="dropdown" aria-expanded="false">
Dropdown
</button>
<div class="dropdown-menu">
<a class="dropdown-item" href="#">Dropdown link</a>
<a class="dropdown-item" href="#">Dropdown link</a>
</div>
</div>
</div>
垂直变化
使一组按钮垂直堆叠显示,而不是水平显示。此处不支持拆分按钮下拉菜单。
<div class="btn-group-vertical">
...
</div>