Update checkboxes and radios docs

- Add lighter gray text to disabled state for .form-check
- Separate radios and checkboxes example
- Clarify docs

diff --git a/docs/components/forms.md b/docs/components/forms.md
index 00d26b2662a2a41a279b572e85cbec0cd9494312..8748d8455ca322f0a5cc216b4bda2a51b436bd8b 100644 (file)
--- a/docs/components/forms.md
+++ b/docs/components/forms.md
@@ -427,10 +427,12 @@ Grid-based form layouts also support large and small inputs.
 
 Default checkboxes and radios are improved upon with the help of `.form-check`, **a single class for both input types that improves the layout and behavior of their HTML elements**. Checkboxes are for selecting one or several options in a list, while radios are for selecting one option from many.
 
-Disabled checkboxes and radios are supported, but to provide a `not-allowed` cursor on hover of the parent `<label>`, you'll need to add the `.disabled` class to the parent `.form-check`.
+Disabled checkboxes and radios are supported, but to provide a `not-allowed` cursor on hover of the parent `<label>`, you'll need to add the `.disabled` class to the parent `.form-check`. The disabled class will also lighten the text color to help indicate the input's state.
 
 ### Default (stacked)
 
+By default, any number of checkboxes and radios that are immediate sibling will be vertically stacked and appropriately spaced with `.form-check`.
+
 {% example html %}
 <div class="form-check">
   <label class="form-check-label">
@@ -444,7 +446,9 @@ Disabled checkboxes and radios are supported, but to provide a `not-allowed` cur
     Option two is disabled
   </label>
 </div>
+{% endexample %}
 
+{% example html %}
 <div class="form-check">
   <label class="form-check-label">
     <input class="form-check-input" type="radio" name="exampleRadios" id="exampleRadios1" value="option1" checked>

diff --git a/scss/_forms.scss b/scss/_forms.scss
index 32836182c3630525b18ee4c9b2dd561cccac14f2..7651c10668a070a8a81c73271079dd576890c2a6 100644 (file)
--- a/scss/_forms.scss
+++ b/scss/_forms.scss
@@ -198,6 +198,7 @@ select.form-control-lg {
 
   &.disabled {
     .form-check-label {
+      color: $text-muted;
       cursor: $cursor-disabled;
     }
   }