= Dojo_Toolbocks
The Dojo Toolbocks is a superstar plugin (engine) that provides the
functionality to include any of the Dojo Toolkit libraries into your
Ruby on Rails application.
==Dependencies
The dependencies are automatically loaded into your application.
For reference they are:
- Dojo Toolkit v0.4
- Engines v1.2
- Rails v1.2.x
==Installation
1. script/plugin install dojo_toolbocks
a) If you don't already have engines installed and configured, then
you will need to modify the /config/environment.rb file. After the
"Rails::Initializer.run" add the following line:
config.plugins = ["engines", "*"]
2. Add the following line to the main template
(/app/views/layouts/application.rhtml) between the opening and closing
<head> tags. Alternatively, you can add it to each individual template
as needed.
<%= javascript_include_tag 'dojo', :plugin => 'dojo_toolbocks' %>
3. Depending on what libraries you need for the functionality you
desire, you can use the _dojo_require_ method either as a tag, or as a
block as shown in a) and b). This method is to be called within the
<head> tag. See ==Usage for examples.
==Usage
Here is the full rhtml template for using the Dojo
Toolbocks::Slideshow, with debugging enabled.
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"
"http://www.w3.org/TR/html4/strict.dtd";>
<html>
<head>
<title>Dojo Toolbocks: Slideshow Demo</title>
<%= dojo_config(:debug => true) %>
<%= javascript_include_tag 'dojo', :plugin =>
'dojo_toolbocks' %>
<%= dojo_require ({:script_tag => true},
"dojo.widget.*",
"dojo.widget.SlideShow") %>
</head>
<body>
<img dojoType="SlideShow"
imgUrls="<%= (1..6).map { |n|
image_path("demos/widget/slideshow/#{n}.jpg", :plugin =>
"dojo_toolbocks") }.join(';') %>"
transitionInterval="700"
delay="7000"
src="<%=
image_path('demos/widget/slideshow/1.jpg', :plugin =>
'dojo_toolbocks') %>"
imgWidth="400" imgHeight="300" />
</body>
</html>
a) Debugging
<%= dojo_config(:debug => true) %>
b) Library Inclusion: Tag Style
<%= dojo_require ({:script_tag => true}, "dojo.widget.*", "dojo.lang.*") %>
c) Library Inclusion: Block Style
<% dojo_require ({:script_tag => true}, "dojo.widget.*", "dojo.lang.*") do %>
function somethingUseful(todo) {
// this method does something useful, and is wrapped in the same
script tag as the library includes
}
<% end %>
==Bugs
Please report any bugs or feature enhancements to http://dev.toolbocks.com
--
Nathaniel Steven Henry Brown
Toll Free: 1-877-446-4647
Vancouver: 604-724-6624
--~--~---------~--~----~------------~-------~--~----~
You received this message because you are subscribed to the Google Groups "Ruby
on Rails: Spinoffs" group.
To post to this group, send email to [email protected]
To unsubscribe from this group, send email to [EMAIL PROTECTED]
For more options, visit this group at
http://groups.google.com/group/rubyonrails-spinoffs?hl=en
-~----------~----~----~----~------~----~------~--~---
