Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Ruby on Rails unobtrusive scripting adapter for jQuery
branch: jquery_style_c…

This branch is even with rails:jquery_style_callbacks

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
src
test
.gitignore
Gemfile
Gemfile.lock
MIT-LICENSE.txt
README.rdoc

README.rdoc

jquery-ujs

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 github.com/rails/jquery-ujs/blob/v1.4/src/rails.js .

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 docs.jquery.com/Downloading_jQuery and put the file in public/javascripts. For example, the file might look like:

public/javascripts/jquery-1.4.4.min.js

Step 2

Copy rails.js from github.com/rails/jquery-ujs/raw/master/src/rails.js 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)

Testing

Installation

$ 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 .

Something went wrong with that request. Please try again.