listy 0.0.2 → 0.0.3

data/README.md

@@ -27,15 +27,31 @@ Listy also includes some Javascript assets, so be sure to add the following line
 
 ## Usage
 
-There are a couple of helper method including:
+There are a couple of helper methods including:
 
-### list_of_links(collection, display_method_name, css_class, show_more_index=5, empty_message="")
+	listy_links(collection, display_method_name, css_class, show_more_index=5, empty_message="")
 
 This method creates a simple unordered list of the elements in the collection.
 
-### multi_column_list_of_links(collection, display_method_name, css_class, number_of_columns)
+	multi_column_listy_links(collection, display_method_name, css_class, number_of_columns)
+
+This does the same thing as listy_links but presents it in the number of columns you specify.
+
+	listy_tree(collection, spec, empty_message)
+
+This method is for creating a nested tree of unordered lists for a collection with nested collections. This is suitable for Rails models that have has_many relationships.
+
+Example let's say we have the following
+
+* Country which has_many States
+* State which has_many Cities
+
+Typical usage would be:
+
+	listy_tree(Country.all, {:display_method_name => :name, :children => :states, :child => { :display_method_name => :name, :children => :cities, :child => {:display_method_name => :name, :children => nil, :child => nil}}}, "")
+
+Be sure that the inner most child of the spec has :children => nil. This will stop the nesting.
 
-This does the same thing as list_of_links but presents it in the number of columns you specify.
 
 ## Contributing
 

data/app/assets/javascripts/listy.js

@@ -1,20 +1,20 @@
+/*********************** LISTY TREE LIST **********************************************/
 $(function(){
-	$(".listy-tree .list-header").click(listHeaderClick);
-	$(".listy-show-more-link").click(toggleMoreList);
+	$(".listy-tree .listy-tree-list-header").click(listyTreeListHeaderClick);
 });
 
-function listHeaderClick() {
+function listyTreeListHeaderClick() {
 	var list = $(this).siblings("ul");
-	toggleList(list);
+	toggleListyTreeList(list);
 }
 
-function toggleList(list) {
-	toggleList(200);
+function toggleListyTreeList(list) {
+	toggleListyTreList(200);
 }
 
-function toggleList(list, duration) {
+function toggleListyTreeList(list, duration) {
 	
-	var header = list.siblings(".list-header");
+	var header = list.siblings(".listy-tree-list-header");
 	if(list.is(":visible")) {
 		list.slideUp(duration);
 		header.children(".icon").html("<i class='icon-angle-right'></i>");
@@ -36,6 +36,11 @@ function autoCollapseAllBut(headerName, tree) {
 	});
 }
 
+/*********************** LISTY SHOW-MORE LIST ******************************************/
+$(function(){
+	$(".listy-show-more-link").click(toggleMoreList);
+});
+
 function toggleMoreList() {
 	toggleMoreList(200);
 	return false;

data/lib/listy/version.rb

@@ -1,3 +1,3 @@
 module Listy
-  VERSION = "0.0.2"
+  VERSION = "0.0.3"
 end

data/lib/listy/view_helpers.rb

@@ -1,7 +1,30 @@
 module Listy
   module ViewHelpers
  
-    def list_of_links(collection, display_method_name, css_class, show_more_index=5, empty_message="")
+    def listy_tree(collection, spec, empty_message)
+      if collection.present?
+        html = "<div class='listy-tree'>" + create_listy_tree(collection, spec, "", 0) + "</div>"
+      else
+        html = "There are no entries in this tree."
+        html = empty_message if !empty_message.nil?
+      end
+      raw html
+    end
+    
+    def create_listy_tree(collection, spec, html, level)
+      html += "<ul class='listy-tree-level-#{level}'>"
+      
+      collection.each do |element|
+        html += "<li>"
+        html += "<div class='listy-tree-list-header'>#{element.try(spec[:display_method_name])}</div>"
+        html = create_listy_tree(element.try(spec[:children]), spec[:child], html, level+1) if !spec[:children].nil?
+        html += "</li>"
+      end
+      
+      html += "</ul>"      
+    end
+ 
+    def listy_links(collection, display_method_name, css_class, show_more_index=5, empty_message="")
       if collection.present?
         html = "<ul class='" + css_class + "'>"
         show_more = false
@@ -25,7 +48,7 @@ module Listy
       raw html
     end
 
-    def multi_column_list_of_links(collection, display_method_name, css_class, number_of_columns)
+    def multi_column_listy_links(collection, display_method_name, css_class, number_of_columns)
       html = ""
       if collection.present?
         number_of_entries_per_column = collection.size/number_of_columns

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: listy
 version: !ruby/object:Gem::Version
-  version: 0.0.2
+  version: 0.0.3
   prerelease: 
 platform: ruby
 authors:
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-07-22 00:00:00.000000000 Z
+date: 2013-07-23 00:00:00.000000000 Z
 dependencies: []
 description: ! '"A bunch of helpers to create fancy lists"'
 email: