Группа кнопок
Группируйте серию кнопок вместе на одной строке или складывайте их в вертикальный столбец.
Базовый пример
Оберните серию кнопок с .btn
в .btn-group
.
<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
.
<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>
Смешанные стили
<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>
Контурные стили
<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>
Группы чекбоксов и радиокнопок
Объедините кнопки-переключатели чекбоксов и радио, похожие на кнопки, в бесшовно выглядящую группу кнопок.
<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>
<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>
Панель инструментов кнопок
Объедините наборы групп кнопок в панели инструментов кнопок для более сложных компонентов. Используйте утилитарные классы по мере необходимости для разделения групп, кнопок и многого другого.
<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>
Не стесняйтесь смешивать группы ввода с группами кнопок в ваших панелях инструментов. Аналогично примеру выше, вам, вероятно, понадобятся некоторые утилиты для правильного разделения вещей.
<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
, включая каждый при вложении нескольких групп.
<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
, когда вы хотите выпадающие меню, смешанные с серией кнопок.
<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>
Вертикальная вариация
Заставьте набор кнопок отображаться вертикально сложенными, а не горизонтально. Разделенные кнопки выпадающих списков здесь не поддерживаются.
<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>
<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>
<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>