Holder.js for Rails

Build Status Gem Version

Provides Holder.js to render image placeholders entirely on the client side.

Installation

Add to your Gemfile:

gem 'holder_rails'

and run:

bundle install

Usage

Add to your JavaScript manifest file:

//= require holder

And if you're using turbolinks don't forget to run Holder after page:change event:

$(document).bind 'page:change', ->
  Holder.run()

You can use holder_tag helper in your views:

holder_tag 100
# => <img data-src="holder.js/100x100/text:100x100/" src="" />

holder_tag '200x300'
# => <img data-src="holder.js/200x300/text:200x300/" src="" />

holder_tag '200x300', 'Lorem ipsum'
# => <img data-src="holder.js/200x300/text:Lorem ipsum/" src="" />

holder_tag '200x300', 'Lorem ipsum', 'social'
# => <img data-src="holder.js/200x300/text:Lorem ipsum/social" src="" />

holder_tag '500x800', 'Example text', 'gray', :id => 'new', :class => 'special'
# => <img class="special" data-src="holder.js/500x800/text:Example text/gray" id="new" src="" />

For more information, check out holder readme.

Versioning

holder_rails X.Y.Z == Holder.js X.Y.Z

License

Released under the BSD 2-clause license. See LICENSE.txt for details.