Form controls
Give textual form controls like <input>
s and <textarea>
s an upgrade with custom styles, sizing, focus states, and more.
Example
<div class="mb-3">
<label for="exampleFormControlInput1" class="form-label">Email address</label>
<input type="email" class="form-control" id="exampleFormControlInput1" placeholder="name@example.com">
</div>
<div class="mb-3">
<label for="exampleFormControlTextarea1" class="form-label">Example textarea</label>
<textarea class="form-control" id="exampleFormControlTextarea1" rows="3"></textarea>
</div>
Sizing
Set heights using classes like .form-control-lg
.
<input class="form-control form-control-lg" type="text" placeholder=".form-control-lg" aria-label=".form-control-lg example">
<input class="form-control" type="text" placeholder="Default input" aria-label="default input example">
Disabled
Add the disabled
boolean attribute on an input to give it a grayed out appearance, remove pointer events, and prevent focusing.
<input class="form-control" type="text" placeholder="Disabled input" aria-label="Disabled input example" disabled>
<input class="form-control" type="text" value="Disabled readonly input" aria-label="Disabled input example" disabled readonly>
Readonly
Add the readonly
boolean attribute on an input to prevent modification of the input’s value. readonly
inputs can still be focused and selected, while disabled
inputs cannot.
<input class="form-control" type="text" value="Readonly input here..." aria-label="readonly input example" readonly>
Readonly plain text
If you want to have <input readonly>
elements in your form styled as plain text, replace .form-control
with .form-control-plaintext
to remove the default form field styling and preserve the correct margin
and padding
.
<div class="mb-3 row">
<label for="staticEmail" class="col-sm-2 col-form-label">Email</label>
<div class="col-sm-10">
<input type="text" readonly class="form-control-plaintext" id="staticEmail" value="email@example.com">
</div>
</div>
<div class="mb-3 row">
<label for="inputPassword" class="col-sm-2 col-form-label">Password</label>
<div class="col-sm-10">
<input type="password" class="form-control" id="inputPassword">
</div>
</div>
<form class="row g-3">
<div class="col-auto">
<label for="staticEmail2" class="visually-hidden">Email</label>
<input type="text" readonly class="form-control-plaintext" id="staticEmail2" value="email@example.com">
</div>
<div class="col-auto">
<label for="inputPassword2" class="visually-hidden">Password</label>
<input type="password" class="form-control" id="inputPassword2" placeholder="Password">
</div>
<div class="col-auto">
<button type="submit" class="btn btn-primary mb-3">Confirm identity</button>
</div>
</form>
File input
<div class="mb-3">
<label for="formFile" class="form-label">Default file input example</label>
<input class="form-control" type="file" id="formFile">
</div>
<div class="mb-3">
<label for="formFileMultiple" class="form-label">Multiple files input example</label>
<input class="form-control" type="file" id="formFileMultiple" multiple>
</div>
<div class="mb-3">
<label for="formFileDisabled" class="form-label">Disabled file input example</label>
<input class="form-control" type="file" id="formFileDisabled" disabled>
</div>
<div>
<label for="formFileLg" class="form-label">Large file input example</label>
<input class="form-control form-control-lg" id="formFileLg" type="file">
</div>
Color
Set the type="color"
and add .form-control-color
to the <input>
. We use the modifier class to set fixed height
s and override some inconsistencies between browsers.
<label for="exampleColorInput" class="form-label">Color picker</label>
<input type="color" class="form-control form-control-color" id="exampleColorInput" value="#563d7c" title="Choose your color">
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.
<label for="exampleDataList" class="form-label">Datalist example</label>
<input class="form-control" list="datalistOptions" id="exampleDataList" placeholder="Type to search...">
<datalist id="datalistOptions">
<option value="San Francisco">
<option value="New York">
<option value="Seattle">
<option value="Los Angeles">
<option value="Chicago">
</datalist>
Sass
Variables
$input-*
are shared across most of our form controls (and not buttons).
$input-padding-y: $input-btn-padding-y;
$input-padding-x: $spacer * .5;
$input-font-family: $input-btn-font-family;
$input-font-size: $input-btn-font-size;
$input-font-weight: $font-weight-bold;
$input-line-height: $input-btn-line-height;
$input-padding-y-sm: divide($input-padding-y, 2); // Boosted mod
$input-padding-x-sm: divide($input-padding-y, 2); // Boosted mod
// Boosted mod: no $input-font-size-sm
$input-padding-y-lg: $input-btn-padding-y-lg;
$input-padding-x-lg: $input-btn-padding-x-lg;
$input-font-size-lg: $input-btn-font-size-lg;
$input-bg: $body-bg;
$input-disabled-color: $gray-700; // Boosted mod
$input-disabled-bg: $gray-300;
$input-disabled-border-color: null;
$input-color: var(--#{$prefix}body-color);
$input-border-color: $gray-500;
$input-border-width: $input-btn-border-width;
$input-box-shadow: $box-shadow-inset;
$input-border-radius: $border-radius;
// Boosted mod: no input-sm
$input-border-radius-lg: $border-radius-lg;
$input-focus-bg: $input-bg;
$input-focus-border-color: currentcolor;
$input-focus-color: $input-color;
$input-focus-width: $input-btn-focus-width;
$input-focus-box-shadow: $input-btn-focus-box-shadow;
$input-placeholder-color: $gray-700;
$input-plaintext-color: var(--#{$prefix}body-color);
$input-height-inner: add($input-line-height * 1em, $input-padding-y * 2);
$input-height-inner-half: $spacer; // Boosted mod
$input-height-inner-quarter: map-get($spacers, 2); // Boosted mod
$input-height: 2.5rem;
$input-height-sm: 1.875rem;
$input-height-lg: 3.125rem;
$input-line-height-lg: $h5-line-height; // Boosted mod
$input-transition: border-color $transition-duration $transition-timing, $transition-focus;
$form-color-width: 3rem;
$form-label-*
and $form-text-*
are for our <label>
s and .form-text
component.
$form-label-margin-bottom: .375rem;
$form-label-font-size: null;
$form-label-font-style: null;
$form-label-font-weight: $font-weight-bold;
$form-label-color: null;
$form-label-disabled-color: $gray-500; // Boosted mod
$form-label-required-margin-left: .1875rem; // Boosted mod
$form-text-margin-top: .25rem;
$form-text-font-size: null;
$form-text-font-style: null;
$form-text-font-weight: null;
$form-text-color: null;
$form-file-*
are for file input.
$form-file-button-color: $input-color;
$form-file-button-bg: $white;
$form-file-button-hover-bg: shade-color($form-file-button-bg, 5%);