fancybox-rails
Use fancybox 1.3.4 with rails 3.1+ asset pipeline.
Installation
This gem vendors jquery fancybox for Rails 3.1 and greater. The files will be added to the asset pipeline and available for you to use.
First add the following lines to your applications Gemfile
:
gem 'jquery-rails'
gem 'fancybox-rails'
Then run bundle install
to update your application's bundle.
Now you need to edit your app/assets/javascripts/application.js
file and add the following line:
//= require jquery
//= require fancybox
And then edit your app/assets/stylesheets/application.css
file to
look something like:
/*
*= require_self
*= require fancybox
*= require_tree .
*/
Usage
With the gem installed and included in your asset manifests, you can now use fancybox as you normally would.
jQuery(function() {
$("a.fancybox").fancybox();
});
If you're using CoffeeScript you can use the plugin in the same way.
jQuery ->
$('a.fancybox').fancybox()
Customization
If you want to customize the fancybox assets you can copy the assets
from the gem into your application's lib/assets/
directory.
$ rails generate fancybox_rails
If you want to see what files will be created without actually creating
them, run the generator with the --pretend
option.
fancyBox 2.0
If you want to use fancyBox 2.0 then check out fancybox2-rails.
Please be aware that the license has changed in the new version and you'll need to purchase one if you intend to use that fork for commercial purposes.
Contributing
- Fork it
- Create your feature branch (
git checkout -b my-new-feature
) - Commit your changes (
git commit -am 'Added some feature'
) - Push to the branch (
git push origin my-new-feature
) - Create new Pull Request
More information
Build status
Useful links
Copyright (c) Chris Mytton