implement options for onRowClick, as well as extend the plugin to allow for chaining and various events

Author: rnpowerconsulting

README.md

@@ -3,8 +3,8 @@ jquery.tabelizer
 
 Multi level grouping indicators for tables.
 
-Tabelizer 1.0.2 - multi level grouping indicators for tables
-Version 1.0.2
+Tabelizer 1.0.3 - multi level grouping indicators for tables
+Version 1.0.3
 Requires jQuery v1.6+ and jQuery.ui core
 
 Copyright (c) 2014 Rafael Huisman
@@ -18,3 +18,35 @@ http://powerconsulting.co/Samples/Tabelizer
 Example Usage:
 
 $('#table1').tabelize();
+
+
+V1.0.3
+----------
+Added public object to return methods to caller
+
+When calling tabelize after initial setup, it will return an object with usable methods, thus providing the ability to chain commands
+$('#table1').tabelize()
+
+Added ability to pass in the following options to the plugin
+
+onRowClick : function(evt){
+	//Event to occur when row is clicked, this will override the build in onRowClick
+	//evt is the event passed in for the click occurance. this could be a row or just the expander depending on the fullRowClickable option
+}
+
+fullRowClickable : true, //When this is set to false, only the expander will be clickable
+
+onReady : function(){
+	//When the plugin finishes it's initialization, this callback method will be called
+	//this refers to the public object self.getPublicObj()
+},
+onBeforeRowClick :  function(evt){
+	//Anything that you want to run before the onRowClick code gets handled goes in here.
+	//evt is the event passed in for the click occurance. this could be a row or just the expander depending on the fullRowClickable option
+	//this refers to the public object self.getPublicObj()
+},
+onAfterRowClick :  function(evt){
+	//Anything that you want to run after the onRowClick code gets handled goes in here.
+	//evt is the event passed in for the click occurance. this could be a row or just the expander depending on the fullRowClickable option
+	//this refers to the public object self.getPublicObj()
+},

example.html

@@ -1,10 +1,24 @@
 <script src="http://code.jquery.com/jquery-1.10.2.js"></script>
 <script src="jquery-ui-1.10.4.custom.min.js"></script>
-<script src="jquery.tabelizer.min.js"></script>
+<script src="jquery.tabelizer.js"></script>
  <link href="tabelizer.min.css" media="all" rel="stylesheet" type="text/css" />
 <script>
 $(document).ready(function(){
-	var table1 = $('#table1').tabelize();
+	var table1 = $('#table1').tabelize({
+		/*onRowClick : function(){
+			alert('test');
+		}*/
+		fullRowClickable : true,
+		onReady : function(){
+			console.log('ready');
+		},
+		onBeforeRowClick :  function(){
+			console.log('onBeforeRowClick');
+		},
+		onAfterRowClick :  function(){
+			console.log('onAfterRowClick');
+		},
+	});
 });
 </script>
 

jquery.tabelizer.js

@@ -1,7 +1,7 @@
 /*
  * 
- * Tabelizer 1.0.2 - multi level grouping indicators for tables
- * Version 1.0.2
+ * Tabelizer 1.0.3 - multi level grouping indicators for tables
+ * Version 1.0.3
  * @requires jQuery v1.6+ and jQuery.ui core
  * 
  * Copyright (c) 2014 Rafael Huisman
@@ -21,8 +21,22 @@
 (function($){
 	var self = {};
 
+	self.isFunction = function(func) {
+		return func && {}.toString.call(func) === '[object Function]';
+	}
+	
 	self.rowClicker = function(evt){
-		var $row = $(evt.currentTarget);
+	
+		if (typeof self.conf.onBeforeRowClick != 'undefined' && self.isFunction(self.conf.onBeforeRowClick))
+			self.conf.onBeforeRowClick.apply(self.getPublicObj(), [evt]);
+		
+		var $elm = $(evt.currentTarget);
+		
+		if (!$elm.is('tr'))
+			$elm = $elm.parentsUntil('tr').parent()
+		
+		$row = $elm;
+		
 		var id = $row.attr('id');
 
 		//Simple toggle for contract/expand logic
@@ -36,6 +50,11 @@
 
 		//After any contraction or expansion we need to resetup the lines since they will likely change.
 		self.updateLines();
+		
+		if (typeof self.conf.onAfterRowClick != 'undefined' && self.isFunction(self.conf.onAfterRowClick))
+			self.conf.onAfterRowClick.apply(self.getPublicObj(), [evt]);
+			
+		return self.getPublicObj();
 	}
 
 	self.updateLines = function(){
@@ -81,6 +100,8 @@
 				$prevRow.addClass(' l' + (parseInt(x)) + '-last')
 			}
 		}
+		
+		return self.getPublicObj();
 	}
 
 	//this method toggles the children on or off, including a sliding motion
@@ -139,6 +160,12 @@
 
 			prevRowLevel = rowLevel;
 		});
+		
+		return self.getPublicObj();
+	}
+	
+	self.updateData = function(){
+		self.caller.data('tabelizer', self);
 	}
 
 	self.maxLevel = 0;
@@ -177,18 +204,56 @@
 				//Add the expanded class, which through css adds in the arrow image
 				$firstCol.html(levelLines + ' <div class="expander"></div> ' + firstColVal);
 
-				//apply the method to be called on each row click
-				$row.on('click', self.rowClicker);
+				//apply the method to be called on each row click, if fullRowClickable is set to false, then only the expander is clickable
+				if (self.conf.fullRowClickable)
+					$row.on('click', self.conf.onRowClick);
+				else
+					$row.find('.expander').on('click', self.conf.onRowClick);
 				prevLevel = currentLevel;
 				$prevRow= $row;
 			}
 		});
 
 		self.updateLines();
+		
+		if (typeof self.conf.onReady != 'undefined' && self.isFunction(self.conf.onReady))
+			self.conf.onReady.apply(self.getPublicObj(), []);
+			
+		return self.getPublicObj();
 	}
-
+	
+	self.getPublicObj = function(){ return {
+		options : self.conf,
+		toggleChildren : self.toggleChildren,
+		updateLines : self.updateLines,
+		rowClicker : self.rowClicker,
+		maxLevel : self.maxLevel,
+		updateData : self.updateData
+	}};
+	
+	self.conf = {
+		onRowClick : self.rowClicker,
+		fullRowClickable : true,//must be set before init
+		onBeforeRowClick : null,
+		onAfterRowClick : null,
+		onReady : null
+	};
+	
 	$.fn.tabelize = function(confProp){
-		self.caller = this;
-		self.init();
+		
+		var existingSelf = this.data('tabelizer');
+		if (typeof existingSelf == 'undefined'){
+			$.extend(self.conf, confProp);
+			self.caller = this;
+			self.init();
+			
+		}else{
+			self = existingSelf;
+			$.extend(self.conf, confProp);
+		}
+		//Store copy of self in data for repeat calls, update it after any repeating call
+		self.updateData();
+		
+		return self.getPublicObj()
 	};
 })(jQuery);

jquery.tabelizer.min.js

@@ -7,7 +7,7 @@
         "grouping",
         "subtotal"
     ],
-    "version": "1.0.2",
+    "version": "1.0.3",
     "author": {
         "name": "Rafael Huisman",
         "url": "http://powerconsulting.co"