Skip to content

Latest commit

 

History

History
140 lines (98 loc) · 4.5 KB

README.textile

File metadata and controls

140 lines (98 loc) · 4.5 KB
Raw

active_stylesheets

Inspired by / Created from Patrick Espake’s stylesheet_by_browser plugin. The functionality for active_stylesheets was created for use on Creative Allies – http://creativeallies.com

Ruby on Rails helper that will insert stylesheets according to the browser, controller name and action name.

This plugin will automatically create stylesheets for all of the major browsers including chrome, firefox, three versions of explorer, opera and safari. You can use these stylesheets to make specific styling changes necessary to perfect your presentation in each browser.

This plugin will also look for and include stylesheets based on the current controller name and current action name.

This plugin makes use of many of the great features in Rails 3. Functionality in older versions of Rails is not guaranteed!

Active Controller and Action stylesheet support

This plugin was designed for a large, very design heavy site that I was working on. I needed very specific styles for each controller action. To do this in a traditional way yielded an insanely large and unmanageable stylesheet. I designed this plugin to augment the traditional rails stylesheet methods and provide a convention for creating action specific stylesheets.

The plugin will read your current controller name and action, and then look in the stylesheets folder to see if a stylesheet specific to either the controller as a whole or the current action exists.

Arrange your stylesheets folder much as you would your views folders.

  • /stylesheets
    • application.css
    • /controller_name
      • controller_name.css
      • action_name.css

An example for the Users controller (perhaps you have a really fancy signup page):

  • /stylesheets
    • application.css
    • /users
      • users.css <— applies to all actions of the UsersController
      • new.css <— applies to users_controller#new

Loading the signup page (users_controller#new) will automatically include two stylesheets if they exist:


<link href="/stylesheets/users/users.css" media="screen" rel="stylesheet" type="text/css" />
<link href="/stylesheets/users/new.css" media="screen" rel="stylesheet" type="text/css" />

Rails 3 Default Stylesheet Inclusion Support

Because the new version of Rails automagically includes all of the stylesheets in the root of your stylesheet folder, active_stylesheets houses the browser specific version of your stylesheet in the /browsers folder inside of stylesheets. If you happen to have a controller called the browsers_controller, this could cause a conflict!

Internet Explorer Version Support

This plugin will respond to Internet Explorer by including a stylesheet specific to the version of Explorer that the request originates from and by including a universal Explorer stylesheet. For example, if the request comes from Internet Explorer 6 (poor user doesn’t know any better) then both ie6.css and ie.css will be included in the application header. Explorer versions 6, 7 and 8 are supported.

Stylesheet File Checking

This plugin also contains a file checking method to insure that a stylesheet exists in the public/stylesheets folder before it includes it in the head output. This helps to insure that the browser will validate, links will not be included if they are broken and allows you to remove unnecessary files from the stylesheets folder to keep things tidy.

Installation

Step 1

For Rails 3


rails plugin install git@github.com:mindtonic/active_stylesheets.git

Step 2

Then install the necessary files into your public directory by running


rake active_stylesheets:install

The files will be added in the directory public/stylesheets:
– chrome.css
– firefox.css
– ie6.css
– ie7.css
– ie8.css
– ie.css
– opera.css
– safari.css

Step 3

Lastly, add the following line to the head element of your application view:


<%= active_stylesheets %>

Now you’re all set!

Example


<%= active_stylesheets %>



<%= active_stylesheets :media => "all" %>



<%= active_stylesheets :media => "print" %>



<%= active_stylesheets :media => "screen" %>

Uninstall


rake active_stylesheets:uninstall

rake active_stylesheets:uninstall

Copyright © 2011 Jay Sanders, released under the MIT license

Site: http://mindtonic.net
Blog: http://blog.mindtonic.net
Email: mailto:mindtonic@gmail.com