Select
Bootstrap Select
Bootstrap Material Select is a form control that, after a click displays a collapsable list of multiple values which can be used in forms, menus or surveys.
MDB provides you a variety of options and variations.
Default select
Custom select menus need only a custom class, .custom-select to trigger the
custom
styles. Custom styles are limited to the select’s initial appearance and cannot modify the
option's
due to
browser limitations.
<select class="browser-default custom-select">
<option selected>Open this select menu</option>
<option value="1">One</option>
<option value="2">Two</option>
<option value="3">Three</option>
</select>
Material select MDB Pro component
Material Select
requires an initialization. You have to add the
.materialSelect() js code to the
select element.
<select class="mdb-select md-form">
<option value="" disabled selected>Choose your option</option>
<option value="1">Option 1</option>
<option value="2">Option 2</option>
<option value="3">Option 3</option>
</select>
// Material Select Initialization
$(document).ready(function() {
$('.mdb-select').materialSelect();
});
You may also choose from small and large custom selects to match our similarly sized text inputs.
<select class="browser-default custom-select custom-select-lg mb-3">
<option selected>Open this select menu</option>
<option value="1">One</option>
<option value="2">Two</option>
<option value="3">Three</option>
</select>
<select class="custom-select custom-select-sm">
<option selected>Open this select menu</option>
<option value="1">One</option>
<option value="2">Two</option>
<option value="3">Three</option>
</select>
The multiple attribute is also supported:
<select class="custom-select" multiple>
<option selected>Open this select menu</option>
<option value="1">One</option>
<option value="2">Two</option>
<option value="3">Three</option>
</select>
As is the size attribute:
<select class="custom-select" size="3">
<option selected>Open this select menu</option>
<option value="1">One</option>
<option value="2">Two</option>
<option value="3">Three</option>
</select>
Overwriting a standard select
MDB overwrites a standard select to replace it with our Material Select. That's why before you can use it, you have to initialize Material Select by placing the following code in your project.
In addition, you will need a separate call for any dynamically generated select elements your page generates.
Initialization:
// Material Select Initialization
$(document).ready(function() {
$('.mdb-select').materialSelect();
});
Color variations MDB Pro component
<!--Blue select-->
<select class="mdb-select md-form colorful-select dropdown-primary">
<option value="1">Option 1</option>
<option value="2">Option 2</option>
<option value="3">Option 3</option>
<option value="4">Option 4</option>
<option value="5">Option 5</option>
</select>
<label class="mdb-main-label">Blue select</label>
<!--/Blue select-->
// Material Select Initialization
$(document).ready(function() {
$('.mdb-select').materialSelect();
});
In order to change a select color use one of the following classes:
1.
.dropdown-primary
2.
.dropdown-danger
3.
.dropdown-default
4.
.dropdown-secondary
5.
.dropdown-success
6.
.dropdown-info
7.
.dropdown-warning
8.
.dropdown-ins
9.
.dropdown-dark
Select with a search box MDB Pro component
<select class="mdb-select md-form" searchable="Search here..">
<option value="" disabled selected>Choose your country</option>
<option value="1">USA</option>
<option value="2">Germany</option>
<option value="3">France</option>
<option value="3">Poland</option>
<option value="3">Japan</option>
</select>
// Material Select Initialization
$(document).ready(function() {
$('.mdb-select').materialSelect();
});
Select with a label and search box MDB Pro component
<select class="mdb-select md-form" searchable="Search here..">
<option value="" disabled selected>Choose your country</option>
<option value="1">USA</option>
<option value="2">Germany</option>
<option value="3">France</option>
<option value="3">Poland</option>
<option value="3">Japan</option>
</select>
<label class="mdb-main-label">Label example</label>
// Material Select Initialization
$(document).ready(function() {
$('.mdb-select').materialSelect();
});
Select with a secondary text MDB Pro component
<select class="mdb-select md-form" searchable="Search here..">
<option value="" disabled selected>Choose your car</option>
<option value="2" data-secondary-text="Production year: 2012">Volkswagen Passat</option>
<option value="3" data-secondary-text="Production year: 2017">Subaru Legacy</option>
<option value="3" data-secondary-text="Production year: 2015">Hyundai Elantra</option>
<option value="3" data-secondary-text="Production year: 2019">Honda Civic</option>
<option value="3" data-secondary-text="Production year: 2016">Audi A6</option>
</select>
// Material Select Initialization
$(document).ready(function() {
$('.mdb-select').materialSelect();
});
Multiple select MDB Pro component
<select class="mdb-select md-form" multiple>
<option value="" disabled selected>Choose your option</option>
<option value="1">Option 1</option>
<option value="2">Option 2</option>
<option value="3">Option 3</option>
</select>
<label class="mdb-main-label">Example label</label>
<button class="btn-save btn btn-primary btn-sm">Save</button>
// Material Select Initialization
$(document).ready(function() {
$('.mdb-select').materialSelect();
});
Multiselect variations
More multiselect examples and variations can be found in the Multiselect documentation
Options groups MDB Pro component
<select class="mdb-select md-form">
<optgroup label="team 1">
<option value="1">Option 1</option>
<option value="2">Option 2</option>
</optgroup>
<optgroup label="team 2">
<option value="3">Option 3</option>
<option value="4">Option 4</option>
</optgroup>
</select>
<label class="mdb-main-label">Example label</label>
// Material Select Initialization
$(document).ready(function() {
$('.mdb-select').materialSelect();
});
Select with icons MDB Pro component
<select class="mdb-select md-form">
<option value="" disabled selected>Choose your option</option>
<option value="" data-icon="https://mdbootstrap.com/img/Photos/Avatars/avatar-1.jpg" class="rounded-circle">
example
1</option>
<option value="" data-icon="https://mdbootstrap.com/img/Photos/Avatars/avatar-2.jpg" class="rounded-circle">
example
2</option>
<option value="" data-icon="https://mdbootstrap.com/img/Photos/Avatars/avatar-3.jpg" class="rounded-circle">
example
1</option>
</select>
<label class="mdb-main-label">Example label</label>
// Material Select Initialization
$(document).ready(function() {
$('.mdb-select').materialSelect();
});
Disabled select MDB Pro component
By adding a disabled attribute to the select (or a particular option), you can make it unselectable.
<!-- Disabled select-->
<select class="mdb-select md-form" disabled>
<option value="" disabled selected>Choose your option</option>
<option value="1">Option 1</option>
<option value="2">Option 2</option>
<option value="3">Option 3</option>
</select>
<label class="disabled mdb-main-label">Example label</label>
<!--Disabled option-->
<select class="mdb-select md-form">
<option value="" disabled selected>Choose your option</option>
<option value="1" disabled>Disabled option</option>
<option value="2">Option 2</option>
<option value="3">Option 3</option>
</select>
<label class="mdb-main-label">Example label</label>
// Material Select Initialization
$(document).ready(function() {
$('.mdb-select').materialSelect();
});
Outline select MDB Pro component
Note warning: For now, an outline styling works correct only for Material Select (not Multiselect) with primary dropdown menu and with skins colors.
<div class="row">
<div class="col-md-6 select-outline">
<select class="mdb-select md-form md-outline colorful-select dropdown-primary">
<option value="" disabled selected>Choose your option</option>
<option value="1">Option 1</option>
<option value="2">Option 2</option>
<option value="3">Option 3</option>
</select>
<label>Example label</label>
</div>
</div>
.md-outline.select-wrapper+label {
top: .5em !important;
z-index: 2 !important;
}
// Material Select Initialization
$(document).ready(function() {
$('.mdb-select').materialSelect();
$('.select-wrapper.md-form.md-outline input.select-dropdown').bind('focus blur', function () {
$(this).closest('.select-outline').find('label').toggleClass('active');
$(this).closest('.select-outline').find('.caret').toggleClass('active');
});
});
Updating/destroying Material Select MDB Pro component
To update the items inside the existing Material Select you can destroy it with the function below and then initialize it again.
// Material Select Destroy
$('.mdb-select').materialSelect({
destroy: true
});
Adding new options MDB Pro component
By adding an editable="true" attribute to the select, you can easily extend the options list.
<select class="mdb-select md-form" editable="true" searchable="Search and add here...">
<option value="" disabled selected>Choose your option</option>
<option value="1">Option 1</option>
<option value="2">Option 2</option>
<option value="3">Option 3</option>
</select>
<label class="mdb-main-label">Example label</label>
$(document).ready(function() {
// Material Select
$('.mdb-select').materialSelect({
});
})
Validation MDB Pro component
<form class="needs-validation" novalidate>
<select class="mdb-select validate md-form" searchable="Search here..">
<option value="" disabled selected>Choose your country</option>
<option value="1">USA</option>
<option value="2">Germany</option>
<option value="3">France</option>
<option value="4">Poland</option>
<option value="5">Japan</option>
</select>
<button class="btn btn-default btn-sm">Submit</button>
</form>
$(document).ready(function() {
$('.mdb-select.validate').materialSelect({
validate: true,
labels: {
validFeedback: 'Correct choice',
invalidFeedback: 'Wrong choice'
}
});
function validateSelect(e) {
e.preventDefault();
$('.needs-validation').addClass('was-validated');
if ($('.needs-validation select').val() === null) {
$('.needs-validation').find('.valid-feedback').hide();
$('.needs-validation').find('.invalid-feedback').show();
$('.needs-validation').find('.select-dropdown').val('').prop('placeholder', 'No countries selected')
} else {
$('.needs-validation').find('.valid-feedback').show();
$('.needs-validation').find('.invalid-feedback').hide();
}
}
$('.needs-validation select').on('change', e => validateSelect(e))
$('.needs-validation').on('submit', e => validateSelect(e))
});
Select options and attributes MDB Pro component
There is a plenty of options to customize the Material Select. All of them are described below.
Important thing to note is that data attributes have higher priority than JS options passed to the .materialSelect() call.
It means that if you will have data-placeholder="Please select a country" and JS option { placeholder: 'Choose country' }, then the value of data-placeholder will be displayed as it has higher priority.
The exception is the id attribute which has higher priority than data-select-id as described below.
| Data attribute | Option name | Type | Default | Description |
|---|---|---|---|---|
| - | destroy | boolean | false | If set to true destroys the Material Select wrapper |
| data-secondary-text | secondaryText | string | false | Additional text displayed inside an option |
| data-validate | validate | boolean | false | If set to true the select control will be validated when put into form element |
| data-select-id | selectId | string | null | If provided, this ID will be used instead of a random UUID to make Material Select elements unique. Note: if id attribute is provided, it has the highest priority |
| data-default-material-input | defaultMaterialInput | boolean | false | If set to true the select control will look like default Bootstrap select |
| data-fas-classes | fasClasses | string | empty | Space-separated list of FAS classes to add on the <i> element in the options list. Note: works only if data-fas attribute is provided with chosen FAS class value |
| data-far-classes | farClasses | string | empty | Space-separated list of FAR classes to add on the <i> element in the options list. Note: works only if data-far attribute is provided with chosen FAR class value |
| data-fab-classes | fabClasses | string | empty | Space-separated list of FAB classes to add on the <i> element in the options list. Note: works only if data-fab attribute is provided with chosen FAB class value |
| data-copy-classes-option | copyClassesOption | boolean | false | If set to true all classes added to the native <select> control will be copied to each option in the Material Select dropdown |
| data-label-select-all | labels.selectAll | string | Select all | The text which is displayed as option which selects all other options in the Multiselect |
| data-label-options-selected | labels.optionsSelected | string | options selected | The text which is displayed on the Multiselect when there are more than 5 (default) options selected, e.g. 7 options selected |
| data-label-valid-feedback | labels.validFeedback | string | Ok | The text which is displayed below the Material Select when the validate option is enabled and the select is valid |
| data-label-invalid-feedback | labels.invalidFeedback | string | Incorrect value | The text which is displayed below the Material Select when the validate option is enabled and the select is invalid |
| data-label-no-search-results | labels.noSearchResults | string | No results | The text which is displayed in the Searchable Select when there are no results |
| data-label-keyboard-active-class | keyboardActiveClass | string | heavy-rain-gradient | The class which is added to the options selected by the arrow keys (using keyboard) |
| data-placeholder | placeholder | string | null | The placeholder text which is displayed on the select if no value selected yet |
| data-visible-options | visibleOptions | number | 5 | The maximum number of options which are visible in the Material Select dropdown without scrolling. If set to -1, the limit is off |
| data-max-selected-options | maxSelectedOptions | number | 5 | The maximum number of comma-separated list of options displayed on the Multiselect. If a user selects more options than that value, the X options selected text will be displayed instead. If set to -1, the limit is off |
Getting started: download & setup
Download
All of the components and features are a part of the MDBootstrap package.
MDBootstrap (Material Design for Bootstrap) is an MIT Licensed framework - free for personal & commercial use.
It combines the esthetic of Material Design and the functionalities of the newest Bootstrap.
Click on the button below to visit the Getting Started Page, where you can download the latest MDBootstrap package.
MDBootstrap Download MDBootstrap AboutMDB Pro
Using components and features labeled as MDB Pro component requires the MDB Pro package - a powerful UI Kit containing over 5,000 components, dozens of plugins and much more cool features.
Click the button below to learn more about the MDBootstrap Pro package.
MDBootstrap ProTutorials
If you need any additional help, use our "5 min Quick Start" guide or start full Bootstrap tutorial.
5 min Quick Start Full Bootstrap TutorialCompilation & Customization
To reduce the weight of MDBootstrap package even more, you can compile your own, custom package containing only those components and features that you need.
If you need additional help with compiling your custom package, please use our Compilation & Customization tutorial.
Compilation & Customization tutorialMap of dependencies of SCSS files in MDBootstrap:
Legend:
'-->' means 'required'
All free and pro files require files from 'core' catalog
'none' means 'this component doesn't require anything except core files'
A file wrapped by `< >` means that this file make the base component prettier but it isn't necessary for the proper working
All PRO components require 'pro/_variables.scss' file
scss/
|
|-- core/
| |
| |-- bootstrap/
| | |-- _functions.scss
| | |-- _variables.scss
| |
| |-- _colors.scss
| |-- _global.scss
| |-- _helpers.scss
| |-- _masks.scss
| |-- _mixins.scss
| |-- _typography.scss
| |-- _variables.scss
| |-- _waves.scss
|
|-- free/
| |-- _animations-basic.scss --> none
| |-- _animations-extended.scss --> _animations-basic.scss
| |-- _buttons.scss --> none
| |-- _cards.scss --> none <_buttons.scss>
| |-- _dropdowns.scss --> none <_buttons.scss>
| |-- _input-group.scss --> _forms.scss, _buttons.scss, _dropdowns.scss
| |-- _navbars.scss --> none <_buttons.scss, _forms.scss, _input-group.scss>
| |-- _pagination.scss --> none
| |-- _badges.scss --> none
| |-- _modals.scss --> _buttons.scss, _forms.scss (PRO --> _tabs.scss)
| |-- _carousels.scss --> <_buttons.scss>
| |-- _forms.scss --> none
| |-- _msc.scss --> none <_buttons.scss, _forms.scss, _cards.scss>
| |-- _footers.scss none <_buttons.scss> (PRO: )
| |-- _list-group.scss --> none
| |-- _tables.scss --> none (PRO: _material-select.scss, pro/_forms.scss, _checkbox.scss, pro/_buttons.scss, pro/_cards.scss, _pagination.scss, pro/_msc.scss)
| |-- _depreciated.scss
|
|-- pro/
| |
| |-- picker/
| | |-- _default.scss --> none
| | |-- _default-time.scss --> _default.scss, free/_forms.scss, free/_buttons.scss, pro/_buttons.scss, free/_cards.scss
| | |-- _default-date.scss --> _default.scss, free/_forms.scss
| |
| |-- sections/
| | |-- _templates.scss --> _sidenav.scss
| | |-- _social.scss --> free/_cards.scss, free/ _forms.scss, free/_buttons.scss, pro/_buttons.scss,
| | |-- _team.scss --> free/_buttons.scss, pro/_buttons.scss, free/_cards.scss, pro/_cards.scss
| | |-- _testimonials.scss --> free/_carousels.scss, pro/_carousels.scss, free/_buttons.scss, pro/_buttons.scss
| | |-- _magazine.scss --> _badges.scss
| | |-- _pricing.scss --> free/_buttons.scss, pro/_buttons.scss
| | |-- _contacts.scss --> free/_forms.scss, pro/_forms.scss, free/_buttons.scss, pro/_buttons.scss
| |
| |-- _variables.scss
| |-- _buttons.scss --> free/_buttons.scss, pro/_msc.scss, _checkbox.scss, _radio.scss
| |-- _social-buttons.scss --> free/_buttons.scss, pro/_buttons.scss
| |-- _tabs.scss --> _cards.scss
| |-- _cards.scss --> free/_cards.scss <_buttons.scss, _social-buttons.scss>
| |-- _dropdowns.scss --> free/_dropdowns.scss, free/_buttons.scss
| |-- _navbars.scss --> free/_navbars.scss (PRO: )
| |-- _scrollspy.scss --> none
| |-- _lightbox.scss --> none
| |-- _chips.scss --> none
| |-- _msc.scss --> none
| |-- _forms.scss --> none
| |-- _radio.scss --> none
| |-- _checkbox.scss --> none
| |-- _material-select.scss --> none
| |-- _switch.scss --> none
| |-- _file-input.scss --> free/_forms.scss, free/_buttons.scss
| |-- _range.scss --> none
| |-- _input-group.scss --> free/_input-group.scss and the same what free input group, _checkbox.scss, _radio.scss
| |-- _autocomplete.scss --> free/_forms.scss
| |-- _accordion.scss --> pro/_animations.scss, free/_cards.scss
| |-- _parallax.scss --> none
| |-- _sidenav.scss --> free/_forms.scss, pro/_animations.scss, sections/_templates.scss
| |-- _ecommerce.scss --> free/_cards.scss, pro/_cards.scss, free/_buttons.scss, pro/_buttons.scss, pro/_msc.scss
| |-- _carousels.scss --> free/_carousels.scss, free/_cards.scss, free/_buttons.scss
| |-- _steppers.scss --> free/_buttons.scss
| |-- _blog.scss --> none
| |-- _toasts.scss --> free/_buttons.scss
| |-- _animations.scss --> none
| |-- _charts.scss --> none
| |-- _progress.scss --> none
| |-- _scrollbar.scss --> none
| |-- _skins.scss --> none
| |-- _depreciated.scss
|
`-- _custom-skin.scss
`-- _custom-styles.scss
`-- _custom-variables.scss
`-- mdb.scss
Map of dependencies of JavaScript modules in MDBootstrap:
Legend:
'-->' means 'required'
All files require jQuery and bootstrap.js
js/
├── dist/
│ ├── buttons.js
│ ├── cards.js
│ ├── character-counter.js
│ ├── chips.js
│ ├── collapsible.js --> vendor/velocity.js
│ ├── dropdown.js --> Popper.js, jquery.easing.js
│ ├── file-input.js
│ ├── forms-free.js
│ ├── material-select.js --> dropdown.js
│ ├── mdb-autocomplete.js
│ ├── preloading.js
│ ├── range-input.js --> vendor/velocity.js
│ ├── scrolling-navbar.js
│ ├── sidenav.js --> vendor/velocity.js, vendor/hammer.js, vendor/jquery.hammer.js
│ └── smooth-scroll.js
├── _intro-mdb-pro.js
├── modules.js
├── src/
│ ├── buttons.js
│ ├── cards.js
│ ├── character-counter.js
│ ├── chips.js
│ ├── collapsible.js --> vendor/velocity.js
│ ├── dropdown.js --> Popper.js, jquery.easing.js
│ ├── file-input.js
│ ├── forms-free.js
│ ├── material-select.js --> dropdown.js
│ ├── mdb-autocomplete.js
│ ├── preloading.js
│ ├── range-input.js --> vendor/velocity.js
│ ├── scrolling-navbar.js
│ ├── sidenav.js --> vendor/velocity.js, vendor/hammer.js, vendor/jquery.hammer.js
│ └── smooth-scroll.js
└── vendor/
├── addons/
│ ├── datatables.js
│ └── datatables.min.js
├── chart.js
├── enhanced-modals.js
├── hammer.js
├── jarallax.js
├── jarallax-video.js --> vendor/jarallax.js
├── jquery.easing.js
├── jquery.easypiechart.js
├── jquery.hammer.js --> vendor/hammer.js
├── jquery.sticky.js
├── lightbox.js
├── picker-date.js --> vendor/picker.js
├── picker.js
├── picker-time.js --> vendor/picker.js
├── scrollbar.js
├── scrolling-navbar.js
├── toastr.js
├── velocity.js
├── waves.js
└── wow.js
Integrations with Angular, React or Vue
Apart from the standard Bootstrap integration (using jQuery), MDBootstrap also integrates with Angular, React and Vue.
About MDB Angular About MDB React About MDB VueExclusive resources
MDBootstrap is a platform for web creators and MDB packages are only a part of it.
If you sign up you'll gain free access to other useful tools & resources including:
- Community developed components & design projects
- Technical support & community forum
- CLI interface & free project hosting
- Helpful articles & news agregators
...and much more!
Don't hesitate and sign up now!
Sign up now