Группа кнопок
Сгруппируйте несколько кнопок в одну строку или сложите их в вертикальный столбец.
Простой пример
Оберните серию кнопок с помощью .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
. Для групп кнопок это будет role="group"
, в то время как панели инструментов должны иметь role="toolbar"
.
Кроме того, группам и панелям инструментов следует давать явные метки, поскольку в противном случае большинство вспомогательных технологий не будут их объявлять, несмотря на наличие правильного атрибута роли. В приведенных здесь примерах мы используем aria-label
, но также можно использовать такие альтернативы, как aria-labelledby
.
Эти классы также могут быть добавлены к группам ссылок в качестве альтернативы навигационным компонентам .nav
navigation components.
<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="Basic mixed styles example">
<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="Basic outlined example">
<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="...">...</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 type="button" class="btn btn-primary">1</button>
<button type="button" class="btn btn-primary">2</button>
<div class="btn-group" role="group">
<button id="btnGroupDrop1" type="button" class="btn btn-primary dropdown-toggle" data-bs-toggle="dropdown" aria-expanded="false">
Выпадающая кнопка
</button>
<ul class="dropdown-menu" aria-labelledby="btnGroupDrop1">
<li><a class="dropdown-item" href="#">Выпадающая ссылка</a></li>
<li><a class="dropdown-item" href="#">Выпадающая ссылка</a></li>
</ul>
</div>
</div>
Вертикальный вариант
Сделайте так, чтобы набор кнопок выглядел вертикально сложенными, а не горизонтально. Раскрывающиеся меню с разделенными кнопками здесь не поддерживаются.
<div class="btn-group-vertical">
...
</div>