The jQuery plugin that brings select elements into the 21st century with intuitive multiselection, searching, and much more. Now with Bootstrap 4 support.
You can view a live demo and some examples of how to use the various options here.
Bootstrap-select requires jQuery v1.9.1+, Bootstrap’s dropdown.js component, and Bootstrap's CSS. If you're not already using Bootstrap in your project, a precompiled version of the Bootstrap v3.3.7 minimum requirements can be downloaded here. If using bootstrap-select with Bootstrap v4+, you'll also need Popper.js. For all of Bootstrap v4's requirements, see Getting started. A precompiled version of the requirements will be made available in an upcoming release of bootstrap-select.
Several quick start options are available:
- Download the latest release.
- Clone the repo:
git clone https://github.com/snapappointments/bootstrap-select.git
- Install with npm:
npm install bootstrap-select
- Install with yarn:
yarn add bootstrap-select
- Install with Composer:
composer require snapappointments/bootstrap-select
- Install with NuGet:
- Install with Bower:
bower install bootstrap-select
- Install via CDN:
The CDN is updated after the release is made public, which means that there is a delay between the publishing of a release and its availability on the CDN.
Bootstrap 4 only works with bootstrap-select v1.13.0+. By default, bootstrap-select automatically detects the version of Bootstrap being used. However, there are some instances where the version detection won't work. See the documentation for more information.
selectpicker class to your select element to use the data-api.
<select class="selectpicker"> <option>Mustard</option> <option>Ketchup</option> <option>Barbecue</option> </select>
// To style only selects with the selectpicker class $('.selectpicker').selectpicker();
// To style all selects $('select').selectpicker();
$(document).ready() block or place it at the bottom of the page (after the last instance of bootstrap-select).
Check out the documentation for further information.
Bugs and feature requests
Anyone and everyone is welcome to contribute. Please take a moment to review the guidelines for contributing. Make sure you're using the latest version of bootstrap-select before submitting an issue.
Bootstrap-select's documentation, included in this repo in the root directory, is built with MkDocs and hosted at https://developer.snapappointments.com/bootstrap-select. The documentation may also be run locally.
Running documentation locally
- If necessary, install MkDocs.
- Install mkdocs-bootstrap using
pip install mkdocs-bootstrap.
- From the
mkdocs servein the command line.
http://127.0.0.1:8000/in your browser, and voilà.
Learn more about using MkDocs by reading its documentation.
Copyright and license
Copyright (C) 2012-2018 SnapAppointments, LLC
Licensed under the MIT license.