aboutsummaryrefslogtreecommitdiff
path: root/docs/components/button-group.md
diff options
context:
space:
mode:
authorMark Otto <[email protected]>2015-04-16 18:54:17 -0700
committerMark Otto <[email protected]>2015-04-16 18:54:17 -0700
commit0ab1576ae227663d9e97040a486e1ca2818bab1e (patch)
treed852285be3a39c9cc73d17bea3602a0b62c0faad /docs/components/button-group.md
parent605990400eb470e50bcdfd3643b8cc10f2684836 (diff)
parent06c2862d257935871fc846670148c8767e2f6a82 (diff)
downloadbootstrap-0ab1576ae227663d9e97040a486e1ca2818bab1e.tar.xz
bootstrap-0ab1576ae227663d9e97040a486e1ca2818bab1e.zip
Merge branch 'v4' of https://github.com/twbs/derpstrap into v4
Diffstat (limited to 'docs/components/button-group.md')
-rw-r--r--docs/components/button-group.md25
1 files changed, 14 insertions, 11 deletions
diff --git a/docs/components/button-group.md b/docs/components/button-group.md
index dbb7b1a33..9f223c7de 100644
--- a/docs/components/button-group.md
+++ b/docs/components/button-group.md
@@ -5,16 +5,19 @@ title: Button group
Group a series of buttons together on a single line with the button group. Add on optional JavaScript radio and checkbox style behavior with [our buttons plugin](../javascript/#buttons).
-<div class="bs-callout bs-callout-warning">
- <h4>Tooltips &amp; popovers in button groups require special setting</h4>
- <p>When using tooltips or popovers on elements within a <code>.btn-group</code>, you'll have to specify the option <code>container: 'body'</code> to avoid unwanted side effects (such as the element growing wider and/or losing its rounded corners when the tooltip or popover is triggered).</p>
-</div>
+{% callout warning %}
+#### Tooltips & popovers in button groups require special setting
-<div class="bs-callout bs-callout-warning">
- <h4>Ensure correct <code>role</code> and provide a label</h4>
- <p>In order for assistive technologies – such as screen readers – to convey that a series of buttons is grouped, an appropriate <code>role</code> attribute needs to be provided. For button groups, this would be <code>role="group"</code>, while toolbars should have a <code>role="toolbar"</code>.</p>
- <p>In addition, groups and toolbars should be given an explicit label, as most assistive technologies will otherwise not announce them, despite the presence of the correct <code>role</code> attribute. In the examples provided here, we use <code>aria-label</code>, but alternatives such as <code>aria-labelledby</code> can also be used.</p>
-</div>
+When using tooltips or popovers on elements within a `.btn-group`, you'll have to specify the option `container: 'body'` to avoid unwanted side effects (such as the element growing wider and/or losing its rounded corners when the tooltip or popover is triggered).
+{% endcallout %}
+
+{% callout warning %}
+#### Ensure correct `role` and provide a label
+
+In order for assistive technologies – such as screen readers – to convey that a series of buttons is grouped, an appropriate `role` attribute needs to be provided. For button groups, this would be `role="group"`, while toolbars should have a `role="toolbar"`.
+
+In addition, groups and toolbars should be given an explicit label, as most assistive technologies will otherwise not announce them, despite the presence of the correct `role` attribute. In the examples provided here, we use `aria-label`, but alternatives such as `aria-labelledby` can also be used.
+{% endcallout %}
### Basic example
@@ -55,7 +58,7 @@ Combine sets of button groups into button toolbars for more complex components.
Instead of applying button sizing classes to every button in a group, just add `.btn-group-*` to each `.btn-group`, including each one when nesting multiple groups.
-<div class="bs-example">
+<div class="bd-example">
<div class="btn-group btn-group-lg" role="group" aria-label="Large button group">
<button type="button" class="btn btn-secondary">Left</button>
<button type="button" class="btn btn-secondary">Middle</button>
@@ -113,7 +116,7 @@ Place a `.btn-group` within another `.btn-group` when you want dropdown menus mi
Make a set of buttons appear vertically stacked rather than horizontally. **Split button dropdowns are not supported here.**
-<div class="bs-example">
+<div class="bd-example">
<div class="btn-group-vertical" role="group" aria-label="Vertical button group">
<button type="button" class="btn btn-secondary">Button</button>
<button type="button" class="btn btn-secondary">Button</button>