bootstrap-select/bootstrap-select

Bootstrap-select is a jQuery plugin that utilizes Bootstrap's dropdown.js to style and bring additional functionality to standard select elements.

Installs: 128 963

Dependents: 11

Suggesters: 0

Stars: 7 436

Watchers: 350

Forks: 2 238

Open Issues: 451

Language:JavaScript

1.13.0-alpha 2017-07-29 00:26 UTC

README

Latest release Bower npm NuGet CDNJS

License dependencies Status devDependencies Status

Bootstrap-select is a jQuery plugin that utilizes Bootstrap's dropdown.js to style and bring additional functionality to standard select elements.

bootstrap-select demo

HEY YOU! DO YOU WANT TO HELP?

He are looking for new maintainers on this project. If you think you can help on this, please send me an email to silviomoreto@gmail.com so we can continue improving the community plugin!

Demo and Documentation

You can view a live demo and some examples of how to use the various options here.

Bootstrap-select's documentation, included in this repo in the root directory, is built with MkDocs and publicly hosted on GitHub Pages at https://silviomoreto.github.io/bootstrap-select. The documentation may also be run locally.

Bootstrap 4 Support

This version currently does not support Bootstrap 4 officially. We are looking to keep it updated to the new Bootstrap version, do you want to help us?

Running documentation locally

  1. If necessary, install MkDocs.
  2. From the /bootstrap-select/docs directory, run mkdocs serve in the command line.
  3. Open http://127.0.0.1:8000/ in your browser, and voilà.

Learn more about using MkDocs by reading its documentation.

Authors

Silvio Moreto, Ana Carolina, caseyjhol, Matt Bryson, and t0xicCode.

Usage

Create your <select> with the .selectpicker class.

<select class="selectpicker">
  <option>Mustard</option>
  <option>Ketchup</option>
  <option>Barbecue</option>
</select>

If you use a 1.6.3 or newer, you don't need to do anything else, as the data-api automatically picks up the <select>s with the selectpicker class.

If you use an older version, you need to add the following either at the bottom of the page (after the last selectpicker), or in a $(document).ready() block.

// To style only <select>s with the selectpicker class
$('.selectpicker').selectpicker();

Or

// To style all <select>s
$('select').selectpicker();

Checkout the documentation for further information.

CDN

N.B.: 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. Check the GitHub page for the latest release.

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.

Copyright and license

Copyright (C) 2013-2015 bootstrap-select

Licensed under the MIT license.

Used by

Does your organization use bootstrap-select? Open an issue, and include a link and logo, and you'll be added to the list.