protovisonrails

protovisonrails copied to clipboard

A very rough'n'ready Rails plugin that allows relatively trivial integration of the Protovis ( http://vis.stanford.edu/protovis/ ) javascript chart rendering API into a Rails project.

The usage is relatively simple, install it as a git submodule: git submodule add git://github.com/ciaranj/redmine.git vendor/plugins/protovisonrails

There is an includes helper ( protovis_includes ) that allows you to automatically pull in these javascript files.

This now provides a minimal object model for constructing these protovis charts/panels using Ruby, for example:

panel=Panel.new(:name=> 'panel', :width=> 150, :height => 150 ) bar= Bar.new(:name=> 'bar', :width=> 20, :bottom=> 0, :height=> "function(d) d * 50", :left => "function() this.index * 25", :data => [1, 1.2, 1.7, 1.5, 0.7])

panel.add( bar ) bar2= Bar.new(:name=> 'bar2', :data => [0.5, 1, 0.8, 1.1, 1.3], :bottom => "function() bar.height() + bar.bottom()" ) bar.add( bar2)

Will construct a model that can be used in your view as follows:

<%= render_protovis_panel(panel) %>

The intention is to provide more of a useful object model to build these objects up programatically. Currently all of these charts ( http://vis.stanford.edu/protovis/api/Bar.html ) can be re-produced (and are in fact reproduced in the test renderer <%=render_protovis_tests%>) The API is most definately subject to change!