Rack::JQueryUI::Themes

jQuery-UI themes CDN script tags and fallback in one neat package.

Build status

Master branch:

Why?

I get tired of copy and pasting and downloading and moving… jQuery files and script tags etc. This does it for me (along with https://github.com/yb66/rack-jquery), and keeps version management nice ‘n’ easy.

What’s with the plural

Rack::JQueryUI::Theme doesn’t sound right to me, as it’s accessing the Themes service/files. I doubt you’ll ever instantiate a instance of the class yourself, and the computer doesn’t mind, so let it go.

Usage

Have a look in the examples directory, but here’s a snippet.

Install it (see below)
require 'rack/jquery_ui/themes'.
Put this in your middleware stack: use Rack::JQuery::Themes, :theme => "vader"
Put this in the head of your layout (the example is Haml but you can use whatever you like)
```
  %head
    = Rack::JQueryUI::Themes.cdn env, :organisation => :microsoft
  
```

Now you have the script tags to Google’s CDN in the head (you can also use Media Temple or Microsoft, see the docs).

It also adds in a bit of javascript that will load in a locally kept version of jQuery, just incase the CDN is unreachable. The script will use the “/js/jquery-ui/1.10.1/themes/:THEME/jquery-ui.min.css” path (or, instead of 1.10.1, whatever is in Rack::JQueryUI::JQUERY_UI_VERSION), where :THEME is the name of the theme you specified, the default being base.

That was easy.

Note

You have to have loaded jQuery before using the CDN helper, as Rack::jQueryUI::Themes relies on it. I’ve already mentioned Rack::JQuery which you can use to do this, or load the script however you like. Just remember that it needs to be there.

Version numbers

This library uses semver to version the library. That means the library version is not an indicator of quality but a way to manage changes. The version of jQuery-UI can be found in the lib/rack/jquery_ui/themes/version.rb file, or via the Rack::JQueryUI::JQUERY_UI_VERSION constant.

Installation

Add this line to your application’s Gemfile:

gem 'rack-jquery_ui-themes'

And then execute:

$ bundle

Or install it yourself as:

$ gem install rack-jquery_ui-themes

Contributing

Fork it
Create your feature branch (git checkout -b my-new-feature)
Commit your changes (git commit -am 'Add some feature')
Push to the branch (git push origin my-new-feature)
Create new Pull Request

Licence

See the LICENCE.txt file.