A React-based typeahead that relies on Bootstrap for styling and was originally inspired by Twitter's typeahead.js. It supports both single- and multi-selection and is compliant with WAI-ARIA authoring practices. Try the live examples.
Please note that documentation and examples apply to the most recent release and may no longer be applicable if you're using an outdated version.
npm install --save react-bootstrap-typeahead
or
yarn add react-bootstrap-typeahead
Include the module in your project:
import {Typeahead} from 'react-bootstrap-typeahead'; // ES2015
var Typeahead = require('react-bootstrap-typeahead').Typeahead; // CommonJSDevelopment and production builds are included in the NPM package. Alternatively, you can get them from CDNJS or unpkg.
While the component relies primarily on Bootstrap for styles, some additional CSS is necessary for everything to behave correctly. You must include the provided CSS file in your project:
// Import as a module in your JS
import 'react-bootstrap-typeahead/css/Typeahead.css';or
<!-- Link as a stylesheet in your HTML -->
<link rel="stylesheet" href="https://unpkg.com/react-bootstrap-typeahead/css/Typeahead.css">In an effort to fully support Bootstrap 4, this package also contains a CSS file named Typeahead-bs4.css that should be included alongside the base CSS file above.
Try the live examples, which also include code samples. If you'd like to modify the examples, clone the repository and run npm install and npm start to build the example file. You can then open the HTML file locally in your browser.
You can also try out the following sandbox examples:
If you have an example use case that would be useful to others, please create a sandbox and submit a pull request to add it to the list!
Recent versions of the following browsers are supported:
- Chrome
- Firefox
- IE (>=11)
- Safari
Special thanks to BrowserStack for providing cross-browser testing support.
