Merge #38

Merging conflicts, version update 0.8.0

Author: ractoon

README.md

@@ -111,7 +111,8 @@ Fires when counter is under min limit.
 ```javascript
 type                        : "character",                     // "character" or "word"
 min                         : 0,                               // minimum number of characters/words
-max                         : 200,                             // maximum number of characters/words, -1 for unlimited, 'auto' to use maxlength attribute
+max                         : 200,                             // maximum number of characters/words, -1 for unlimited, 'auto' to use maxlength attribute, , 'autocustom' to use a custom attribute for the length (must set "autoCustomAttr")
+autoCustomAttr              : "counterlimit",                  // custom attribute name with the counter limit if the max is 'autocustom'
 countContainerElement       : "div",                           // HTML element to wrap the text count in
 countContainerClass         : "text-count-wrapper",            // class applied to the countContainerElement
 textCountMessageClass       : "text-count-message",            // class applied to the counter message
@@ -132,10 +133,12 @@ twoCharCarriageReturn       : false,                           // count carriage
 countOverflow               : false,                           // display text overflow element
 countOverflowText           : "Maximum %type exceeded by %d",  // count overflow text
 countOverflowContainerClass : "text-count-overflow-wrapper",   // class applied to the count overflow wrapper
+minDisplayCutoff            : -1,                              // maximum number of characters/words above the minimum to display a count
+maxDisplayCutoff            : -1,                              // maximum number of characters/words below the maximum to display a count
 
 // Callback API
-maxunder                    : function(el){},                  // Callback: function(element) - Fires when counter under max limit
-minunder                    : function(el){},                  // Callback: function(element) - Fires when counter under min limit
+maxunder                    : function(el){},                  // Callback: function(element) - Fires when counter is under max limit
+minunder                    : function(el){},                  // Callback: function(element) - Fires when counter is under min limit
 maxcount                    : function(el){},                  // Callback: function(element) - Fires when the counter hits the maximum word/character count
 mincount                    : function(el){},                  // Callback: function(element) - Fires when the counter hits the minimum word/character count
 init                        : function(el){}                   // Callback: function(element) - Fires after the counter is initially setup
@@ -163,4 +166,6 @@ init                        : function(el){}                   // Callback: func
 - [juliovedovatto](https://github.com/juliovedovatto) / [alvaro-canepa](https://github.com/alvaro-canepa) - multiple classes support for counter container
 - [dtipson](https://github.com/dtipson) - multiple classes error fix
 - [jmichalicek](https://github.com/jmichalicek) - count carriage returns/newlines as 2 characters
-- [diptopol](https://github.com/diptopol) - `stopInputAtMaximum` with `twoCharCarriageReturn` count fix, trimmed newline calculation fix, maximum text reached condition fix, text count overflow notification
+- [diptopol](https://github.com/diptopol) - `stopInputAtMaximum` with `twoCharCarriageReturn` count fix, trimmed newline calculation fix, maximum text reached condition fix, text count overflow notification
+- [trevorloflin](https://github.com/trevorloflin) - `minDisplayCutoff` and `maxDisplayCutoff` options
+- [t3mujin](https://github.com/t3mujin) - autocustom support (maxlength workaround), text fixes

bower.json

@@ -1,6 +1,6 @@
 {
 	"name": "jquery-text-counter",
-	"version": "0.7.0",
+	"version": "0.8.0",
 	"main": "textcounter.js",
 	"license": "MIT",
 	"ignore": [

package.json

@@ -11,10 +11,10 @@
     "minimum",
     "maximum"
   ],
-  "version": "0.7.0",
+  "version": "0.8.0",
   "author": {
     "name": "ractoon",
-    "url": "http://www.ractoon.com"
+    "url": "https://www.ractoon.com"
   },
   "licenses": [
     {

textcounter.jquery.json

@@ -9,10 +9,10 @@
 		"minimum",
 		"maximum"
 	],
-	"version": "0.7.0",
+	"version": "0.8.0",
 	"author": {
 		"name": "ractoon",
-		"url": "http://www.ractoon.com"
+		"url": "https://www.ractoon.com"
 	},
 	"licenses": [
 	{

textcounter.js

@@ -1,5 +1,5 @@
 /*!
-* jQuery Text Counter Plugin v0.7.0
+* jQuery Text Counter Plugin v0.8.0
 * https://github.com/ractoon/jQuery-Text-Counter
 *
 * Copyright 2014 ractoon
@@ -68,6 +68,16 @@
                     base.$container.text('error: [maxlength] attribute not set');
                 }
             }
+            else if (base.options.max == 'autocustom') {
+                var max = base.$el.attr(base.options.autoCustomAttr);
+            
+                if (typeof max !== 'undefined' && max !== false) {
+                    base.options.max = max;
+                }
+                else {
+                    base.$container.text('error: [' + base.options.autoCustomAttr  + '] attribute not set');
+                }
+            }
 
             // if this is a countdown counter deduct from the max characters/words
             textTotalCount = base.options.countDown ? base.options.max - textCount : textCount;
@@ -151,6 +161,17 @@
                     base.clearErrors('max');
                 }
             }
+            
+            // hide the counter if it doesn't meet either the minimum or maximum display cutoff
+            if  (base.options.minDisplayCutoff == -1 && base.options.maxDisplayCutoff == -1) {
+                base.$container.show();             
+            } else if (textCount <= base.options.min + base.options.minDisplayCutoff) { 
+                base.$container.show();
+            } else if (base.options.max !== -1 && textCount >= base.options.max - base.options.maxDisplayCutoff) {
+                base.$container.show();
+            } else {
+                base.$container.hide();
+            }
         };
 
         base.textCount = function(text) {
@@ -294,7 +315,8 @@
     $.textcounter.defaultOptions = {
         'type'                        : "character",                     // "character" or "word"
         'min'                         : 0,                               // minimum number of characters/words
-        'max'                         : 200,                             // maximum number of characters/words, -1 for unlimited, 'auto' to use maxlength attribute
+        'max'                         : 200,                             // maximum number of characters/words, -1 for unlimited, 'auto' to use maxlength attribute, 'autocustom' to use a custom attribute for the length (must set "autoCustomAttr")
+        'autoCustomAttr'              : "counterlimit",                  // custom attribute name with the counter limit if the max is 'autocustom'
         'countContainerElement'       : "div",                           // HTML element to wrap the text count in
         'countContainerClass'         : "text-count-wrapper",            // class applied to the countContainerElement
         'textCountMessageClass'       : "text-count-message",            // class applied to the counter message
@@ -315,6 +337,8 @@
         'countOverflow'               : false,                           // display text overflow element
         'countOverflowText'           : "Maximum %type exceeded by %d",  // count overflow text
         'countOverflowContainerClass' : "text-count-overflow-wrapper",   // class applied to the count overflow wrapper
+        'minDisplayCutoff'            : -1,                              // maximum number of characters/words above the minimum to display a count
+        'maxDisplayCutoff'            : -1,                              // maximum number of characters/words below the maximum to display a count
 
         // Callback API
         'maxunder'                    : function(el){},                  // Callback: function(element) - Fires when counter under max limit