Minor changes on API for range selection and max.

Author: rmariuzzo

src/jquery.checkboxes.js

@@ -5,40 +5,8 @@
     /* Checkboxes class definition. */
     //////////////////////////////////
 
-    var defaults = {
-        range : false,
-        max : 0
-    };
-
     var Checkboxes = function($context, options) {
         this.$context = $context;
-        options = $.extend({}, defaults, options);
-        var instance = this;
-        if (options.range) {
-            this.$context.on('click.checkboxes', ':checkbox', function(e) {
-                var $checkbox = $(e.target);
-                if (e.shiftKey && instance.$last) {
-                    var $checkboxes = instance.$context.find(':checkbox'),
-                        from = $checkboxes.index(instance.$last),
-                        to = $checkboxes.index($checkbox);
-                    if (to > from) {
-                        $checkboxes.slice(from, to).prop('checked', true);
-                    } else {
-                        $checkboxes.slice(to, from).prop('checked', true);
-                    }
-                }
-                instance.$last = $checkbox.is(':checked') ? $checkbox : null;
-            });
-        }
-        if (options.max > 0) {
-            this.$context.on('click.checkboxes', ':checkbox', function(e) {
-                if (instance.$context.find(':checked').length == options.max) {
-                    instance.$context.find(':checkbox:not(:checked)').prop('disabled', true);
-                } else {
-                    instance.$context.find(':checkbox:not(:checked)').prop('disabled', false);
-                }
-            });
-        }
     };
 
     // Check all checkboxes in context.
@@ -59,21 +27,61 @@
         });
     };
 
+    // Set the maximum number of checkboxes that can be checked.
+    Checkboxes.prototype.max = function(max) {
+        if (max == 0) {
+            // Disable max.
+            this.$context.off('click.checkboxes');
+        } else if (max > 0) {
+            // Enable max.
+            var instance = this;
+            this.$context.on('click.checkboxes.max', ':checkbox', function(e) {
+                if (instance.$context.find(':checked').length == max) {
+                    instance.$context.find(':checkbox:not(:checked)').prop('disabled', true);
+                } else {
+                    instance.$context.find(':checkbox:not(:checked)').prop('disabled', false);
+                }
+            });
+        }
+    };
+
+    // Enable or disable range selection.
+    Checkboxes.prototype.range = function(enable) {
+        if (enable) {
+            var instance = this;
+            this.$context.on('click.checkboxes.range', ':checkbox', function(e) {
+                var $checkbox = $(e.target);
+                if (e.shiftKey && instance.$last && ($checkbox.prop('checked') == instance.$last.prop('checked'))) {
+                    var $checkboxes = instance.$context.find(':checkbox'),
+                        from = $checkboxes.index(instance.$last),
+                        to = $checkboxes.index($checkbox),
+                        start = Math.min(from, to),
+                        end = Math.max(from, to);
+                    $checkboxes.slice(start, end).prop('checked', true);
+                }
+                instance.$last = $checkbox.is(':checked') ? $checkbox : null;
+            });
+        } else {
+            this.$context.off('click.checkboxes.range');
+        }
+    };
+
     ///////////////////////////////////
     /* Checkboxes plugin definition. */
     ///////////////////////////////////
 
     var old = $.fn.checkboxes;
 
-    $.fn.checkboxes = function(options) {
+    $.fn.checkboxes = function(method) {
+        var methodArgs = Array.prototype.slice.call(arguments, 1);
         return this.each(function() {
             var $this = $(this),
                 data = $this.data('checkboxes');
             if (!data) {
-                $this.data('checkboxes', (data = new Checkboxes($this, typeof options == 'object' && options)));
+                $this.data('checkboxes', (data = new Checkboxes($this, typeof method == 'object' && method)));
             }
-            if (typeof options === 'string') {
-                data[options]();
+            if (typeof method === 'string') {
+                data[method].apply(data, methodArgs);
             }
         });
     };

test/test.html

@@ -0,0 +1,47 @@
+<!doctype html>
+<html lang="en">
+<head>
+	<meta charset="UTF-8">
+	<title>Document</title>
+	<script src="../lib/jquery/jquery.js"></script>
+	<script src="../src/jquery.checkboxes.js"></script>
+	<script>
+		jQuery(function($) {
+			$('body').checkboxes('range', true, true)
+				.checkboxes('max', 4);
+		});
+	</script>
+</head>
+<body>
+	<input type="checkbox" id="1">
+	<label for="1">Row #1</label>
+	<br>
+	<input type="checkbox" id="2">
+	<label for="2">Row #2</label>
+	<br>
+	<input type="checkbox" id="3">
+	<label for="3">Row #3</label>
+	<br>
+	<input type="checkbox" id="4">
+	<label for="4">Row #4</label>
+	<br>
+	<input type="checkbox" id="5">
+	<label for="5">Row #5</label>
+	<br>
+	<input type="checkbox" id="6">
+	<label for="6">Row #6</label>
+	<br>
+	<input type="checkbox" id="7">
+	<label for="7">Row #7</label>
+	<br>
+	<input type="checkbox" id="8">
+	<label for="8">Row #8</label>
+	<br>
+	<input type="checkbox" id="9">
+	<label for="9">Row #9</label>
+	<br>
+	<input type="checkbox" id="10">
+	<label for="10">Row #10</label>
+	<br>
+</body>
+</html>