Switch branches/tags
Nothing to show
Find file
Fetching contributors…
Cannot retrieve contributors at this time
66 lines (34 sloc) 1.65 KB


Unobtrusive jQuery with Rails 3

The rails.js file from master branch supports following versions of jQuery:

  • 1.4.3

  • 1.4.4

If you are using one of the following version of jQuery then use branch v1.4 .

  • 1.4

  • 1.4.1

  • 1.4.2

rails.js file from v1.4 branch can be accessed at .

Automated Installation

Step 1

Add this line to your Gemfile:

gem 'jquery-rails'

Step 2

Run this command:

$ rails generate jquery:install # --ui if you want jQuery UI

Manual installation

Step 1

Download jQuery from and put the file in public/javascripts. For example, the file might look like:


Step 2

Copy rails.js from into public/javascripts - overwriting the prototype one (you can also delete the other prototype files if you don't need them for anything else.)

Step 3 (optional)

Switch the javascript_include_tag :defaults to use jquery instead of the default prototype helpers. Uncomment following line from file config/application.rb

config.action_view.javascript_expansions[:defaults] = %w(jquery rails application)



$ gem install bundler
$ bundle install

Running tests

$ bundle exec ruby test/server.rb

Visit localhost:4567 and all the tests should pass.

At the top of the page you will see links to jQuery 1.4.3 and 1.4.4 . By clicking on those links you will be executing the tests against the clicked version of jquery. By default test uses jQuery 1.4.4 .