google-ajax-api's Introduction

Google AJAX API

Now you no longer have to manually download frameworks and manually wire them into your app, this super duper simple rails plugin allows you to load js frameworks from google. You can view the list of available frameworks to use here:

  http://code.google.com/apis/ajaxlibs/documentation/

USAGE

Just call the following method in your layout file, preferably in the head:

  <%= include_js 'framework-version' %>

EXAMPLES

LOAD JQUERY 1.3.2

  <%= include_js 'jquery-1.3.2' %>

LOAD PROTOTYPE 1.6.0.2

  <%= include_js 'prototype-1.6.0.3' %>

LOAD MOOTOOLS

  <%= include_js "mootools-1.2.1" %>

YOU CAN ALSO LOAD MULTIPLE FRAMEWORKS

LOAD JQUERY 1.3.2 AND JQUERY UI 1.7.1

  <%= include_js 'jquery-1.3.2', 'jqueryui-1.7.1' %>

WHAT IF YOU'RE NOT ONLINE?

First, run the rake task for the library that you want to access offline:

  rake gajax:install[jquery-1.3.2] # Format: library_name-version.number

  or, if your library and filename doesn't match
  rake gajax:install[scriptaculous-1.8.10,effects] # 'effects' is the js filename

Then just pass the :cached option to the end of your array:
  
  <%= include_js 'jquery-1.3.2', :cached %>
  <%= include_js 'jquery-1.3.2', 'jqueryui-1.7.1', :cached %>

It's smart enough to know whether or not you're in production, so it knows what to use at the right time.

NOTE: The cached option doesn't work with YUI, Ext Core, or Chrome Frame, you'll have to manually download them
yourself and move the in the javascripts library.

Recommend Projects