7.1 KiB
layout | title | group |
---|---|---|
docs | Forms | material-design |
Bootstrap provides several form control styles, layout options, and custom components for creating a wide variety of forms.
Contents
- Will be replaced with the ToC, excluding the "Contents" header {:toc}
Form controls
Form controls flavored by Material Design for Bootstrap customizations such as label-floating
.
{% example html %}
Below is a complete list of options supported by Material Design for Bootstrap and the classes that customize them. Additional documentation is available for each group.
Classes | Used for | Notes |
---|---|---|
{% markdown %}`.mdb-form-group`{% endmarkdown %} | Any group of form controls | {% markdown %}This is automatically added by javascript, but if your code is templated, adding `.mdb-form-group` to your form groups or otherwise your groups of controls can reduce rendering churn since the javascript will not add the class after the initial page rendering.{% endmarkdown %} |
{% markdown %}`.label-floating`{% endmarkdown %} |
|
Form groups
The .mdb-form-group
class is usually added to the .form-group
element. Whereas the .form-group
adds structure to forms by providing margin-bottom
around a label and control pairing,
the only purpose of the .mdb-form-group
is to demarcate Material Design behaviors. Decorations and size variations are intended to be specified on
this element e.g. .label-floating
. Focus/hover styling for the label/input is determined based on the .mdb-form-group
.
The .mdb-form-group
is added automatically by javascript through basic discovery of the outer demarcation of the component defined by the Bootstrap standard
markup. If your code is templated, you may want to add .mdb-form-group
to the markup directly to prevent any rendering churn from the javascript determining
and adding the class to the markup. In custom situations, the javascript may not be able to properly resolve the location for the .mdb-form-group
, so in rare cases
you may need to wrap your markup in an .mdb-form-group
to get appropriate focus/hover behavior.
{% example html %}
{% endexample %}Inline forms
Use the .form-inline
class to to display a series of labels, form controls, and buttons on a single horizontal row. Form controls within inline forms behave differently:
- Controls are
display: inline-block
to provide alignment control viavertical-align
andmargin
. - Controls receive
width: auto
to override the Bootstrap defaultwidth: 100%
. - Controls only appear inline in viewports that are at least 768px wide to account for narrow viewports on mobile devices.
Because of this, you may need to manually address the width and alignment of individual form controls. Lastly, as shown below, you should always include a <label>
with each form control.
Visible labels
{% example html %}