Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/skratchdot/react-bootstrap-multiselect
A multiselect component for react (with bootstrap). This is a react port of bootstrap-multiselect.
https://github.com/skratchdot/react-bootstrap-multiselect
Last synced: 5 days ago
JSON representation
A multiselect component for react (with bootstrap). This is a react port of bootstrap-multiselect.
- Host: GitHub
- URL: https://github.com/skratchdot/react-bootstrap-multiselect
- Owner: skratchdot
- License: other
- Created: 2014-07-22T20:52:56.000Z (over 10 years ago)
- Default Branch: master
- Last Pushed: 2018-03-08T01:59:00.000Z (almost 7 years ago)
- Last Synced: 2025-01-04T21:39:51.173Z (13 days ago)
- Language: JavaScript
- Homepage: http://projects.skratchdot.com/react-bootstrap-multiselect/
- Size: 13.1 MB
- Stars: 119
- Watchers: 7
- Forks: 61
- Open Issues: 38
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE.md
Awesome Lists containing this project
README
# react-bootstrap-multiselect
[](http://badge.fury.io/js/react-bootstrap-multiselect)
[](https://david-dm.org/skratchdot/react-bootstrap-multiselect)
[](https://david-dm.org/skratchdot/react-bootstrap-multiselect#info=devDependencies)
## Description
A multiselect component for react (with bootstrap). This is a react wrapper
around an existing jQuery/bootstrap library (it is not a pure react port):
[bootstrap-multiselect](https://github.com/davidstutz/bootstrap-multiselect)
## Getting Started
1) Install the module with: `npm install --save react-bootstrap-multiselect`
2) Create your module (you need to use something like browserify to build)
```javascript
var React = require('react');
var Multiselect = require('react-bootstrap-multiselect');
var someReactComponent = React.createClass({
render: function () {
return (
);
}
});
```
3) Include the multi-select CSS in your project somewhere. The CSS file is here:
[bootstrap-multiselect.css](https://raw.githubusercontent.com/davidstutz/bootstrap-multiselect/master/dist/css/bootstrap-multiselect.css)
(don't hotlink- download and host your own copy)
```html
```
## Supported React Versions
- React 13 users should use [react-bootstrap-multiselect v0.6.0](https://github.com/skratchdot/react-bootstrap-multiselect/tree/v0.6.0)
- React 14 users should use [react-bootstrap-multiselect v1.0.2](https://github.com/skratchdot/react-bootstrap-multiselect/tree/v1.0.2)
- React 15 users should use [react-bootstrap-multiselect v2.x.x](https://github.com/skratchdot/react-bootstrap-multiselect/)
## Note on data synchronization
In case `this.state.myData` changes from outside of multiselect component, values and checkbox state will not update automatically. If you want to sync state, you have to call `.syncData()` on multiselect like in example below.
```javascript
var React = require('react');
var Multiselect = require('react-bootstrap-multiselect');
var someReactComponent = React.createClass({
getInitialState: function(){
var that = this;
$("element").on("event", function(){
$.get("new-data-from-url", function(newData){
that.setState(newData);
// to sync manually do
that.refs.myRef.syncData();
});
});
return {
myData : [{value:'One',selected:true},{value:'Two'}]
};
},
render: function () {
return (
);
}
});
```
## Documentation
For in depth documentation, see the original
[bootstrap-multiselect](https://github.com/davidstutz/bootstrap-multiselect) project page.
## Links
- [Source Code](https://github.com/skratchdot/react-bootstrap-multiselect)
- [Changelog](https://github.com/skratchdot/react-bootstrap-multiselect/blob/master/CHANGELOG.md)
- [Live Demo](http://projects.skratchdot.com/react-bootstrap-multiselect/)
- [Original Plugin](https://github.com/davidstutz/bootstrap-multiselect)
## Similar React Components
- [react-select](https://jedwatson.github.io/react-select/)
- [react-selectize](https://www.npmjs.com/package/react-selectize)
## License
Copyright (c) 2014 skratchdot
Uses the original [bootstrap-multiselect](https://github.com/davidstutz/bootstrap-multiselect) license.