Angular Bootstrap input groups
Angular Input Groups - Bootstrap 4 & Material Design
Note: This documentation is for an older version of Bootstrap (v.4). A
newer version is available for Bootstrap 5. We recommend migrating to the latest version of our product - Material Design for
Bootstrap 5.
Go to docs v.5
Angular Bootstrap input group is a field used for collecting data entered by users. It usually contains buttons, text areas or other inputs.
Basic example
Default input groups
Default styling for Angular Bootstrap Input Group component:
<div class="input-group mb-3">
<div class="input-group-prepend">
<span class="input-group-text" id="basic-addon1">@</span>
</div>
<input type="text" class="form-control" placeholder="Username" aria-label="Username" aria-describedby="basic-addon1">
</div>
<div class="input-group mb-3">
<input type="text" class="form-control" placeholder="Recipient's username" aria-label="Recipient's username"
aria-describedby="basic-addon2">
<div class="input-group-append">
<span class="input-group-text" id="basic-addon2">@example.com</span>
</div>
</div>
<label for="basic-url">Your vanity URL</label>
<div class="input-group mb-3">
<div class="input-group-prepend">
<span class="input-group-text" id="basic-addon3">https://example.com/users/</span>
</div>
<input type="text" class="form-control" id="basic-url" aria-describedby="basic-addon3">
</div>
<div class="input-group mb-3">
<div class="input-group-prepend">
<span class="input-group-text">$</span>
</div>
<input type="text" class="form-control" aria-label="Amount (to the nearest dollar)">
<div class="input-group-append">
<span class="input-group-text">.00</span>
</div>
</div>
<div class="input-group">
<div class="input-group-prepend">
<span class="input-group-text">With textarea</span>
</div>
<textarea class="form-control" aria-label="With textarea"></textarea>
</div>
Material input groups
Material Design styling for Angular Bootstrap Input Group component:
<div class="md-form input-group mb-3">
<div class="input-group-prepend">
<span class="input-group-text md-addon" id="material-addon1">@</span>
</div>
<input type="text" class="form-control" placeholder="Username" aria-label="Username" aria-describedby="material-addon1">
</div>
<div class="md-form input-group mb-4">
<input type="text" class="form-control" placeholder="Recipient's username" aria-label="Recipient's username"
aria-describedby="material-addon2">
<div class="input-group-append">
<span class="input-group-text md-addon" id="material-addon2">@example.com</span>
</div>
</div>
<label class="mb-0 ml-2" for="material-url">Your vanity URL</label>
<div class="md-form input-group mt-0 mb-3">
<div class="input-group-prepend">
<span class="input-group-text md-addon" id="material-addon3">https://example.com/users/</span>
</div>
<input type="text" class="form-control" id="material-url" aria-describedby="material-addon3">
</div>
<div class="md-form input-group mb-3">
<div class="input-group-prepend">
<span class="input-group-text md-addon">$</span>
</div>
<input type="text" class="form-control" aria-label="Amount (to the nearest dollar)">
<div class="input-group-append">
<span class="input-group-text md-addon">.00</span>
</div>
</div>
<div class="md-form input-group">
<div class="input-group-prepend">
<span class="input-group-text md-addon">With textarea</span>
</div>
<textarea class="md-textarea form-control" aria-label="With textarea"></textarea>
</div>
Sizing
When you add the relative form sizing classes to the .input-group
itself, the contents within will
automatically resize — so no need for repeating the form control size classes on each element.
Sizing on the individual input group elements isn’t supported.
Default input group
<div class="input-group input-group-sm mb-3">
<div class="input-group-prepend">
<span class="input-group-text" id="inputGroup-sizing-sm">Small</span>
</div>
<input type="text" class="form-control" aria-label="Sizing example input" aria-describedby="inputGroup-sizing-sm">
</div>
<div class="input-group mb-3">
<div class="input-group-prepend">
<span class="input-group-text" id="inputGroup-sizing-default">Default</span>
</div>
<input type="text" class="form-control" aria-label="Sizing example input" aria-describedby="inputGroup-sizing-default">
</div>
<div class="input-group input-group-lg">
<div class="input-group-prepend">
<span class="input-group-text" id="inputGroup-sizing-lg">Large</span>
</div>
<input type="text" class="form-control" aria-label="Sizing example input" aria-describedby="inputGroup-sizing-lg">
</div>
Material input group
<div class="md-form input-group input-group-sm mb-3">
<div class="input-group-prepend">
<span class="input-group-text md-addon" id="inputGroupMaterial-sizing-sm">Small</span>
</div>
<input type="text" class="form-control" aria-label="Sizing example input" aria-describedby="inputGroupMaterial-sizing-sm">
</div>
<div class="md-form input-group mb-3">
<div class="input-group-prepend">
<span class="input-group-text md-addon" id="inputGroupMaterial-sizing-default">Default</span>
</div>
<input type="text" class="form-control" aria-label="Sizing example input" aria-describedby="inputGroupMaterial-sizing-default">
</div>
<div class="md-form input-group input-group-lg">
<div class="input-group-prepend">
<span class="input-group-text md-addon" id="inputGroupMaterial-sizing-lg">Large</span>
</div>
<input type="text" class="form-control" aria-label="Sizing example input" aria-describedby="inputGroupMaterial-sizing-lg">
</div>
Checkboxes and radios
Place any checkbox or radio option within an input group’s addon instead of text.
Default input group MDB Pro component
<div class="input-group mb-3">
<div class="input-group-prepend">
<div class="input-group-text" style="height: 38px;">
<mdb-checkbox class="mt-2"></mdb-checkbox>
</div>
</div>
<input type="text" class="form-control" aria-label="Text input with checkbox" />
</div>
<div class="input-group mb-3">
<div class="input-group-prepend">
<div class="input-group-text" style="height: 38px;">
<mdb-checkbox [filledIn]="true" class="mt-2"></mdb-checkbox>
</div>
</div>
<input type="text" class="form-control" aria-label="Text input with checkbox" />
</div>
<div class="input-group">
<div class="input-group-prepend">
<div class="input-group-text" style="height: 38px;">
<input
class="form-check-input"
type="radio"
name="exampleRadios"
id="exampleRadios1"
value="option1"
/>
<label class="form-check-label" for="exampleRadios1"></label>
</div>
</div>
<input type="text" class="form-control" aria-label="Text input with radio button" />
</div>
Material input group MDB Pro component
<div class="md-form input-group mt-0 mb-3">
<div class="input-group-prepend">
<div class="input-group-text md-addon">
<mdb-checkbox></mdb-checkbox>
<label class="form-check-label" for="materialCheckbox11"></label>
</div>
</div>
<input type="text" class="form-control" aria-label="Text input with checkbox">
</div>
<div class="md-form input-group mb-3">
<div class="input-group-prepend">
<div class="input-group-text md-addon">
<mdb-checkbox [filledIn]="true"></mdb-checkbox>
</div>
</div>
<input type="text" class="form-control" aria-label="Text input with checkbox">
</div>
<div class="md-form input-group mb-0">
<div class="input-group-prepend">
<div class="input-group-text md-addon">
<input class="form-check-input" type="radio" name="exampleRadios" id="exampleRadios111" value="option2">
<label class="form-check-label" for="exampleRadios111"></label>
</div>
</div>
<input type="text" class="form-control" aria-label="Text input with radio button">
</div>
Multiple inputs
While multiple <input>
s are supported visually, validation styles are only
available for input groups with a single <input>
.
Default input group
<div class="input-group">
<div class="input-group-prepend">
<span class="input-group-text">First and last name</span>
</div>
<input type="text" aria-label="First name" class="form-control">
<input type="text" aria-label="Last name" class="form-control">
</div>
Material input group
<div class="md-form input-group">
<div class="input-group-prepend">
<span class="input-group-text md-addon">First and last name</span>
</div>
<input type="text" aria-label="First name" class="form-control" placeholder="Type sth">
<input type="text" aria-label="Last name" class="form-control" placeholder="Type sth">
</div>
Multiple addons
Multiple add-ons are supported and can be mixed with checkbox and radio input versions.
Default input group
<div class="input-group mb-3">
<div class="input-group-prepend">
<span class="input-group-text">$</span>
<span class="input-group-text">0.00</span>
</div>
<input type="text" class="form-control" aria-label="Dollar amount (with dot and two decimal places)">
</div>
<div class="input-group">
<input type="text" class="form-control" aria-label="Dollar amount (with dot and two decimal places)">
<div class="input-group-append">
<span class="input-group-text">$</span>
<span class="input-group-text">0.00</span>
</div>
</div>
Material input group
<div class="md-form input-group mt-0 mb-3">
<div class="input-group-prepend">
<span class="input-group-text md-addon">$</span>
<span class="input-group-text md-addon">0.00</span>
</div>
<input type="text" class="form-control" aria-label="Dollar amount (with dot and two decimal places)">
</div>
<div class="md-form input-group mb-0">
<input type="text" class="form-control" aria-label="Dollar amount (with dot and two decimal places)">
<div class="input-group-append">
<span class="input-group-text md-addon">$</span>
<span class="input-group-text md-addon">0.00</span>
</div>
</div>
Buttons with dropdowns
Default input group
<div class="input-group mb-3">
<div class="input-group-prepend">
<div class="btn-group" mdbDropdown>
<button mdbDropdownToggle type="button" mdbBtn color="primary" size="md" class="dropdown-toggle z-depth-0"
mdbWavesEffect>Dropdown</button>
<div class="dropdown-menu">
<a class="dropdown-item" href="#">Action</a>
<a class="dropdown-item" href="#">Another action</a>
<a class="dropdown-item" href="#">Something else here</a>
<div class="divider dropdown-divider"></div>
<a class="dropdown-item" href="#">Separated link</a>
</div>
</div>
</div>
<input type="text" class="form-control" aria-label="Text input with dropdown button">
</div>
<div class="input-group">
<input type="text" class="form-control" aria-label="Text input with dropdown button">
<div class="input-group-append">
<div class="btn-group" mdbDropdown>
<button mdbDropdownToggle type="button" mdbBtn color="default" size="md" class="dropdown-toggle z-depth-0"
mdbWavesEffect>Dropdown</button>
<div class="dropdown-menu">
<a class="dropdown-item" href="#">Action</a>
<a class="dropdown-item" href="#">Another action</a>
<a class="dropdown-item" href="#">Something else here</a>
<div class="divider dropdown-divider"></div>
<a class="dropdown-item" href="#">Separated link</a>
</div>
</div>
</div>
</div>
Material input group MDB Pro component
<div class="md-form input-group mb-3">
<div class="input-group-prepend">
<div class="btn-group" mdbDropdown>
<button mdbDropdownToggle type="button" mdbBtn color="primary" outline="true" size="md" class="dropdown-toggle z-depth-0"
mdbWavesEffect>Dropdown</button>
<div class="dropdown-menu">
<a class="dropdown-item" href="#">Action</a>
<a class="dropdown-item" href="#">Another action</a>
<a class="dropdown-item" href="#">Something else here</a>
<div class="divider dropdown-divider"></div>
<a class="dropdown-item" href="#">Separated link</a>
</div>
</div>
</div>
<input type="text" class="form-control" aria-label="Text input with dropdown button">
</div>
<div class="md-form input-group">
<input type="text" class="form-control" aria-label="Text input with dropdown button">
<div class="input-group-append">
<div class="btn-group" mdbDropdown>
<button mdbDropdownToggle type="button" mdbBtn color="default" outline="true" size="md" class="dropdown-toggle z-depth-0"
mdbWavesEffect>Dropdown</button>
<div class="dropdown-menu">
<a class="dropdown-item" href="#">Action</a>
<a class="dropdown-item" href="#">Another action</a>
<a class="dropdown-item" href="#">Something else here</a>
<div class="divider dropdown-divider"></div>
<a class="dropdown-item" href="#">Separated link</a>
</div>
</div>
</div>
</div>
Accessibility
Screen readers will have trouble with your forms if you don’t include a label for every input. For these input groups, ensure that any additional label or functionality is conveyed to assistive technologies.
The exact technique to be used (<label>
elements hidden using the .sr-only
class,
or use of the aria-label
and aria-labelledby
attributes, possibly in combination with
aria-describedby
) and what additional information will need to be conveyed will vary depending on the
exact type of interface widget you’re implementing. The examples in this section provide a few suggested,
case-specific approaches.
Angular Input Group - API
In this section you will find informations about required modules and available inputs, outputs, methods and events of input group component.
Modules used
In order to speed up your application, you can choose to import only the modules you actually need, instead of importing the entire MDB Angular library. Remember that importing the entire library, and immediately afterwards a specific module, is bad practice, and can cause application errors.
API Reference for MDB Angular Input Groups:
// MDB Angular Pro
import { InputsModule, WavesModule, ButtonsModule } from 'ng-uikit-pro-standard'
// MDB Angular Free
import { InputsModule, WavesModule, ButtonsModule } from 'angular-bootstrap-md'
Angular Input Group - examples & customization
Colorful input groups
<div class="input-group md-form form-sm form-3 pl-0">
<div class="input-group-prepend">
<span class="input-group-text amber lighten-3 black-text" id="basic-addon9">@</span>
</div>
<input type="text" class="form-control mt-0 amber-border" placeholder="Username" aria-describedby="basic-addon9">
</div>
<div class="input-group md-form form-sm form-4 pl-0">
<div class="input-group-prepend">
<span class="input-group-text lime lighten-2 black-text">$</span>
</div>
<input type="text" class="form-control mt-0 lime-border" aria-label="Amount (to the nearest dollar)">
<div class="input-group-append">
<span class="input-group-text lime lighten-2 black-text">.00</span>
</div>
</div>
<div class="input-group md-form form-sm form-3 pl-0">
<div class="input-group-prepend">
<span class="input-group-text red lighten-3 black-text">$</span>
<span class="input-group-text red lighten-3 black-text">0.00</span>
</div>
<input type="text" class="form-control mt-0 red-border" aria-label="Amount (to the nearest dollar)">
</div>
<div class="input-group md-form form-sm form-5 pl-0">
<input type="text" class="form-control mt-0 purple-border" placeholder="Recipient's username"
aria-describedby="basic-addon12">
<div class="input-group-append">
<span class="input-group-text purple lighten-3 black-text" id="basic-addon12">@example.com</span>
</div>
</div>
<label for="basic-url">Your vanity URL</label>
<div class="input-group md-form form-sm form-3 pl-0">
<div class="input-group-prepend">
<span class="input-group-text blue lighten-3 black-text" id="basic-addon33">https://example.com/users/</span>
</div>
<input type="text" class="form-control mt-0 blue-border" id="basic-url" aria-describedby="basic-addon33">
</div>
.input-group.md-form.form-sm.form-4 input {
border: 1px solid #bdbdbd;
}
.input-group.md-form.form-sm.form-4 input[type=text]:focus:not([readonly]).lime-border {
border: 1px solid #cddc39;
box-shadow: none;
}
.input-group.md-form.form-sm.form-3 input {
border: 1px solid #bdbdbd;
border-top-right-radius: 0.25rem;
border-bottom-right-radius: 0.25rem;
}
.input-group.md-form.form-sm.form-3 input[type=text]:focus:not([readonly]).red-border {
border: 1px solid #ef9a9a;
box-shadow: none;
}
.input-group.md-form.form-sm.form-3 input[type=text]:focus:not([readonly]).amber-border {
border: 1px solid #ffca28;
box-shadow: none;
}
.input-group.md-form.form-sm.form-3 input[type=text]:focus:not([readonly]).blue-border {
border: 1px solid #64b5f6;
box-shadow: none;
}
.input-group.md-form.form-sm.form-5 input {
border: 1px solid #bdbdbd;
border-top-left-radius: 0.25rem;
border-bottom-left-radius: 0.25rem;
}
.input-group.md-form.form-sm.form-5 input[type=text]:focus:not([readonly]).purple-border {
border: 1px solid #ce93d8;
box-shadow: none;
}