README
appt-typeahead
This is an unmaintained fork of Core JS's fork of Twitter's (unmaintained) autocomplete search library, typeahead.js.
The reason for this fork is that while corejs-typeahead has accepted some pull requests to fix longstanding bugs in typeahead.js, they haven't built and released a new version. This package provides an easily bower install
-able version with those fixes.
The typeahead.js library consists of 2 components: the suggestion engine, Bloodhound, and the UI view, Typeahead. The suggestion engine is responsible for computing suggestions for a given query. The UI view is responsible for rendering suggestions and handling DOM interactions. Both components can be used separately, but when used together, they can provide a rich typeahead experience.
Getting Started
How you acquire typeahead.js is up to you:
Install with Bower:
$ bower install appt-typeahead
Install with npm:
$ npm install appt-typeahead
Download the latest dist files individually:
- bloodhound.js (standalone suggestion engine)
- typeahead.jquery.js (standalone UI view)
- typeahead.bundle.js (bloodhound.js + typeahead.jquery.js)
- typeahead.bundle.min.js
Note: both bloodhound.js and typeahead.jquery.js have a dependency on jQuery 1.9+.
Documentation
Examples
For some working examples of typeahead.js, visit the examples page.
Browser Support
- Chrome
- Firefox 3.5+
- Safari 4+
- Internet Explorer 8+
- Opera 11+
NOTE: typeahead.js is not tested on mobile browsers.
Customer Support
For general questions about typeahead.js, tweet at @typeahead.
For technical questions, you should post a question on Stack Overflow and tag it with typeahead.js.
Issues
Discovered a bug? This fork is not maintained. If it hasn't been fixed in the upstream repository, please create an issue on their Github:
github.com/corejavascript/typeahead.js/issues
Versioning
For transparency and insight into our release cycle, releases will be numbered with the following format:
<major>.<minor>.<patch>
And constructed with the following guidelines:
- Breaking backwards compatibility bumps the major
- New additions without breaking backwards compatibility bumps the minor
- Bug fixes and misc changes bump the patch
For more information on semantic versioning, please visit semver.org.
Testing
Tests are written using Jasmine and ran with Karma. To run
the test suite with PhantomJS, run $ npm test
.
Developers
If you want to contribute to typeahead.js, go look at the CoreJavascript project
In order to build and test typeahead.js, you'll need to install its dev
dependencies ($ npm install
) and have grunt-cli
installed ($ npm install -g grunt-cli
). Below is an overview of the available
Grunt tasks that'll be useful in development.
grunt build
– Builds typeahead.js from source.grunt lint
– Runs source and test files through JSHint.grunt watch
– Rebuilds typeahead.js whenever a source file is modified.grunt server
– Serves files from the root of typeahead.js on localhost:8888. Useful for using test/playground.html for debugging/testing.grunt dev
– Runsgrunt watch
andgrunt server
in parallel.
Maintainers
Jake Harding
You?
Authors
Jake Harding
Veljko Skarich
Tim Trueman
License
Copyright 2013 Twitter, Inc.
Licensed under the MIT License