Skip to content

dwertheimer/react-bootstrap-typeahead

 
 

Repository files navigation

React Bootstrap Typeahead

React-based typeahead component that uses Bootstrap as a base for styles and behaviors and supports both single- and multi-selection. The UI and behaviors are inspired by Twitter's typeahead.js. Try a live example.

npm version npm downloads build status cdnjs

Please note that this library is under active development and the APIs may change. The documentation below applies to the most recent version and may no longer be applicable if you're using an outdated version.

Installation

Use NPM to install the module in your project:

$ npm install --save react-bootstrap-typeahead

Include the module in your project as you normally would:

// Using ES2015 modules
import Typeahead from 'react-bootstrap-typeahead';

// Using CommonJS (Note: you must add `.default`)
var Typeahead = require('react-bootstrap-typeahead').default;

Minified and unminified UMD modules are also included in the NPM package, or you can get them from CDNJS.

v1.0.0 (beta)

A pre-release of v1.0 is now available. The code is reasonably stable, but could use some additional real-world testing. New examples and better documentation are currently the main things gating a full release. The latest stable version is v0.10.4.

This version has some breaking changes. Please see the release notes for more information. In particular, there is no longer a default Typeahead component:

// v1.0
import {Typeahead} from 'react-bootstrap-typeahead'; // ES2015
var Typeahead = require('react-bootstrap-typeahead').Typeahead; // CommonJS

Documentation

CSS

The component tries to use as little CSS as possible, relying primarily on Bootstrap or any Bootstrap themes for styling. Some minimal styling is included in Typeahead.css and Token.css and should ideally be included wherever you're using the component.

Example

To modify the example, clone the repository, npm install and npm run example to build the example index file. You can then open the HTML file locally in a browser. You can also try the live example.

Browser Support

Recent versions of the following browsers are supported:

  • Chrome
  • Firefox
  • IE (10/11)
  • Safari

License

MIT

About

React-based typeahead component that uses Bootstrap as a base for styles and behaviors.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • JavaScript 97.2%
  • CSS 1.6%
  • Other 1.2%