jScrollPane plugin for Rails

A Ruby gem that uses the Rails asset pipeline to include the jScrollPane plugin by Kelvin Luck and Tuukka Pasanen:

Installation

Add this line to your application's Gemfile:

gem 'jscrollpane-rails'

And then execute:

$ bundle

Or install it yourself as:

$ gem install jscrollpane-rails

This is a jQuery plugin so you will also need the jquery-rails gem (for instance, Rails 5.1 does not have this gem by default anymore):

https://github.com/rails/jquery-rails

It is also recommended (but is optional) to include jQuery MouseWheel plugin by Brandon Aaron (https://github.com/brandonaaron/jquery-mousewheel/) to allow people to scroll your content using their mouse wheel. There is a gem jquery-mousewheel-rails available:

https://github.com/crazymykl/jquery-mousewheel-rails

This is totally optional but you can increase the usability of the mousewheel in nested scroll areas by including jQuery MouseWheel Intent plugin by trixta and bodrovis. There is a gem mwheelintent-rails available:

https://github.com/bodrovis/mwheelintent-rails

FOR RUSSIAN SPEAKERS: There is a guide available describing basic usage of jScrollPane: http://bodrovis.tech/categories/javascript-css-html/posts/nestandartnaya-polosa-prokrutki-s-pomoschyu-javascript

FOR ENGLISH SPEAKERS: The same guide is now available in English: http://bodrovis.tech/categories/javascript-css-html/posts/creating-custom-scrollpane-using-javascript

Usage

In your application.js you will need to add this line:

//= require jquery.jscrollpane

And in your application.scss you will need to add this line:

@import 'jquery.jscrollpane';

Testing

Run

$ bundle install

and then

$ rake test

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

License

This plugin is licensed under the MIT license. The jScrollPane itself is dual-licensed under the GPL 2 license and the MIT license.