Source

按鈕組

使用按鈕組將一系列按鈕組合在一行中,並使用 JavaScript 為它們提供超級強大的功能。

基本示例

.btn用in包裹一系列按鈕.btn-group使用我們的按鈕插件添加可選的 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".

此外,組和工具欄應該被賦予明確的標籤,因為大多數輔助技術不會公佈它們,儘管存在正確的角色屬性。在此處提供的示例中,我們使用,但也可以使用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>

嵌套

當您希望下拉菜單與一系列按鈕混合時,將 a.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 id="btnGroupDrop1" type="button" class="btn btn-secondary dropdown-toggle" data-toggle="dropdown" aria-haspopup="true" aria-expanded="false">
      Dropdown
    </button>
    <div class="dropdown-menu" aria-labelledby="btnGroupDrop1">
      <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>