#JQuery Cheats
JQUery cheats is a simple gem that is suppose to make a few things easier within the Rails framework. It is designed to be used with Rails >= 3.0.0 and later will support the asset pipeline requiring Rails >= 3.1.0
##The Asset Pipeline
Because we want to make installing the asset pipeline easier we've provided the following instructions:
-
This gem has a generator to include the needed files run
rails g jquery_cheats:asset_pipeline
-
Make sure that your Gemfile has the following lines of code in it:
group :assets do gem 'sass-rails', " ~> 3.1.0" gem 'coffee-rails', " ~> 3.1.0" gem 'uglifier' end gem 'jquery-rails'
-
Replace the following:
Bundler.require(:default, Rails.env) if defined?(Bundler)
with:
if defined?(Bundler)
# If you precompile assets before deploying to production, use this line
Bundler.require *Rails.groups(:assets => %w(development test))
# If you want your assets lazily compiled in production, use this line
# Bundler.require(:default, :assets, Rails.env)
end
4.See the rest on RailsCasts
##Functions
Mouse over image, Image1 changes to Image2 when moused over:
<%= mouseoverimage("/path/to/image1.jpg","/path/to/image2.jpg") %>
Submit Image, allows you to use an image instead of a button for a form:
<%= submitimage("/path/to/image.png") %>
This can also be used with an alternate text parameter
<%= submitimage("/path/to/image.png","Image Alt Text") %>
Simple Mouse Over Link, Provide one image and a link and it will provide a mouse over image to that link. The function will look for imagename-hover so make sure your image file is named right
<%= simplemolink("/path/to/imgage.png",link_path) %>
This will try to find /path/to/image-hover.png as the image to use when moused over.
##Ajax Requests for Field Items
The new assetpipline JavaScript makes it possible to submit form elements via data-remote calls when changed. Only the following are supported.
###Select Box
To use ajax with jquery_cheats add data-onchange="true" and data-url="/path/to"
###Radio Button
To use with jquery_cheats simply pass a URL into the data-onchange parameter, if you need to send extra parameters use data-params using a serialized string such as(item=4&item2=3)
<%= f.radio_button "foo", foo_path, "data-onchange"=>"/path" %>
##Graphing
JQuery Cheats works in conjunction with plotSimple to provide you with a graphing interface.
##Change Log
- Version 5.0 removes DOMSubtreeModified due to browser issues. Work around call barChart(id,xmlurl) in your JavaScript