Перейти к основному контенту Перейти к навигации документации

Группа кнопок

Группируйте серию кнопок вместе на одной строке или складывайте их в вертикальный столбец.

Базовый пример

Оберните серию кнопок с .btn в .btn-group.

html
<div class="btn-group" role="group" aria-label="Базовый пример">
  <button type="button" class="btn btn-primary">Левая</button>
  <button type="button" class="btn btn-primary">Средняя</button>
  <button type="button" class="btn btn-primary">Правая</button>
</div>

Группы кнопок требуют соответствующий атрибут role и явную метку, чтобы обеспечить идентификацию кнопок как сгруппированных и их объявление вспомогательными технологиями, такими как программы чтения с экрана. Используйте role="group" для групп кнопок или role="toolbar" для панелей инструментов кнопок. Затем используйте aria-label или aria-labelledby для их маркировки.

Эти классы также можно добавить к группам ссылок как альтернативу компонентам навигации .nav.

html
<div class="btn-group">
  <a href="#" class="btn btn-primary active" aria-current="page">Активная ссылка</a>
  <a href="#" class="btn btn-primary">Ссылка</a>
  <a href="#" class="btn btn-primary">Ссылка</a>
</div>

Смешанные стили

html
<div class="btn-group" role="group" aria-label="Базовый пример смешанных стилей">
  <button type="button" class="btn btn-danger">Левая</button>
  <button type="button" class="btn btn-warning">Средняя</button>
  <button type="button" class="btn btn-success">Правая</button>
</div>

Контурные стили

html
<div class="btn-group" role="group" aria-label="Базовый контурный пример">
  <button type="button" class="btn btn-outline-primary">Левая</button>
  <button type="button" class="btn btn-outline-primary">Средняя</button>
  <button type="button" class="btn btn-outline-primary">Правая</button>
</div>

Группы чекбоксов и радиокнопок

Объедините кнопки-переключатели чекбоксов и радио, похожие на кнопки, в бесшовно выглядящую группу кнопок.

html
<div class="btn-group" role="group" aria-label="Базовая группа кнопок-переключателей чекбоксов">
  <input type="checkbox" class="btn-check" id="btncheck1" autocomplete="off">
  <label class="btn btn-outline-primary" for="btncheck1">Чекбокс 1</label>

  <input type="checkbox" class="btn-check" id="btncheck2" autocomplete="off">
  <label class="btn btn-outline-primary" for="btncheck2">Чекбокс 2</label>

  <input type="checkbox" class="btn-check" id="btncheck3" autocomplete="off">
  <label class="btn btn-outline-primary" for="btncheck3">Чекбокс 3</label>
</div>
html
<div class="btn-group" role="group" aria-label="Базовая группа кнопок-переключателей радио">
  <input type="radio" class="btn-check" name="btnradio" id="btnradio1" autocomplete="off" checked>
  <label class="btn btn-outline-primary" for="btnradio1">Радио 1</label>

  <input type="radio" class="btn-check" name="btnradio" id="btnradio2" autocomplete="off">
  <label class="btn btn-outline-primary" for="btnradio2">Радио 2</label>

  <input type="radio" class="btn-check" name="btnradio" id="btnradio3" autocomplete="off">
  <label class="btn btn-outline-primary" for="btnradio3">Радио 3</label>
</div>

Панель инструментов кнопок

Объедините наборы групп кнопок в панели инструментов кнопок для более сложных компонентов. Используйте утилитарные классы по мере необходимости для разделения групп, кнопок и многого другого.

html
<div class="btn-toolbar" role="toolbar" aria-label="Панель инструментов с группами кнопок">
  <div class="btn-group me-2" role="group" aria-label="Первая группа">
    <button type="button" class="btn btn-primary">1</button>
    <button type="button" class="btn btn-primary">2</button>
    <button type="button" class="btn btn-primary">3</button>
    <button type="button" class="btn btn-primary">4</button>
  </div>
  <div class="btn-group me-2" role="group" aria-label="Вторая группа">
    <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="Третья группа">
    <button type="button" class="btn btn-info">8</button>
  </div>
</div>

Не стесняйтесь смешивать группы ввода с группами кнопок в ваших панелях инструментов. Аналогично примеру выше, вам, вероятно, понадобятся некоторые утилиты для правильного разделения вещей.

html
<div class="btn-toolbar mb-3" role="toolbar" aria-label="Панель инструментов с группами кнопок">
  <div class="btn-group me-2" role="group" aria-label="Первая группа">
    <button type="button" class="btn btn-outline-secondary">1</button>
    <button type="button" class="btn btn-outline-secondary">2</button>
    <button type="button" class="btn btn-outline-secondary">3</button>
    <button type="button" class="btn btn-outline-secondary">4</button>
  </div>
  <div class="input-group">
    <div class="input-group-text" id="btnGroupAddon">@</div>
    <input type="text" class="form-control" placeholder="Пример группы ввода" aria-label="Пример группы ввода" aria-describedby="btnGroupAddon">
  </div>
</div>

<div class="btn-toolbar justify-content-between" role="toolbar" aria-label="Панель инструментов с группами кнопок">
  <div class="btn-group" role="group" aria-label="Первая группа">
    <button type="button" class="btn btn-outline-secondary">1</button>
    <button type="button" class="btn btn-outline-secondary">2</button>
    <button type="button" class="btn btn-outline-secondary">3</button>
    <button type="button" class="btn btn-outline-secondary">4</button>
  </div>
  <div class="input-group">
    <div class="input-group-text" id="btnGroupAddon2">@</div>
    <input type="text" class="form-control" placeholder="Пример группы ввода" aria-label="Пример группы ввода" aria-describedby="btnGroupAddon2">
  </div>
</div>

Размеры

Вместо применения классов размеров кнопок к каждой кнопке в группе, просто добавьте .btn-group-* к каждому .btn-group, включая каждый при вложении нескольких групп.



html
<div class="btn-group btn-group-lg" role="group" aria-label="Большая группа кнопок">
  <button type="button" class="btn btn-outline-primary">Левая</button>
  <button type="button" class="btn btn-outline-primary">Средняя</button>
  <button type="button" class="btn btn-outline-primary">Правая</button>
</div>
<br>
<div class="btn-group" role="group" aria-label="Группа кнопок по умолчанию">
  <button type="button" class="btn btn-outline-primary">Левая</button>
  <button type="button" class="btn btn-outline-primary">Средняя</button>
  <button type="button" class="btn btn-outline-primary">Правая</button>
</div>
<br>
<div class="btn-group btn-group-sm" role="group" aria-label="Маленькая группа кнопок">
  <button type="button" class="btn btn-outline-primary">Левая</button>
  <button type="button" class="btn btn-outline-primary">Средняя</button>
  <button type="button" class="btn btn-outline-primary">Правая</button>
</div>

Вложенность

Поместите .btn-group внутри другой .btn-group, когда вы хотите выпадающие меню, смешанные с серией кнопок.

html
<div class="btn-group" role="group" aria-label="Группа кнопок с вложенным выпадающим списком">
  <button type="button" class="btn btn-primary">1</button>
  <button type="button" class="btn btn-primary">2</button>

  <div class="btn-group" role="group">
    <button type="button" class="btn btn-primary dropdown-toggle" data-bs-toggle="dropdown" aria-expanded="false">
      Выпадающий список
    </button>
    <ul class="dropdown-menu">
      <li><a class="dropdown-item" href="#">Выпадающая ссылка</a></li>
      <li><a class="dropdown-item" href="#">Выпадающая ссылка</a></li>
    </ul>
  </div>
</div>

Вертикальная вариация

Заставьте набор кнопок отображаться вертикально сложенными, а не горизонтально. Разделенные кнопки выпадающих списков здесь не поддерживаются.

html
<div class="btn-group-vertical" role="group" aria-label="Вертикальная группа кнопок">
  <button type="button" class="btn btn-primary">Кнопка</button>
  <button type="button" class="btn btn-primary">Кнопка</button>
  <button type="button" class="btn btn-primary">Кнопка</button>
  <button type="button" class="btn btn-primary">Кнопка</button>
</div>
html
<div class="btn-group-vertical" role="group" aria-label="Вертикальная группа кнопок">
  <div class="btn-group" role="group">
    <button type="button" class="btn btn-primary dropdown-toggle" data-bs-toggle="dropdown" aria-expanded="false">
      Выпадающий список
    </button>
    <ul class="dropdown-menu">
      <li><a class="dropdown-item" href="#">Выпадающая ссылка</a></li>
      <li><a class="dropdown-item" href="#">Выпадающая ссылка</a></li>
    </ul>
  </div>
  <button type="button" class="btn btn-primary">Кнопка</button>
  <button type="button" class="btn btn-primary">Кнопка</button>
  <div class="btn-group dropstart" role="group">
    <button type="button" class="btn btn-primary dropdown-toggle" data-bs-toggle="dropdown" aria-expanded="false">
      Выпадающий список
    </button>
    <ul class="dropdown-menu">
      <li><a class="dropdown-item" href="#">Выпадающая ссылка</a></li>
      <li><a class="dropdown-item" href="#">Выпадающая ссылка</a></li>
    </ul>
  </div>
  <div class="btn-group dropend" role="group">
    <button type="button" class="btn btn-primary dropdown-toggle" data-bs-toggle="dropdown" aria-expanded="false">
      Выпадающий список
    </button>
    <ul class="dropdown-menu">
      <li><a class="dropdown-item" href="#">Выпадающая ссылка</a></li>
      <li><a class="dropdown-item" href="#">Выпадающая ссылка</a></li>
    </ul>
  </div>
  <div class="btn-group dropup" role="group">
    <button type="button" class="btn btn-primary dropdown-toggle" data-bs-toggle="dropdown" aria-expanded="false">
      Выпадающий список
    </button>
    <ul class="dropdown-menu">
      <li><a class="dropdown-item" href="#">Выпадающая ссылка</a></li>
      <li><a class="dropdown-item" href="#">Выпадающая ссылка</a></li>
    </ul>
  </div>
</div>
html
<div class="btn-group-vertical" role="group" aria-label="Вертикальная группа кнопок-переключателей радио">
  <input type="radio" class="btn-check" name="vbtn-radio" id="vbtn-radio1" autocomplete="off" checked>
  <label class="btn btn-outline-danger" for="vbtn-radio1">Радио 1</label>
  <input type="radio" class="btn-check" name="vbtn-radio" id="vbtn-radio2" autocomplete="off">
  <label class="btn btn-outline-danger" for="vbtn-radio2">Радио 2</label>
  <input type="radio" class="btn-check" name="vbtn-radio" id="vbtn-radio3" autocomplete="off">
  <label class="btn btn-outline-danger" for="vbtn-radio3">Радио 3</label>
</div>