Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

Rails asset gem for Twitters typeahead.js jquery plugin

branch: master

Merge pull request #11 from dtengeri/typeahead-0.10.2-upgrade

Typeahead 0.10.2 upgrade thanks to @dtengeri

Closes #10, #11
latest commit b9e407f9a4
Yousef Ourabi authored
README.md

Twitter typeahead.js jquery plugin

This asset gem packages the twitter typeahead.js jquery plugin for the Rails asset pipeline.

To learn more about typeahead.js read the post Twitter's engineering blog.

This gem includes the standard and minified versions of the assets.

Installation

Add this line to your application's Gemfile:

gem 'twitter-typeahead-rails'

or

gem 'twitter-typeahead-rails', :git => "git://github.com/yourabi/twitter-typeahead-rails.git"

And then execute:

$ bundle

Or install it yourself as:

$ gem install twitter-typeahead-rails

Usage

To start using the twitter typeahead.js plugin in your rails app enable it via the asset pipeline (app/assets/javascripts/application.js).

Add one of the following to your application.js manifest:

//= require twitter/typeahead

//= require twitter/typeahead.min

// Twitter typeahead exmaple.

// instantiate the bloodhound suggestion engine
var numbers = new Bloodhound({
  datumTokenizer: Bloodhound.tokenizers.obj.whitespace('num'),
  queryTokenizer: Bloodhound.tokenizers.whitespace,
  local: [
    { num: 'one' },
    { num: 'two' },
    { num: 'three' },
    { num: 'four' },
    { num: 'five' },
    { num: 'six' },
    { num: 'seven' },
    { num: 'eight' },
    { num: 'nine' },
    { num: 'ten' }
  ]
});

// initialize the bloodhound suggestion engine
numbers.initialize();

// instantiate the typeahead UI
$('.example-numbers .typeahead').typeahead(null, {
  displayKey: 'num',
  source: numbers.ttAdapter()
});

Currently this version tracks version v0.10.2.

Contributing

  1. Fork it
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create new Pull Request
Something went wrong with that request. Please try again.