jQuery Multiselect Plugin for Bootstrap - bootstrap-multiselect

Project:	bootstrap-multiselect
Author:	davidstutz
Fork:	Fork on GitHub
License:	MIT

Live Preview

Download (2 MB)

Bootstrap Multiselect

Bootstrap Multiselect is a jQuery-based plugin to provides an intuitive user interface for using select inputs with multiple attributes present. Instead of a select a bootstrap button will be shown a dropdown menu containing the single options as checkboxes.

Documentation, Examples, FAQ and License: https://davidstutz.github.io/bootstrap-multiselect/.

If you are interested in actively maintaining this project, please contact me (see GitHub profile for contact information).

Bootstrap Multiselect is featured in an article on tutorialzine: 50 must-have Plugins for Extending Twitter Bootstrap; on Bootsnipp‘s list of Twitter Bootstrap resources; on Design Your Way; and available on NuGet.

If you use this plugin commercially, consider supporting the development by making a donation.

Also, check out Bootstrap Strength Meter – a Twitter Bootstrap plugin to visualize password strength using Password Score.

License

Apache License, Version 2.0

Licensed under the Apache License, Version 2.0 (the “License”); you may not use this file except in compliance with the License. You may obtain a copy of the License at https://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an “AS IS” BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

BSD 3-Clause License

Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:

Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
Neither the name of David Stutz nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS “AS IS” AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

.gitignore
LICENSE.md
README.md
bower.json
dist
docs
example.png
index.html
package.json
post.php
require.html
tests
types

Changelog

Version: v1.1.2
Release Date: 2022-09-02T11:35:14Z
Changes:
# Features
- Added definition file for TypeScript
- Reworked option groups (#1210, #1218)

# Fixes
- Fixed timing problems during initialization
- #1214: Fixed empty labels using the dataprovider
- #1197: Multiple options with the same value were not handled correctly
Version: v1.1.1
Release Date: 2021-08-06T19:44:30Z
Changes:
# Features

* Reset button option (see #535)
* onSelectAll and onDeselectAll get changed options as argument (see #415)
* Document #515, #436 and #396

# Fixes

* Keyboard support #355
* Fixed Bower and NPM specs, specifically regarding Bootstrap version and meta information

# Misc

* Removed old, obsolete TS interface
* Removed Yarn support
* Removed obsolete Travis config
Version: v1.1.0
Release Date: 2021-07-30T11:33:10Z
Changes:
# Features
* Redesign of filter and active items
* Added new option "widthSynchronizationMode"
* Added new option "buttonTextAlignment"

# Resolved Bugs
* #1153: disabledText was displayed when list contains items but none are selected
* #1160: Fixed selection of option when pressing enter on an input text field
* #1167: Fixed select all behavior for collapsed option groups
* #1175: Improved "enableHTML" for options
* #1183: Fixed tabbing issue
* Fixed deselection of selected item in single-selection mode
* Fixed style of select when used in input groups
Version: v1.0.0
Release Date: 2020-11-17T20:29:28Z
Changes:
Bootstrap 4 support.

**Note that this release might be incompatible with Bootstrap 3 or older.** Also note that this was originally release/tag v0.9.16. To indicate the change from Bootstrap 3 to Bootstrap 4, I decided to directly go to v1.0.0. So the stable release for Boostrap 3 is v0.9.15.
Version: v0.9.15
Release Date: 2018-03-04T00:11:55Z
Changes:
**Updating from v0.9.13 is recommended.** Note that v0.9.14 is a left-over tag where continuous integration is not working. Please refer to the [updated documentation](http://davidstutz.de/bootstrap-multiselect/) for changes or check the [commits](https://github.com/davidstutz/bootstrap-multiselect/commits/master) or [pull requests](https://github.com/davidstutz/bootstrap-multiselect/pulls?q=is%3Apr+is%3Aclosed).
Version: v0.9.13
Release Date: 2015-05-26T18:37:06Z
Changes:
**Due to a XSS vulnerability, an update to v0.9.13 is highly recommended!**

Changes:
- Merged: #539, #497, #502, #521.
- New option delimiterText (#531, #539).
- Support for data-placeholder.
- #526: Fixed default buttonTitle option.
- XSS vulnerability fixed with new release (#524).
- Support for collapsible optgroups (#521).
- FAQ: #532, #519.
- Examples: #529, #541.
Version: v0.9.12
Release Date: 2015-03-18T00:44:37Z
Changes:
Release v0.9.12 removes require.js support to get Bootstrap Multiselect working without knockout.js.

**It is highly recommended to upgrade from v.0.9.11 when using require.js!**

Changes:
- Removed require.js support (#).
- Added example for #484.
- Fixed #494.
Version: v0.9.11
Release Date: 2015-03-01T00:18:29Z
Changes:
Release v0.9.11 includes a bunch of fixes, new options and improvements:

**Note: Due to a mistake, this release has knockout.js as dependency when used with require.js! The use of the next release is highly recommended.**
- **Support for Bootstrap 3.3.2!**
- Require.js support (#463).
- Improved Knockout Binding (#447).
- Shift and click range selections (#439).
- New options: `onSelectAll`, `selectAllNumber`, `inheritClasses` ...
- FAQ: #455, #426, #475.
- Fixed/Merged: #469, #422, #485, #429, #434, #430, #437,#453, #432, #425, #444, #427, #447, #439.
- New examples!
Version: v0.9.10
Release Date: 2014-11-01T21:21:30Z
Changes:
Release **v0.9.10** includes tests based on the Jasmine framework, **overhauled documentation** with **62+ examples**, fixes several bugs and introduces new configuration options:
- `justVisible` option for the `selectAll` method (#380).
- Fixed: #377, #400, #384, #375, #383, #301, #386, #404, #405, #412.
- New `enableClickableOptGroups` option (#388, #302, #305).
- Clear button for filter (#374).
- Filtering: optgroup integration (#395).
- `dataprovider` method supports preselected options, optgroups and titles (#401).
- Options via data attributes (#397).
- Extended templates: #389.
- Handling POST data: #376, #378.
Version: v0.9.9
Release Date: 2014-08-19T21:52:51Z
Changes:
- Fixed #362 and #361.
- NuGet package will be available, see README.
Version: v0.9.8
Release Date: 2014-08-07T18:02:27Z
Changes:
This release includes the following changes:
- Fixed #351.
- Added new option `disableIfEmpty`, #358.
- Added example for #129, #360.
- Updated documentation according to #356.
Version: v0.9.7
Release Date: 2014-08-02T16:28:32Z
Changes:
Changes include:
- #312 which is fixed by #326
- Documentation has been updated according to #129.
- New features/options: #326 and #283.
Version: v0.9.6
Release Date: 2014-07-14T22:44:22Z
Changes:
Some minor fixes:
- Pull request #346 fixes #322 and #324.
- Pull request #341 fixes #340.
- Pull request #345 fixes knockout binding.
- Added discussion of #347 to FAQ.
Version: v0.9.5
Release Date: 2014-07-04T20:11:12Z
Changes:
Some minor changes, including:
- Added issues to the FAQ section: #331, #336, #330, #322, #317, #323, #205.
- Additional documentaiton for `filterBehavior` option: #243.
- Merged pull requests: #281, #318, #319.
- Fixed: #301, #309.
Version: v0.9.4
Release Date: 2014-04-01T18:30:32Z
Changes:
- New option to override the templates used by the plugin (e.g. the divider template).
- Added option to change the name of the used checkboxes: `checkboxName` - see #212.
- New option to add select all only if more than x options are present: `includeSelectAllIfMoreThan` - #235.
- Select all performance improvement by @Tyf0x (for further discussion see #268 and #279).
- Fixed: #267, #278, #274, #256, #263.
- Updated documentation according to #270.
- Added example for testing select all performance.
- Added example for testing `onDropdownShow` and `onDropdownHide` as discussed in #262.
Version: v0.9.3
Release Date: 2014-03-11T20:38:43Z
Changes:
- Master branch working for both Twitter Bootstrap 3.x and the old 2.3.x branch.
- Update to Twitter Bootstrap 3.1.1.
- New option: `includeSelectAllDivider` to add a divider behind the "Select All" option.
- Update to jQuery 2.1.0.
- Full Knockout support - thanks to @BrewDawg.
- Minor fixes and improvements.
Version: v0.9.2
Release Date: 2014-01-09T01:06:12Z
Changes:
- Select all option responds to user selections and initial state.
- Updated to Bootstrap 3.0.3.
- Dividers can be added.
- Added bower.json.
- Additional examples and demos.
- Many small fixes and improvements.

**Thanks for a great community supporting this plugin!**
Version: v0.9.1
Release Date: 2013-10-05T22:44:14Z
Changes:
Multiselect for Bootstrap 3.
Version: v0.9
Release Date: 2013-07-06T18:26:05Z
Changes: