https://github.com/fdefelici/react-bootstrap-combobox

ComboBox Component for React based on Bootstrap
https://github.com/fdefelici/react-bootstrap-combobox

bootstrap combo combobox dropdown multi-select react select

Last synced: 12 days ago
JSON representation

ComboBox Component for React based on Bootstrap

• Host: GitHub
• URL: https://github.com/fdefelici/react-bootstrap-combobox
• Owner: fdefelici
• License: mit
• Created: 2019-08-30T12:49:11.000Z (about 5 years ago)
• Default Branch: master
• Last Pushed: 2022-12-11T05:33:02.000Z (almost 2 years ago)
• Last Synced: 2024-10-11T12:46:06.049Z (about 1 month ago)
• Topics: bootstrap, combo, combobox, dropdown, multi-select, react, select
• Language: JavaScript
• Homepage:
• Size: 1.69 MB
• Stars: 4
• Watchers: 5
• Forks: 5
• Open Issues: 24
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE
  • Code of conduct: CODE_OF_CONDUCT.md

Awesome Lists containing this project

README

        
# react-bootstrap-combobox · [![NPM version](https://img.shields.io/badge/npm-v1.13.0-blue)](https://www.npmjs.com/package/@fdefelici/react-bootstrap-combobox) [![Build Status](https://travis-ci.org/fdefelici/react-bootstrap-combobox.svg?branch=v1.13.0)](https://travis-ci.org/fdefelici/react-bootstrap-combobox) [![codecov](https://codecov.io/gh/fdefelici/react-bootstrap-combobox/branch/v1.13.0/graph/badge.svg)](https://codecov.io/gh/fdefelici/react-bootstrap-combobox) [![CodeSandBox](https://img.shields.io/badge/demo-live-blueviolet)](https://codesandbox.io/s/github/fdefelici/react-bootstrap-combobox/tree/v1.13.0/example?fontsize=14)

Combobox Components for React based on Bootstrap which offer the following features:



Single Selection

Multiple Selection

Selection Handling

Search through items





Scrollbar Control

Localization

Item customization

Icon customization





Search Autocompletition

Async data loading

Customizable Callbacks

Enable/Disable behaviour



This library comes with two flavour widgets: 

* **Select**: smart single/multi selection component

* **Autocomplete**: autocompletion component with single selection

Select showcase

![Select ShowCase](example/src/images/showcase_select.png)

Autocomplete showcase

![Autocomplete ShowCase](example/src/images/showcase_autocomplete.png)

# Constraints

The library is based on React and Bootstrap (only css part), so in your project you must have these dependencies. It's suggested to adopt the following versions:

* react >= 15.0.0

* bootstrap >= 3.3.0 and < 4.0.0

> Making the library compliant with Bootstrap 4.x is planned. Check-out the [milestone](https://github.com/fdefelici/react-bootstrap-combobox/milestone/11).

# Installation

Import the npm library as usual:

```shell

$ npm install @fdefelici/[email protected] --save

```

# Usage

Detailed docs, on how to use, configure and tweek the components,can be found here:

* Select widget [guide](README_Select.md).

* Autocomplete widget [guide](README_Autocomplete.md)

# Examples

For a full working example take a look at the [example project](example/) or see the widgets in action at the [live demo](https://codesandbox.io/s/github/fdefelici/react-bootstrap-combobox/tree/v1.13.0/example?fontsize=14).

# Browsers Compatibility

This component has been tested against the following browsers:

* Chrome  76+

* Firefox 68+

* Internet Explorer Edge 

# How to Contribute

If you want to contribute to the project, please follow the [guidelines](CONTRIBUTING.md).