diff --git a/docs/components/forms.md b/docs/components/forms.md index e4a5006028..743f2b8ba7 100644 --- a/docs/components/forms.md +++ b/docs/components/forms.md @@ -657,3 +657,137 @@ Block level help text for form controls. {% example html %}

A block of help text that breaks onto a new line and may extend beyond one line.

{% endexample %} + + + +## Custom forms + +For even more customization and cross browser consistency, use our completely custom form elements to replace the browser defaults. They're built on top of semantic and accessible markup, so they're solid replacements any default form control. + +### Checkboxes and radios + +Each checkbox and radio is wrapped in a ` +{% endexample %} + +The ` + + +{% endexample %} + +The file input is the most gnarly of the bunch. Here's how it works: + +- We wrap the `` in a `