Grupo de botões

Agrupe uma série de botões em uma única linha com o grupo de botões e super-poderá-los com JavaScript.

Exemplo básico

Enrole uma série de botões .btncom .btn-group. Adicione um rádio JavaScript opcional e comportamento de estilo de caixa de seleção com nosso plugin de botões .

<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>

Certifique-se de que está correto `role`e forneça uma etiqueta

Para que as tecnologias assistivas (como leitores de tela) transmitam que uma série de botões está agrupada, um roleatributo apropriado precisa ser fornecido. Para grupos de botões, isso seria role="group", enquanto as barras de ferramentas deveriam ter um role="toolbar".

Além disso, grupos e barras de ferramentas devem receber um rótulo explícito, pois a maioria das tecnologias assistivas não os anunciará, apesar da presença do atributo role correto. Nos exemplos fornecidos aqui, usamos aria-label, mas alternativas como aria-labelledbytambém podem ser usadas.

Combine conjuntos de grupos de botões em barras de ferramentas de botões para componentes mais complexos. Use classes de utilitário conforme necessário para espaçar grupos, botões e muito mais.

<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>

Sinta-se à vontade para misturar grupos de entrada com grupos de botões em suas barras de ferramentas. Semelhante ao exemplo acima, você provavelmente precisará de alguns utilitários para espaçar as coisas corretamente.

<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>

Dimensionamento

Em vez de aplicar classes de dimensionamento de botão a cada botão em um grupo, basta adicionar .btn-group-*a cada .btn-group, incluindo cada um ao aninhar vários grupos.

<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>

Aninhamento

Coloque um .btn-groupdentro de outro .btn-groupquando quiser menus suspensos misturados com uma série de botões.

<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>

Variação vertical

Faça um conjunto de botões aparecer empilhados verticalmente em vez de horizontalmente. Os menus suspensos de botão dividido não são suportados aqui.

<div class="btn-group-vertical">
  ...
</div>