5.5 KiB
| layout | title | description | group | toc |
|---|---|---|---|---|
| docs | Form controls | Give textual form controls like `<input>`s and `<textarea>`s an upgrade with custom styles, sizing, focus states, and more. | forms | true |
Example
{{< example >}}
Sizing
Set heights using classes like .form-control-lg and .form-control-sm.
{{< example >}} {{< /example >}}
Disabled
Add the disabled boolean attribute on an input to give it a grayed out appearance and remove pointer events.
{{< example >}} {{< /example >}}
Readonly
Add the readonly boolean attribute on an input to prevent modification of the input's value.
{{< example >}} {{< /example >}}
Readonly plain text
If you want to have <input readonly> elements in your form styled as plain text, use the .form-control-plaintext class to remove the default form field styling and preserve the correct margin and padding.
{{< example >}}
{{< example >}}
File input
{{< example >}}
Color
{{< example >}} {{< /example >}}
Datalists
Datalists allow you to create a group of <option>s that can be accessed (and autocompleted) from within an <input>. These are similar to <select> elements, but come with more menu styling limitations and differences. While most browsers and operating systems include some support for <datalist> elements, their styling is inconsistent at best.
Learn more about support for datalist elements.
{{< example >}}
{{< /example >}}Sass
Variables
$input-* are shared across most of our form controls (and not buttons).
{{< scss-docs name="form-input-variables" file="scss/_variables.scss" >}}
$form-label-* and $form-text-* are for our <label>s and .form-text component.
{{< scss-docs name="form-label-variables" file="scss/_variables.scss" >}}
{{< scss-docs name="form-text-variables" file="scss/_variables.scss" >}}
$form-file-* are for file input.
{{< scss-docs name="form-file-variables" file="scss/_variables.scss" >}}