99 lines
4.7 KiB
Markdown
99 lines
4.7 KiB
Markdown
|
bootstrap-select
|
||
|
|
================
|
||
|
|
|
||
|
|
[](https://github.com/silviomoreto/bootstrap-select/releases/latest)
|
||
|
|
[]()
|
||
|
|
[](https://www.npmjs.com/package/bootstrap-select)
|
||
|
|
[](https://www.nuget.org/packages/bootstrap-select/)
|
||
|
|
[](https://cdnjs.com/libraries/bootstrap-select)
|
||
|
|
|
||
|
|
[](LICENSE)
|
||
|
|
[](https://david-dm.org/silviomoreto/bootstrap-select)
|
||
|
|
[](https://david-dm.org/silviomoreto/bootstrap-select#info=devDependencies)
|
||
|
|
|
||
|
|
Bootstrap-select is a jQuery plugin that utilizes Bootstrap's dropdown.js to style and bring additional functionality to standard select elements.
|
||
|
|
|
||
|
|
<a href="http://silviomoreto.github.io/bootstrap-select/"><img src="https://cloud.githubusercontent.com/assets/2874325/18023324/42cf556c-6bb5-11e6-84ce-35be08ae57ba.gif" alt="bootstrap-select demo"></a>
|
||
|
|
|
||
|
|
## Demo and Documentation
|
||
|
|
|
||
|
|
You can view a live demo and some examples of how to use the various options [here](http://silviomoreto.github.io/bootstrap-select).
|
||
|
|
|
||
|
|
Bootstrap-select's documentation, included in this repo in the root directory, is built with MkDocs and publicly hosted on GitHub Pages at http://silviomoreto.github.io/bootstrap-select. The documentation may also be run locally.
|
||
|
|
|
||
|
|
|
||
|
|
### Running documentation locally
|
||
|
|
|
||
|
|
1. If necessary, [install MkDocs](http://www.mkdocs.org/#installation).
|
||
|
|
3. From the `/bootstrap-select/docs` directory, run `mkdocs serve` in the command line.
|
||
|
|
4. Open `http://127.0.0.1:8000/` in your browser, and voilà.
|
||
|
|
|
||
|
|
Learn more about using MkDocs by reading its [documentation](http://www.mkdocs.org/).
|
||
|
|
|
||
|
|
## Authors
|
||
|
|
|
||
|
|
[Silvio Moreto](https://github.com/silviomoreto),
|
||
|
|
[Ana Carolina](https://github.com/anacarolinats),
|
||
|
|
[caseyjhol](https://github.com/caseyjhol),
|
||
|
|
[Matt Bryson](https://github.com/mattbryson), and
|
||
|
|
[t0xicCode](https://github.com/t0xicCode).
|
||
|
|
|
||
|
|
## Usage
|
||
|
|
|
||
|
|
Create your `<select>` with the `.selectpicker` class.
|
||
|
|
```html
|
||
|
|
<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()`](http://api.jquery.com/ready/) block.
|
||
|
|
```js
|
||
|
|
// To style only <select>s with the selectpicker class
|
||
|
|
$('.selectpicker').selectpicker();
|
||
|
|
```
|
||
|
|
Or
|
||
|
|
```js
|
||
|
|
// To style all <select>s
|
||
|
|
$('select').selectpicker();
|
||
|
|
```
|
||
|
|
|
||
|
|
Checkout the [documentation](http://silviomoreto.github.io/bootstrap-select) 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](https://github.com/silviomoreto/bootstrap-select/releases) for the latest release.
|
||
|
|
|
||
|
|
* [//cdnjs.cloudflare.com/ajax/libs/bootstrap-select/1.12.2/css/bootstrap-select.min.css](//cdnjs.cloudflare.com/ajax/libs/bootstrap-select/1.12.2/css/bootstrap-select.min.css)
|
||
|
|
* [//cdnjs.cloudflare.com/ajax/libs/bootstrap-select/1.12.2/js/bootstrap-select.min.js](//cdnjs.cloudflare.com/ajax/libs/bootstrap-select/1.12.2/js/bootstrap-select.min.js)
|
||
|
|
* //cdnjs.cloudflare.com/ajax/libs/bootstrap-select/1.12.2/js/i18n/defaults-*.min.js (The translation files)
|
||
|
|
|
||
|
|
## Bugs and feature requests
|
||
|
|
|
||
|
|
Anyone and everyone is welcome to contribute. **Please take a moment to
|
||
|
|
review the [guidelines for contributing](CONTRIBUTING.md)**. Make sure you're using the latest version of bootstrap-select before submitting an issue.
|
||
|
|
|
||
|
|
* [Bug reports](CONTRIBUTING.md#bug-reports)
|
||
|
|
* [Feature requests](CONTRIBUTING.md#feature-requests)
|
||
|
|
|
||
|
|
## Copyright and license
|
||
|
|
|
||
|
|
Copyright (C) 2013-2015 bootstrap-select
|
||
|
|
|
||
|
|
Licensed under [the MIT license](LICENSE).
|
||
|
|
|
||
|
|
## Used by
|
||
|
|
|
||
|
|
* [SnapAppointments](https://snapappointments.com)
|
||
|
|
* [Thermo Fisher Scientific Inc.](https://www.thermofisher.com)
|
||
|
|
* [membermeister](https://www.membermeister.com)
|
||
|
|
* [Solve for All](https://solveforall.com)
|
||
|
|
* [EstiMATEit](http://www.123itworks.co.uk)
|
||
|
|
* [Convertizer](https://convertizer.com)
|
||
|
|
|
||
|
|
Does your organization use bootstrap-select? Open an issue, and include a link and logo, and you'll be added to the list.
|