Government of
India
Powered by NeGD | MeitY Government of India® UX4G
Button Group
Group a series of buttons together on a single line or stack them in a vertical column
Basic example #
Wrap a series of buttons with
.btn in .btn-group.
<div class="btn-group" role="group" aria-label="Basic example"><button type="button" class="btn btn-primary">Left</button><button type="button" class="btn btn-primary">Middle</button><button type="button" class="btn btn-primary">Right</button></div>
RESULT
Ensure correct
role and provide a label
An appropriate role attribute must be offered in order for assistive technology (like screen readers) to indicate that a group of buttons is present. This would be role="group" for button groups, and role="toolbar" for toolbars.
In addition, even when the right role property is present, groups and toolbars should have an explicit label because most assistive technologies won't otherwise announce them. While aria-label is used in the examples given here, there are other options available, such as aria-labelledby.
These classes can also be added to
groups of links, as an alternative to the .nav
navigation components.
<div class="btn-group"><a href="#" class="btn btn-primary active" aria-current="page">Active link</a><a href="#" class="btn btn-primary">Link</a><a href="#" class="btn btn-primary">Link</a></div>
RESULT
Mixed styles #
<div class="btn-group" role="group" aria-label="Basic mixed styles example"><button type="button" class="btn btn-danger">Left</button><button type="button" class="btn btn-warning">Middle</button><button type="button" class="btn btn-success">Right</button></div>
RESULT
Outlined styles #
<div class="btn-group" role="group" aria-label="Basic outlined example"><button type="button" class="btn btn-outline-primary">Left</button><button type="button" class="btn btn-outline-primary">Middle</button><button type="button" class="btn btn-outline-primary">Right</button></div>
RESULT
Checkbox and radio button groups #
Combine button-like checkbox and radio toggle buttons into a seamless looking button group.
<div class="btn-group" role="group" aria-label="Basic checkbox toggle button group"><input type="checkbox" class="btn-check" id="btncheck1" autocomplete="off"/><label class="btn btn-outline-primary" for="btncheck1">Checkbox 1</label><input type="checkbox" class="btn-check" id="btncheck2" autocomplete="off"/><label class="btn btn-outline-primary" for="btncheck2">Checkbox 2</label><input type="checkbox" class="btn-check" id="btncheck3" autocomplete="off"/><label class="btn btn-outline-primary" for="btncheck3">Checkbox 3</label></div>
RESULT
<div class="btn-group" role="group" aria-label="Basic radio toggle button group"><input type="radio" class="btn-check" name="btnradio" id="btnradio1" autocomplete="off" checked><label class="btn btn-outline-primary" for="btnradio1">Radio 1</label><input type="radio" class="btn-check" name="btnradio" id="btnradio2" autocomplete="off"><label class="btn btn-outline-primary" for="btnradio2">Radio 2</label><input type="radio" class="btn-check" name="btnradio" id="btnradio3" autocomplete="off"><label class="btn btn-outline-primary" for="btnradio3">Radio 3</label></div>
RESULT
Button toolbar #
For more complicated components, combine sets of button groups into button toolbars. If there is a need to space out groups, buttons, and other things, use utility classes.
<div class="btn-toolbar" role="toolbar" aria-label="Toolbar with button groups"><div class="btn-group me-2" role="group" aria-label="First group"><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="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-info">8</button></div></div>
RESULT
In the toolbars, feel free to mix input groups and button groups. To space things properly, though, it will probably need some tools, similar to the example above.
<div class="btn-toolbar mb-3" role="toolbar" aria-label="Toolbar with button groups"><div class="btn-group me-2" role="group" aria-label="First group"><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="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-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="Input group example" aria-label="Input group example" aria-describedby="btnGroupAddon2"></div></div>
RESULT
@@
Sizing #
Simply add .btn-group-* to each .btn-group, including each one when nesting several groups, to avoid applying button size classes to every button in a group.
<div class="btn-group btn-group-lg" role="group" aria-label="Large button group">
<button type="button" class="btn btn-outline-dark">Left</button>
<button type="button" class="btn btn-outline-dark">Middle</button>
<button type="button" class="btn btn-outline-dark">Right</button>
</div>
<br/>
<div class="btn-group" role="group" aria-label="Default button group">
<button type="button" class="btn btn-outline-dark">Left</button>
<button type="button" class="btn btn-outline-dark">Middle</button>
<button type="button" class="btn btn-outline-dark">Right</button>
</div>
<br/>
<div class="btn-group btn-group-sm" role="group" aria-label="Small button group">
<button type="button" class="btn btn-outline-dark">Left</button>
<button type="button" class="btn btn-outline-dark">Middle</button>
<button type="button" class="btn btn-outline-dark">Right</button>
</div>RESULT
Nesting #
Put one .btn-group inside another. When wanting a succession of buttons and dropdown menus combined, use btn-group.
<div class="btn-group" role="group" aria-label="Button group with nested dropdown"><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">Dropdown</button><ul class="dropdown-menu"><li><a class="dropdown-item" href="#">Dropdown link</a></li><li><a class="dropdown-item" href="#">Dropdown link</a></li></ul></div></div>
RESULT
Vertical variation #
Transform a row of buttons so that they stand vertically instead of horizontally. Dropdowns for split buttons are not yet supported.
<div class="btn-group-vertical" role="group" aria-label="Vertical button group"><button type="button" class="btn btn-dark">Button</button><button type="button" class="btn btn-dark">Button</button><button type="button" class="btn btn-dark">Button</button><button type="button" class="btn btn-dark">Button</button><button type="button" class="btn btn-dark">Button</button><button type="button" class="btn btn-dark">Button</button></div>
RESULT
<div class="btn-group-vertical" role="group" aria-label="Vertical button group"><button type="button" class="btn btn-primary">Button</button><button type="button" class="btn btn-primary">Button</button><div class="btn-group" role="group"><button type="button" class="btn btn-primary dropdown-toggle" data-bs-toggle="dropdown" aria-expanded="false">Dropdown</button><ul class="dropdown-menu"><li><a class="dropdown-item" href="#">Dropdown link</a></li><li><a class="dropdown-item" href="#">Dropdown link</a></li></ul></div><button type="button" class="btn btn-primary">Button</button><button type="button" class="btn btn-primary">Button</button><div class="btn-group" role="group"><button type="button" class="btn btn-primary dropdown-toggle" data-bs-toggle="dropdown" aria-expanded="false">Dropdown</button><ul class="dropdown-menu"><li><a class="dropdown-item" href="#">Dropdown link</a></li><li><a class="dropdown-item" href="#">Dropdown link</a></li></ul></div><div class="btn-group" role="group"><button type="button" class="btn btn-primary dropdown-toggle" data-bs-toggle="dropdown" aria-expanded="false">Dropdown</button><ul class="dropdown-menu"><li><a class="dropdown-item" href="#">Dropdown link</a></li><li><a class="dropdown-item" href="#">Dropdown link</a></li></ul></div><div class="btn-group" role="group"><button type="button" class="btn btn-primary dropdown-toggle" data-bs-toggle="dropdown" aria-expanded="false">Dropdown</button><ul class="dropdown-menu"><li><a class="dropdown-item" href="#">Dropdown link</a></li><li><a class="dropdown-item" href="#">Dropdown link</a></li></ul></div></div>
RESULT
<div class="btn-group-vertical" role="group" aria-label="Vertical radio toggle button group"><input type="radio" class="btn-check" name="vbtn-radio" id="vbtn-radio1" autocomplete="off" checked/><label class="btn btn-outline-danger" for="vbtn-radio1">Radio 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">Radio 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">Radio 3</label></div>
