Gem wrapper to include the Modernizr.js library via the Rails 3.1 asset pipeline.
Ruby
Clone or download
Latest commit 614d364 Jan 27, 2015
Permalink
Failed to load latest commit information.
lib Updated to version 2.8.0 May 17, 2014
vendor/assets/javascripts
.gitignore git ignore Mac OS X .DS_Store files Nov 27, 2012
Gemfile Initial commit Jun 21, 2011
LICENSE.md
README.md Updates installation info for Rails 4.x. Jan 15, 2014
Rakefile Initial commit Jun 21, 2011
modernizr-rails.gemspec Add license to gemspec Jan 22, 2015

README.md

modernizr-rails

The modernizr-rails gem will include the Modernizr.js library into your Rails 3.1+ app via the asset pipeline. This gem is bundled with the last tagged release version from the Modernizr GitHub repo, which is minified by the Rails Assets Pipeline for you automatically. If you need custom feature detection tests, consider the Custom feature detection tests section in this README.

Installation

Rails 3.x

Add the following to your assets group in your Gemfile:

group :assets do
  gem 'modernizr-rails'
end

Rails 4.x

Add the following into your Gemfile:

gem 'modernizr-rails'

Usage

Modernizr should be added to the <head> of your HTML. Be sure to check out the offical docs about Installing Modernizr for more info. Include it using the helper like so <%= javascript_include_tag :modernizr %>, Rails will take care of the compilation and minification automatically for you.

Example of your app/views/layouts/application.html.erb:

<html>
<head>
  <title>Your Awesome App</title>
  <%= stylesheet_link_tag    :application, media: :all %>
  <%= javascript_include_tag :modernizr %>
  <%= csrf_meta_tags %>
</head>
<body>
  ...
  <%= javascript_include_tag :application %>
</body>
</html>

Custom feature detection tests

If you need a custom feature detection test not included in the Modernizr build shipped with this gem, please consider using your own version instead of sending a pull request to include your test. You can easily do this by moving your Modernizr build in to one of the assets folder. Rails will automagically use your build instead of the shipped one. However you can still continue to use this gem and its features (like the precompile hook, and so on).

  1. Configure your build on modernizr.com/download.
  2. Download it.
  3. Rename it from modernizr.custom.12345.js to just modernizr.js.
  4. Move it to your asset pipeline folder, ideally vendor/assets/javascripts.
  5. Enjoy your custom build! :)

Contributing

  1. Fork it
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Added some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create new Pull Request

Copyright

(The MIT license)

Copyright (C) 2011-2013 Russell Frisch (russfrisch)

See LICENSE.md.