diff --git a/docs/example-widget-grouping.html b/docs/example-widget-grouping.html new file mode 100644 index 00000000..958a157b --- /dev/null +++ b/docs/example-widget-grouping.html @@ -0,0 +1,315 @@ + + + + + jQuery plugin: Tablesorter 2.0 - Grouping Rows Widget + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ +

+ NOTE! +

+ +

+ +

Demo

+ +Numeric column:

+Animals column:

+Date column:
+ +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Quality (number) Numeric (every 10)Priority (letter)Animals (first letter)Natural Sort (first word)Inputs (second word)Date (Full)
QualityNumericPriorityAnimalsNatural SortInputsDate
110Koalaabc 1231/13/2013 12:01 AM
329Kangarooabc 11/15/2013
210Antabc 91/13/2013
381Beezyx 241/11/2013
321Aardwolfzyx 551/13/2013 03:30 AM
13Bearabc 111/15/2013
412Armadillozyx 21/15/2013 12:30 PM
256Aardvarkabc 21/22/2013
155Lionabc 92/15/2013
487AnteaterABC 101/3/2013
298Lemurzyx 11/11/2013
120Llamazyx 1212/13/2012
+
+ +

Page Header

+
+ 
<!-- Tablesorter: required -->
+<link rel="stylesheet" href="../css/theme.blue.css">
+<script src="../js/jquery.tablesorter.js"></script>
+
+<!-- Grouping widget -->
+<script src="../js/parsers/parser-input-select.js"></script>
+<script src="../js/widgets/widget-grouping.js"></script>
+
+<script>
+$(function(){
+
+  $("table").tablesorter({
+    theme : 'blue',
+    headers: {
+      0: { sorter: 'checkbox' },
+      2: { sorter: 'select' },
+      6: { sorter: 'inputs' }
+    },
+    widgets: ['group'],
+    widgetOptions: {
+      group_collapsible : true, // make the group header clickable and collapse the rows below it.
+      group_count       : ' ({num})', // if not false, the "{num}" string is replaced with the number of rows in the group
+      // change these default date names based on your language preferences
+      group_months      : [ 'Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun', 'Jul', 'Aug', 'Sep', 'Oct', 'Nov', 'Dec' ],
+      group_week        : [ 'Sunday', 'Monday', 'Tuesday', 'Wednesday', 'Thursday', 'Friday', 'Saturday' ],
+      group_time        : [ 'AM', 'PM' ],
+      group_formatter   : function(txt, col, table, c, wo) {
+        // txt = current text; col = current column
+        // table = current table (DOM); c = table.config; wo = table.config.widgetOptions
+        if (col === 7) {
+          // remove "GMT-0000 (xxxx Standard Time)" from the end of the full date
+          txt = txt.substring(0, txt.indexOf('GMT'));
+        }
+        return txt === "" ? "Empty" : txt;
+      }
+    }
+  });
+
+});</script>
+
+

CSS

+
+ 

+	

+
+	
HTML

+	

+		

+	

+
+	
+
+

+
+
+
diff --git a/js/widgets/widget-grouping.js b/js/widgets/widget-grouping.js
new file mode 100644
index 00000000..f056d462
--- /dev/null
+++ b/js/widgets/widget-grouping.js
@@ -0,0 +1,113 @@
+/*! tablesorter Grouping widget - updated 3/18/2013
+ * Requires tablesorter v2.8+ and jQuery 1.7+
+ * by Rob Garrison
+ */
+/*global jQuery: false */
+;(function($){
+"use strict";
+
+$.tablesorter.addWidget({
+	id: 'group',
+	options: {
+		group_collapsible : true, // make the group header clickable and collapse the rows below it.
+		group_count       : ' ({num})', // if not false, the "{num}" string is replaced with the number of rows in the group
+		// change these default date names based on your language preferences
+		group_months      : [ 'Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun', 'Jul', 'Aug', 'Sep', 'Oct', 'Nov', 'Dec' ],
+		group_week        : [ 'Sunday', 'Monday', 'Tuesday', 'Wednesday', 'Thursday', 'Friday', 'Saturday' ],
+		group_time        : [ 'AM', 'PM' ],
+		group_formatter   : null // function(curr, col, table, c, wo) { return curr; }
+	},
+	init: function(table, thisWidget, c, wo){
+		if (wo.group_collapsible) {
+			// .on() requires jQuery 1.7+
+			c.$table.on('click', 'tr.group-header', function(){
+				$(this).toggleClass('collapsed');
+				// nextUntil requires jQuery 1.4+
+				$(this).nextUntil('tr.group-header').toggleClass('group-hidden', $(this).hasClass('collapsed') );
+			});
+		}
+	},
+	format: function(table, c, wo) {
+		var j, k, curr, $tr, g, t, t2, time,
+		group = '',
+		col = c.sortList[0] ? c.sortList[0][0] : -1,
+		groupBy = {
+			number : function($col, txt, num){
+				if (num > 1 && txt !== '') {
+					if ($col.hasClass(c.cssAsc)) {
+						t = Math.floor(parseFloat(txt)/num) * num;
+						return t > parseFloat(group || 0) ? t : parseFloat(group || 0);
+					} else {
+						t = Math.ceil(parseFloat(txt)/num) * num;
+						return t < parseFloat(group || num) - t ? parseFloat(group || num) - t : t;
+					}
+				} else {
+					var w = (txt + '').match(/\d+/g);
+					return w && w.length >= num ? w[num - 1] : txt || '';
+				}
+			},
+			word   : function($col, txt, num){
+				var w = (txt + ' ').match(/\w+/g);
+				return w && w.length >= num ? w[num - 1] : txt || '';
+			},
+			letter : function($col, txt, num){
+				return txt ? (txt + ' ').substring(0, num) : '';
+			},
+			date   : function($col, txt, part){
+				t = new Date(txt || '');
+				t2 = t.getHours();
+				return part === 'year' ? t.getFullYear() :
+					part === 'month' ? wo.group_months[t.getMonth()] :
+					part === 'day' ? wo.group_months[t.getMonth()] + ' ' + t.getDate() :
+					part === 'week' ? wo.group_week[t.getDay()] :
+					part === 'time' ? ('00' + (t2 > 12 ? t2 - 12 : t2 === 0 ? t2 + 12 : t2)).slice(-2) + ':' + ('00' + t.getMinutes()).slice(-2) + ' ' +
+						('00' + wo.group_time[t2 >= 12 ? 1 : 0]).slice(-2) :
+					t.toString();
+			}
+		};
+
+		c.$table
+			.find('tr.group-hidden').removeClass('group-hidden').end()
+			.find('tr.group-header').remove();
+		if (col >= 0) {
+			if (c.debug){ time = new Date(); }
+			for (k = 0; k < c.$tbodies.length; k++) {
+				$tr = c.$tbodies.children('tr');
+				for (j = 0; j < $tr.length; j++) {
+					t = (c.$headers.eq(col).attr('class') || '').match(/(group-\w+(-\w+)?)/g);
+					// group-{type}-{number/date}
+					t2 = t ? t[0].split('-') : ['','letter',1]; // default to letter 1
+					curr = groupBy[t2[1]]( c.$headers.eq(col), c.cache[k].normalized[j][col], /date/.test(t) ? t2[2] : parseInt(t2[2] || 1, 10) || 1 );
+					if (group !== curr) {
+						group = curr;
+						// show range if number > 1
+						if (t2[1] === 'number' && t2[2] > 1 && curr !== '') {
+							curr += ' - ' + (parseInt(curr, 10) + ((parseInt(t2[2],10) - 1) * (c.$headers.eq(col).hasClass(c.cssAsc) ? 1 : -1)));
+						}
+						if ($.isFunction(wo.group_formatter)) {
+							curr = wo.group_formatter((curr || '').toString(), col, table, c, wo) || curr;
+						}
+						$tr.eq(j).before('' +
+							(wo.group_collapsible ? '' : '') + '' + curr + '');
+					}
+				}
+			}
+			if (wo.group_count) {
+				c.$table.find('tr.group-header').each(function(){
+					$(this).find('.group-count').html( wo.group_count.replace(/\{num\}/g, $(this).nextUntil('tr.group-header').length) );
+				});
+			}
+			if (c.debug) {
+				$.tablesorter.benchmark("Applying groups widget: ", time);
+			}
+		}
+	},
+	remove : function(table, c, wo){
+		c.$table
+			.off('click', 'tr.group-header')
+			.find('.group-hidden').removeClass('group-hidden').end()
+			.find('tr.group-header').remove();
+	}
+});
+
+})(jQuery);