Growl4Rails is a javascript component that provides the UI for growl-like notifications in your Rails application.
This plugin requires Prototype 1.6 or higher and Scriptaculous 1.7 or higher.
Installation
If you are on Rails 2.1 or higher:
$ script/plugin install git://github.com/jfiorato/growl4rails.git
For older versions of Rails, cd into your application's vendor/plugins, and execute the following:
$ git clone --depth 1 git://github.com/jfiorato/growl4rails.git
$ mkdir ../../public/javascripts/growl4rails ../../public/stylesheets/growl4rails ../../public/images/growl4rails
$ cp growl4rails/public/javascripts/* ../../public/javascripts/growl4rails/
$ cp growl4rails/public/stylesheets/* ../../public/stylesheets/growl4rails/
$ cp growl4rails/public/images/* ../../public/images/growl4rails/
Usage
In your view put the following:
<%= growl4rails_includes %>
Then when you'd like the Growl window to appear:
//javascript
Growl.show("/images/download.png", "Foo Bar.pdf", "File is ready for download.", 5000);
Growl.show method takes 4 arguments:
image - 32x32 icon
title - title of the growl
message - the growl message
duration - the length of time (in milliseconds) that the growl window shows
It's definitely got some kinks, but I'm working those out. Obviously, if you'd like to contribute, feel free!
3 comments:
This looks awesome. Really pumped to see it in action after the holiday break!
Looks cool. How about a release and/or direction how to implement outside of Rails.
For those that were wondering about using this without rails, I put up a blog post on how to do it.
http://www.writebetterbits.com/2009/02/growl4rails-rails-growl4.html
Post a Comment