tree_view

TreeView

TreeView is a little plugin to generate a tree view. TreeView is powered by jQuery and jQuery drawing plugin. It only supports Rails 3.1.

http://benzhang.me/files/medium_tree_view.jpg

Installation

Add this line to your gemfile

gem 'tree_view'

then run the install command to copy the assets to vendor.

rails g tree_view:install

include necessary javascript and stylesheet files.

Add these files to your application.js

//= require jquery.dimensions.min.js
//= require jquery.drawinglibrary.js
//= require jquery.svg.min.js
//= require tree_view.drawline.js

Add the stylesheet to your application.css

//= require tree_view

Example

If you have a model with tree structure (you might use tree or ancestry gem), you can simple invoke tree_view helper, and pass the root node of the tree.

In controller

@root = Policy.root

In View

<%= tree_view(@root) %>

To customise the content or each view you can simple pass a block and can

API Doc

# generate html tree view helper
#
# @param root      [model instance] the root node of the tree structure
# @param opt       [Hash]           the options to generate tree nodes
#       :css       [String]         the wrapper div's css
#       :drawline  [true, false]    whether draw lines among each nodes
#       :node_css  [String]         the css for each node
#       :order_by  [sym]            the order of the children
# @param &block    [code block]     if you want to customise the content of each tree node, just passing a code block
def tree_view(root, opt = {}, &block)

Copyright (c) 2011 Ben Zhang, released under the MIT license